Google Ads Transparency API · Endpoint
Google Ads Transparency Advertisers Search API
Find an advertiser's Google advertiser ID from its name or domain, with its region, verification status and how many ads it runs.
- 1 credit per call
- Failed calls are free
- Updated
- google-adstransparency.advertiser.search
{ "total_items": 20, "items": [ { "name": "Nike", "ad_count_max": 1, "ad_count_min": 1, "advertiser_id": "AR06641858037806006273", "region": "KE", "verified": true }, { "name": "nikey", "ad_count_max": 9, "ad_count_min": 9, "advertiser_id": "AR13536189912721653761", "region": "BG" } ]}
| # | Advertiser | Advertiser ID | Region | Verified | Ads (min) | Ads (max) |
|---|---|---|---|---|---|---|
| 1 | Nike | AR06641858037806006273 | KE | true | 1 | 1 |
| 2 | nikey | AR13536189912721653761 | BG | 9 | 9 | |
| 3 | Nikena | AR00337221161131704321 | BG | 27 | 27 | |
| 4 | Nikesh | AR16743829861998526465 | IN | 3 | 3 | |
| 5 | NIKE SRL | AR17365672681860497409 | IT | 8 | 8 | |
| 6 | Nike Srl | AR03550664066492006401 | IT | 1 | 1 | |
| 7 | Jan Nikel | AR12473664696462868481 | CZ | 10 | 10 | |
| 8 | Nike, Inc. | AR16735076323512287233 | US | 9000 | 10,000 | |
| 9 | nikethan g | AR03405126230628892673 | IN | 19 | 19 | |
| 10 | Nike Klara | AR17567291692413878273 | US | 11 | 11 |
What you send
The input
object of the request, with every field the endpoint accepts.
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
| query | string | yes | The advertiser's name or domain, such as nike. | nike |
| limit | integer | no | How many advertisers to return. |
Fields it returns
What each record in the response holds, with the values from the sample above.
| Field | Type | What it is | Example |
|---|---|---|---|
| items[].name | string | The advertiser's name. | Nike |
| items[].advertiser_id | string | Google's ID for the advertiser, used by the creatives endpoint. | AR06641858037806006273 |
| items[].region | string | The country of the advertiser's verification. | KE |
| items[].verified | boolean | Whether Google has verified the advertiser. | true |
| items[].ad_count_min | integer | The low end of Google's ad count range. | 1 |
| items[].ad_count_max | integer | The high end of Google's ad count range. | 1 |
| items | array | The results. | 20 records |
| total_items | integer | How many results this response holds. | 20 |
Call it from your code, or ask your agent
Set UPSCRAPE_API_KEY to your key and copy a working request.
curl --request POST \ --url https://data.upscrape.com/execute \ --header "Authorization: Bearer $UPSCRAPE_API_KEY" \ --header "Content-Type: application/json" \ --header "Prefer: wait=30" \ --data '{ "capability": "google-adstransparency.advertiser.search", "input": { "query": "nike" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "google-adstransparency.advertiser.search", "input": { "query": "nike" }}''')response = requests.post( "https://data.upscrape.com/execute", headers={ "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}", "Content-Type": "application/json", "Prefer": "wait=30", }, json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))
const response = await fetch("https://data.upscrape.com/execute", { method: "POST", headers: { "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`, "Content-Type": "application/json", "Prefer": "wait=30", }, body: JSON.stringify({ "capability": "google-adstransparency.advertiser.search", "input": { "query": "nike" }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
https://data.upscrape.com/mcp
With Upscrape, look up every Google advertiser account named Nike, with its region, whether it is verified and how many ads it runs.
More from the Google Ads Transparency API
The same data from other platforms
TikTok Ad LibraryAdvertisers searchGoogle Ads Transparency Advertisers Search API FAQ
The short answers. The docs have the long ones.
How much does the Google Ads Transparency Advertisers Search API cost?
1 credit per successful call, shown before it runs. You buy credits once, and paid credits never expire.
What do I send?
Send query. The input fields below list every option with its type and limits.
Do I need a Google Ads Transparency login?
No. It reads public Google Ads Transparency data; nothing runs on your account.
Can my AI agent call it?
Yes, over MCP: the agent finds google-adstransparency.advertiser.search, checks its price and runs it with the same credits as the REST API.
Your first Google Ads Transparency call is free.
Up to 100 free credits to start, no card needed.