Google Ads Transparency Advertiser Creatives API
List every ad of one advertiser by its advertiser ID, page by page, with the same filters.
- 1 credit per call
- Failed calls are free
- Updated
- google-adstransparency.advertiser-ads.list
{ "total_items": 5, "items": [ { "1": "AR12815412684405080065", "12": "Amazon", "13": 42, "2": "CR07630612285903339521", "4": 2, "3": { "3": { "2": "<img src=\"https://tpc.googlesyndication.com/archive/simgad/10876653414320579573\" height=\"100\" width=\"320\">" } }, "6": { "1": "1787719647", "2": 733817000 }, "7": { "1": "1791218116", "2": 651585000 } }, { "1": "AR12815412684405080065", "12": "Amazon", "13": 42, "2": "CR16881709607964114945", "4": 2, "3": { "3": { "2": "<img src=\"https://tpc.googlesyndication.com/archive/simgad/8012570873104701430\" height=\"50\" width=\"320\">" } }, "6": { "1": "1787725706", "2": 740476000 }, "7": { "1": "1791213203", "2": 962574000 } } ]}
| # | Advertiser | Ad ID | Format | 1 | 13 |
|---|---|---|---|---|---|
| 1 | Amazon | CR07630612285903339521 | 2 | AR12815412684405080065 | 42 |
| 2 | Amazon | CR16881709607964114945 | 2 | AR12815412684405080065 | 42 |
| 3 | Amazon | CR09727671231141904385 | 2 | AR12815412684405080065 | 42 |
| 4 | Amazon | CR00083634841593053185 | 2 | AR12815412684405080065 | 42 |
| 5 | Amazon | CR08198910263882153985 | 2 | AR12815412684405080065 | 42 |
What you send
The input
object of the request, with every field the endpoint accepts.
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
| advertiser_id | string | yes | The Google advertiser ID, such as AR12815412684405080065, from the advertiser search. | AR12815412684405080065 |
| creative_format | string | no | Only one ad format: TEXT, IMAGE or VIDEO. Leave it out for all formats. | TEXT · IMAGE · VIDEO |
| cursor | string | no | Pass next_cursor from the last response, with the same filters, to get the next page. | |
| delivery_country | string | no | Only ads Google reports were shown in this country: US or DE. Leave it out for worldwide. | US · DE |
| delivery_platform | string | no | Only ads shown on Google Search (SEARCH) or YouTube (YOUTUBE). This filter covers ads shown since September 2023. | SEARCH · YOUTUBE |
| limit | integer | no | How many ads to return in this call. | 5 |
Fields it returns
What each record in the response holds, with the values from the sample above.
| Field | Type | What it is | Example |
|---|---|---|---|
| items[].12 | string | The advertiser's name. | Amazon |
| items[].2 | string | Google's ID for the ad. | CR07630612285903339521 |
| items[].4 | integer | The ad's format: 1 text, 2 image, 3 video. | 2 |
| items[].1 | string | Google's ID for the advertiser. | AR12815412684405080065 |
| items[].13 | integer | How many regions the ad was shown in. | 42 |
| items[].3 | object | What Google shows to preview the ad. | 1 fields |
| items[].3.3 | object | The ad's preview image, as page markup. | 1 fields |
| items[].6 | object | When the ad was first shown. | 2 fields |
| items[].6.1 | string | When the ad was first shown, as a Unix time in seconds. | 1787719647 |
| items[].6.2 | integer | The fraction of that second, in nanoseconds. | 733,817,000 |
| items[].7 | object | When the ad was last shown. | 2 fields |
| items[].7.1 | string | When the ad was last shown, as a Unix time in seconds. | 1791218116 |
| items[].7.2 | integer | The fraction of that second, in nanoseconds. | 651,585,000 |
| items | array | The results. | 5 records |
| total_items | integer | How many results this response holds. | 5 |
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-ads.list", "input": { "advertiser_id": "AR12815412684405080065", "limit": 5 }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "google-adstransparency.advertiser-ads.list", "input": { "advertiser_id": "AR12815412684405080065", "limit": 5 }}''')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-ads.list", "input": { "advertiser_id": "AR12815412684405080065", "limit": 5 }}),});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
Use Upscrape to list the Google ads of advertiser AR12815412684405080065, five at a time.
More from the Google Ads Transparency API
The same data from other platforms
Google Ads Transparency Advertiser Creatives API FAQ
The short answers. The docs have the long ones.
How much does the Google Ads Transparency Advertiser Creatives 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 advertiser_id. 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-ads.list, 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.