/v1/call/google.advertiser_searchPreviewGoogle advertiser search API
Only on Google Ads Transparency.
The Google advertiser search API finds advertisers in the Google Ads Transparency Center by name: ID, name, the country or region they are registered in, and the center's estimate of how many ads they have. The ID is what the advertiser's ads are asked for by. One call costs 2 credits ($0.004 to $0.0067 depending on the pack); failed calls are free. Call it over HTTP or from your AI client over MCP. Last tested 2026-10-17.
Last updated:
Request and response
curl https://api.socialtoai.com/v1/call/google.advertiser_search \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "nike" }'import osimport requestsresponse = requests.post( "https://api.socialtoai.com/v1/call/google.advertiser_search", headers={"Authorization": f"Bearer {os.environ['SOCIALTOAI_KEY']}"}, json={ "query": "nike", },)print(response.json())# Connected over MCP? Ask in plain words.Use the Google advertiser search interface (google.advertiser_search) with query: nike.# Your AI calls the call tool with:{ "query": "nike"}{ "op": "google.advertiser_search", "platform": "google", "status": "ok", "items": [ { "platform": "google", "id": "…", "ref": "…", "approx": [], "type": "entry", "entry_type": "advertiser", "title": "…", "url": null, "rank": null, "heat": null, "fields": { "region": "…" } } ], "unavailable": [], "page": { "has_more": false }, "cost_credits": 2}- entry_type
- advertiser
- region
- …
Names and text were removed from the sample; the numbers are as recorded.
2 parameters.
1 required.
Send them as a JSON body with POST. Your key goes in the Authorization header, never in the URL.
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| query | string | Required | — | Name of the advertiser or brand |
| region | string | Optional | — | The country or region to search in, by its two-letter code; the United States when left out |
The fields of each item.
What Google Ads Transparency cannot give is marked.
| Field | Type | Meaning |
|---|---|---|
| items[].title | string | The entry's title or name. |
| items[].url | string | A link that opens it; null where the platform's list has none. |
| items[].rank | integer | Position on a board, from 1. |
| items[].heat | integer | The platform's heat score. |
| items[].fields.region | string | The code of the country or region the advertiser is registered in. |
nullFields Google Ads Transparency cannot giveGoogle Ads Transparency gives every field of this call. Where one item lacks a value, that field is null.
Every item also has platform, id, ref, approx and type; the response around the items is the same on every call. Response format
What to expect.
1 call per second per key, 5 after a purchase; going over is not charged. Rate limits
A failed call costs 0 credits and is never retried on its own. Error codes
Once connected over MCP, these questions use it.
Find advertisers in the Google Ads Transparency Center by name: nike.
2 creditscall {"op":"google.advertiser_search","query":"nike"}
The interface of the same name on other platforms.
All platforms and prices/v1/call/google.advertiser_search{ "query": "nike" }2 creditsper call