Google Ads Transparency Creatives Search API
Search by brand, advertiser name or domain and get that advertiser's ads, filtered by country, format and Search or YouTube.
- 1 credit per call
- Failed calls are free
- Updated
- google-adstransparency.creative.search
{ "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 | Advertiser ID | Format | 13 |
|---|---|---|---|---|---|
| 1 | Amazon | CR07630612285903339521 | AR12815412684405080065 | 2 | 42 |
| 2 | Amazon | CR16881709607964114945 | AR12815412684405080065 | 2 | 42 |
| 3 | Amazon | CR09727671231141904385 | AR12815412684405080065 | 2 | 42 |
| 4 | Amazon | CR00083634841593053185 | AR12815412684405080065 | 2 | 42 |
| 5 | Amazon | CR08198910263882153985 | AR12815412684405080065 | 2 | 42 |
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 brand, advertiser name or domain, such as amazon or nike.com. | amazon |
| 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[].1 | string | Google's ID for the advertiser. | AR12815412684405080065 |
| items[].4 | integer | The ad's format: 1 text, 2 image, 3 video. | 2 |
| 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.creative.search", "input": { "limit": 5, "query": "amazon" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "google-adstransparency.creative.search", "input": { "limit": 5, "query": "amazon" }}''')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.creative.search", "input": { "limit": 5, "query": "amazon" }}),});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
Using Upscrape, find the ads Amazon runs on Google in the Ads Transparency Center and list the first five with their ad IDs and formats.
More from the Google Ads Transparency API
Google Ads Transparency Creatives Search API FAQ
The short answers. The docs have the long ones.
How much does the Google Ads Transparency Creatives 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.creative.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.