Google Ads Transparency API · Endpoint
Google Ads Transparency Creative Detail API
Returns one Google creative's public detail for an advertiser and creative id pair: every ad variation and the regions and dates Google reports.
- 1 credit per call
- Failed calls are free
- Updated
- google-adstransparency.creative.get
{ "creative": { "1": "AR12815412684405080065", "2": "CR10007278137596968961", "8": 1, "4": { "1": "1792150956", "2": 999786000 }, "17": [ { "1": 2840, "5": 20261016 } ], "5": [ { "5": true, "3": { "2": "<img src=\"https://tpc.googlesyndication.com/archive/simgad/1042557611142725945\" height=\"376\" width=\"348\">" } }, { "5": true, "3": { "2": "<img src=\"https://tpc.googlesyndication.com/archive/simgad/15929607272574382757\" height=\"180\" width=\"348\">" } } ] }}
| # | 5 |
|---|---|
| 1 | true |
| 2 | true |
| 3 | true |
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 | Google advertiser id that owns the creative (e.g. "AR12815412684405080065"). Use field 1 of a creative from creative.search or advertiser-ads.list. | AR12815412684405080065 |
| creative_id | string | yes | Google creative id (e.g. "CR10007278137596968961"). Use field 2 of the same creative. A creative id with another advertiser's id answers not_found. | CR10007278137596968961 |
Fields it returns
What each record in the response holds, with the values from the sample above.
| Field | Type | Example |
|---|---|---|
| creative.5[].3 | object | 1 fields |
| creative.5[].5 | boolean | true |
| creative | object | 6 fields |
| creative.1 | string | AR12815412684405080065 |
| creative.17 | array | 1 records |
| creative.17[].1 | integer | 2840 |
| creative.17[].5 | integer | 20,261,016 |
| creative.2 | string | CR10007278137596968961 |
| creative.4 | object | 2 fields |
| creative.4.1 | string | 1792150956 |
| creative.4.2 | integer | 999,786,000 |
| creative.5 | array | 3 records |
| creative.8 | integer | 1 |
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.get", "input": { "advertiser_id": "AR12815412684405080065", "creative_id": "CR10007278137596968961" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "google-adstransparency.creative.get", "input": { "advertiser_id": "AR12815412684405080065", "creative_id": "CR10007278137596968961" }}''')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.get", "input": { "advertiser_id": "AR12815412684405080065", "creative_id": "CR10007278137596968961" }}),});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, get the Google Ads Transparency creative detail for advertiser id "AR12815412684405080065" and creative id "CR10007278137596968961". Tell me what it costs before you run it, then show the results as a table.
More from the Google Ads Transparency API
Google Ads Transparency Creative Detail API FAQ
The short answers. The docs have the long ones.
How much does the Google Ads Transparency Creative Detail 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 and creative_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.creative.get, 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.