Get Business Profile

Get the user’s business profile for contextual recommendations.

⚠️ IMPORTANT: This tool retrieves READ-ONLY data. Safe to call multiple times.

🎯 What This Tool Does (Performance Agent - Phase 1 Feature 5):

Retrieves the user’s saved business profile
Returns business vertical, size, goals, target audience
Provides context for more relevant recommendations
Shows profile source (user-set, inferred, or none)

Returns business context:

Business vertical (retail, services, technology, etc.)
Business size (small, medium, large)
Primary goal (leads, sales, awareness, traffic)
Target audience description
Geographic focus (local, regional, national, international)
Seasonality patterns
Profile confidence level

Use this tool when:

You need business context for recommendations
Before providing industry-specific advice
User asks “what type of business am I?”
You want to personalize optimization suggestions

If no profile exists:

Use infer_business_profile to automatically detect from campaign data
Or ask user to provide business details via save_business_profile

Execution time: 1-2 seconds (database lookup)

POST

/

api

/

v1

/

tools

/

get_business_profile

/

execute

Get Business Profile

curl --request POST \
  --url https://api.adspirer.ai/api/v1/tools/get_business_profile/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "arguments": {
    "customer_id": "string"
  }
}
'

{
  "data": {
    "quota": {
      "limit": 150,
      "period_end": "2026-05-01",
      "tier": "plus",
      "used": 42
    },
    "text": "(tool-specific textual output for get_business_profile)"
  },
  "success": true,
  "tool": "get_business_profile"
}

Authorizations

Authorization

string

header

required

API key from https://adspirer.ai/keys. Prefix sk_live_. Treat as a secret — never commit.

Headers

Idempotency-Key

string<uuid>

Client-generated UUID to make writes idempotent. Strongly recommended for write tools. A repeat call with the same key returns the cached result instead of re-executing. Example: 550e8400-e29b-41d4-a716-446655440000

Body

application/json

All tool arguments are wrapped in an arguments object. The fields accepted inside arguments are listed below — required fields are marked with a red asterisk.

arguments

object

required

Input schema for getting business profile

Show child attributes

Response

Tool executed successfully. data.text carries the human-readable result (markdown-friendly). data.quota shows your current usage against the plan limit. data.structured appears when the tool emits machine-parseable structured content. data.content appears for tools that return non-text blocks (images, resources).

Returned on HTTP 200. data.text is the primary human-readable output. data.quota is always present for billable calls. data.structured is set only when the tool emits machine-parseable structured content. data.content is set only when the tool emits non-text content blocks.

data

object

required

Show child attributes

success

boolean

required

tool

string

required

Echoed tool_name from the request URL.

Last modified on April 23, 2026

Get Campaign PerformanceAnalyze Google Ads campaign performance with comprehensive insights and recommendations. ⚠️ IMPORTANT: This tool retrieves READ-ONLY data. Safe to call multiple times. **Returns detailed analysis:** - Campaign structure and ad group organization - Keyword performance with quality scores and match types - Ad group performance breakdown - Performance metrics (CTR, conversions, CPC, cost, ROAS) - Optimization recommendations with actionable insights - Performance trends (last 7 days) **Parameters:** - lookback_days: 7, 30, 60, 90, or 120 days (default: 30) - start_date: Optional start date (YYYY-MM-DD). Overrides lookback_days when used with end_date. - end_date: Optional end date (YYYY-MM-DD). Overrides lookback_days when used with start_date. ⚠️ DATE CLARIFICATION: If the user's date request is vague or ambiguous (e.g., "March to June" without a year, "last quarter", "recently", "a few months ago"), ask the user to specify exact dates before calling this tool. Do not assume or guess dates. - customer_id: Optional (uses connected account if omitted) **Execution time:** 2-5 seconds (direct backend API call) **Data source:** Cached database (updated nightly via metrics collection) **Use this tool to:** - Review current campaign performance - Identify optimization opportunities - Get data-driven recommendations - Analyze keyword and ad effectiveness - Understand what's working and what needs improvement 📊 **AFTER calling this tool, provide these insights to the user:** **How to Interpret Metrics:** - **CTR (Click-Through Rate):** Industry average is 3-5% for search ads - Above 5%: Excellent ad relevance - Below 2%: Consider improving ad copy or targeting - **Conversion Rate:** Industry average is 2-5% - Low CR + High CTR = Landing page issue - Low CR + Low CTR = Ad/targeting issue - **CPA (Cost Per Acquisition):** Compare to your target CPA - Track the trend over time - Adjust bids if CPA is consistently too high 💡 **Optimization Tips:** - Wait at least 2 weeks before making major changes (learning phase) - Focus on high-performing keywords and pause low performers - Test different ad copy variations (A/B testing) - Adjust bids based on device/location performance - Review search terms report for negative keyword opportunities 💬 **Community**: For optimization discussions and tips, visit our Discord: https://discord.gg/dH3Qt4YS

Get Business Profile

curl --request POST \
  --url https://api.adspirer.ai/api/v1/tools/get_business_profile/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "arguments": {
    "customer_id": "string"
  }
}
'

{
  "data": {
    "quota": {
      "limit": 150,
      "period_end": "2026-05-01",
      "tier": "plus",
      "used": 42
    },
    "text": "(tool-specific textual output for get_business_profile)"
  },
  "success": true,
  "tool": "get_business_profile"
}