Get Campaign Targeting
Get location/geo targeting for a Google Ads campaign.
This tool retrieves READ-ONLY data. Safe to call multiple times.
Returns location targeting details:
- Targeted locations (cities, states, countries, metros the campaign targets)
- Excluded locations (negative geo targets)
- Bid modifiers per location (if set)
- Location type (Country, State, City, Metro, etc.)
- Summary counts (targeted, excluded, total)
Parameters:
- campaign_id: The campaign ID (REQUIRED - get from list_campaigns)
- customer_id: Optional (uses connected account if omitted)
Execution time: 1-3 seconds (single API query)
Use this tool when:
- User asks “where is this campaign targeting?” or “what locations?”
- User wants to see geo targeting for a campaign
- User asks “what countries/cities/states does my campaign target?”
- Before recommending location targeting changes
- To verify location setup after campaign creation
Returns for each location:
- name: Short location name (e.g., “New York”)
- canonical_name: Full hierarchical name (e.g., “New York,New York,United States”)
- country_code: ISO country code (e.g., “US”)
- target_type: Location type (Country, State, City, County, Metro, etc.)
- is_negative: true if this location is EXCLUDED
- bid_modifier: Bid adjustment for this location (null if no modifier)
Example flow:
- User: “What locations does my Diamond Ring campaign target?”
- Agent: Uses get_campaign_targeting with campaign_id
- Returns: Targeted: United States, New York, Los Angeles; Excluded: none
Authorizations
API key from https://adspirer.ai/keys. Prefix sk_live_. Treat as a secret — never commit.
Headers
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
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.
Input schema for getting campaign location targeting
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.

