Search X Ads targeting locations

Count

Number of records to return per page (1-1000)Optional · count

Country code

Two-letter ISO country code to scope results to, e.g. USOptional · country_code

Cursor

Pagination cursor from a previous responseOptional · cursor

Location type

Scope results to one location granularity (COUNTRIES, REGIONS, METROS, CITIES or POSTAL_CODES)Optional · location_type

Q

Free-text location name to search for, e.g. "united states" or "london"Optional · q

Workspace ID

Authorized workspace ID from list_accounts/list_workspacesOptional · workspace_id

Price

$0.005 per call

Billing

The provider’s price, with no markup. Billed for measured usage.

Your agent reads the schema and the price with inspect_tool before it runs the tool.

MCP call

Copy

cURL command

Copy

TypeScript

Copy

Tool ID

Copy

• Add an X Ads targeting criterionX Ads$0.05/change
• Remove X Ads targetingX Ads$0.05/change
• Search X Ads targeting interestsX Ads$0.005
• X Ads targeting criteriaX Ads$0.005
• X Ads targeting criterionX Ads$0.005
• Compare all 6