Google Ads Transparency
Advertisers and creatives from Google's Ads Transparency Center — Search, YouTube, Maps, Play and Shopping, across 244 regions.
3 endpoints134 calls2/2 passing
Find advertisers
Look up advertisers and advertised domains by name.
GET
/v1/ads:google-ads/searchpassing · 0.8s5m cache
Parameters
| Name | Type | In | Description |
|---|---|---|---|
| query | string | query | Advertiser name to look up. A name returns advertisers; a full domain returns only the domain, whose ads the advertiser endpoint serves. Required. |
| region | string | query | ISO 3166-1 alpha-2 country the ads ran in. 244 supported. Default ID. |
| limit | number | query | Advertisers to return. Default 10, max 30. |
Example response
{"project":"ads:google-ads", "data": {"count":4,"query":"tokopedia","region":"ID", "domains": [ "tokopedia.com", "tokopedia.link" ], "advertisers": [ {"name":"PT. TOKOPEDIA","region":"ID","adCountMax":4000,"adCountMin":3000,"advertiserId":"AR03686725297534664705" }, {"name":"PT. TOKOPEDIA","region":"ID","adCountMax":400,"adCountMin":300,"advertiserId":"AR10309929287351795713" }, {"name":"PT GoTo Gojek Tokopedia Tbk","region":"ID","adCountMax":2000,"adCountMin":1000,"advertiserId":"AR03528791447320920065" }, {"name":"PT GOTO GOJEK TOKOPEDIA Tbk.","region":"ID","adCountMax":44,"adCountMin":44,"advertiserId":"AR00258161258572808193" } ] },"timestamp":"2026-09-02T07:34:30Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Advertiser creatives
Creatives for one advertiser or advertised domain, filterable by format and Google surface.
GET
/v1/ads:google-ads/advertiserpassing · 0.5s5m cache
Parameters
| Name | Type | In | Description |
|---|---|---|---|
| advertiserId | string | query | Advertiser ID from the search endpoint. Give this or `domain`. |
| domain | string | query | Advertised domain, with its TLD. Give this or `advertiserId`. |
| region | string | query | ISO 3166-1 alpha-2 country the ads ran in. 244 supported. Default ID. |
| format | enum | query | Creative format. Omit for all formats. One of text, image, video. |
| platform | enum | query | Google surface the ad ran on. Omit for all surfaces. One of play, maps, search, shopping, youtube. |
| page | number | query | Page number. The upstream pages by cursor, so page N costs N round trips. Default 1. |
| limit | number | query | Creatives per page. Default 40, max 40. |
Example response
{"project":"ads:google-ads", "data": { "ads": [ {"format":"video","lastShown":1788330864,"renderUrl":"https://displayads-formats.googleusercontent.com/ads/preview/content.js?client=ads-integrity-transparency&obfuscatedCustomerId=7911825792&creativeId=820991388710&uiFeatures=12,54&versionId=1&assets=%3DH4sIAAAAAAAAAOPi5uLk2LNtz79X3AKMAMa9eTENAAAA&sig=ACiVB_zULmKHJiUASNH5TL9cwzG2vyOoOA&htmlParentId=fletch-render-5007206868659922007&responseCallback=fletchCallback5007206868659922007","creativeId":"CR17156344522838376449","firstShown":1786977569,"advertiserId":"AR03686725297534664705","advertiserName":"PT. TOKOPEDIA" }, {"format":"video","lastShown":1788330075,"renderUrl":"https://displayads-formats.googleusercontent.com/ads/preview/content.js?client=ads-integrity-transparency&obfuscatedCustomerId=7911825792&creativeId=819923953134&uiFeatures=12,54&versionId=3&assets=%3DH4sIAAAAAAAAAOMS4-Lk6D63vu8Rt4ABFyfHp_cHTl_hFmABAI0AXCYYAAAA&sig=ACiVB_wqgu2sr6vwvMvO86rWGO_DP9hBfQ&htmlParentId=fletch-render-7161633935257828052&responseCallback=fletchCallback7161633935257828052","creativeId":"CR02320551940762632193","firstShown":1786261828,"advertiserId":"AR03686725297534664705","advertiserName":"PT. TOKOPEDIA" }, {"format":"video","lastShown":1788329428,"renderUrl":"https://displayads-formats.googleusercontent.com/ads/preview/content.js?client=ads-integrity-transparency&obfuscatedCustomerId=7911825792&creativeId=817130382131&uiFeatures=12,54&versionId=4&assets=%3DH4sIAAAAAAAAAOPi5uLk6J5wZ81VbgFmAC7xfR4NAAAA&sig=ACiVB_yDg-55ypnkuATDZEl7S2M8axiN5Q&htmlParentId=fletch-render-16799261192432717110&responseCallback=fletchCallback16799261192432717110","creativeId":"CR01457244547691053057","firstShown":1784210115,"advertiserId":"AR03686725297534664705","advertiserName":"PT. TOKOPEDIA" }, {"format":"video","lastShown":1788329423,"renderUrl":"https://displayads-formats.googleusercontent.com/ads/preview/content.js?client=ads-integrity-transparency&obfuscatedCustomerId=7911825792&creativeId=819961881769&uiFeatures=12,54&versionId=1&sig=ACiVB_yuXrF5iqcjxihB1PUpcGVBTODWUA&htmlParentId=fletch-render-5577263854837979399&responseCallback=fletchCallback5577263854837979399","creativeId":"CR09454658370796519425","firstShown":1786261838,"advertiserId":"AR03686725297534664705","advertiserName":"PT. TOKOPEDIA" }, {"format":"video","lastShown":1788329161,"renderUrl":"https://displayads-formats.googleusercontent.com/ads/preview/content.js?client=ads-integrity-transparency&obfuscatedCustomerId=7911825792&creativeId=821297162788&uiFeatures=12,54&adGroupId=198704116265&sig=ACiVB_w35Y9kLzUzEJ6RnTEZI_88FrLbJw&htmlParentId=fletch-render-935393603062801318&responseCallback=fletchCallback935393603062801318","creativeId":"CR00032616402552619009","firstShown":1787058151,"advertiserId":"AR03686725297534664705","advertiserName":"PT. TOKOPEDIA" }, {"format":"video","lastShown":1788325804,"renderUrl":"https://displayads-formats.googleusercontent.com/ads/preview/content.js?client=ads-integrity-transparency&obfuscatedCustomerId=7911825792&creativeId=806671310762&uiFeatures=12,54&versionId=2&assets=%3DH4sIAAAAAAAAAOMS4-LkeP78XdtdVgFmLk6Om7eaNy3iEmAEALqnGY0YAAAA&sig=ACiVB_y48-zW-5H31O4hIRe0hh4XL_6RIg&htmlParentId=fletch-render-10339262014468886279&responseCallback=fletchCallback10339262014468886279","creativeId":"CR08611485990567018497","firstShown":1777020762,"advertiserId":"AR03686725297534664705","advertiserName":"PT. TOKOPEDIA" }, {"format":"video","lastShown":1788324096,"renderUrl":"https://displayads-formats.googleusercontent.com/ads/preview/content.js?client=ads-integrity-transparency&obfuscatedCustomerId=7911825792&creativeId=821169844314&uiFeatures=12,54&adGroupId=202031879169&sig=ACiVB_x3n_NA-mSdm3XUz2t2mD5_h2RJyQ&htmlParentId=fletch-render-15629921528798111924&responseCallback=fletchCallback15629921528798111924","creativeId":"CR06724120199261323265","firstShown":1786974449,"advertiserId":"AR03686725297534664705","advertiserName":"PT. TOKOPEDIA" }, {"format":"video","lastShown":1788323527,"renderUrl":"https://displayads-formats.googleusercontent.com/ads/preview/content.js?client=ads-integrity-transparency&obfuscatedCustomerId=7911825792&creativeId=821129790450&uiFeatures=12,54&adGroupId=200852423882&assets=%3DH4sIAAAAAAAAAOPi5uLk2NJw8c5XdgFGAFboJCcNAAAA&sig=ACiVB_xeJHUqHy_Mt8ouc5dzHOZHOfuXJw&htmlParentId=fletch-render-583319850540395998&responseCallback=fletchCallback583319850540395998","creativeId":"CR03839565462564241409","firstShown":1786964720,"advertiserId":"AR03686725297534664705","advertiserName":"PT. TOKOPEDIA" } ],"page":1,"count":40,"domain":null,"format":null,"region":"ID","hasMore":true,"nextPage":2,"platform":null,"adCountMax":3000,"adCountMin":2000,"advertiserId":"AR03686725297534664705" },"timestamp":"2026-09-02T07:34:30Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Creative detail
One creative with every size variant it was served at.
GET
/v1/ads:google-ads/creative-detail/:advertiserId/:creativeIdnot measured yet5m cache
Parameters
| Name | Type | In | Description |
|---|---|---|---|
| advertiserId | string | path | Advertiser ID that owns the creative. Required. |
| creativeId | string | path | Creative ID from the advertiser endpoint. Required. |
| region | string | query | ISO 3166-1 alpha-2 country the ad ran in. 244 supported. Default ID. |
Example response
{"project":"ads:google-ads", "data": {"format":"image","region":"ID", "regions": [ {"regionCode":2360,"lastShownDate":20260901 } ], "variants": [ {"width":606,"height":831,"imageUrl":"https://tpc.googlesyndication.com/archive/simgad/15555428696574538584" }, {"width":734,"height":189,"imageUrl":"https://tpc.googlesyndication.com/archive/simgad/10538296146412477483" }, {"width":734,"height":189,"imageUrl":"https://tpc.googlesyndication.com/archive/simgad/13323617505152844694" } ],"lastShown":1788319982,"creativeId":"CR01905301583323725825","advertiserId":"AR03686725297534664705","variantCount":3,"advertiserName":"PT. TOKOPEDIA" },"timestamp":"2026-09-02T07:34:30Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Try it
Live request with your key
const data = await client.run( "ads:google-ads", "search", { query: "tokopedia", region: "ID", limit: 10 });
Google Ads Transparency
Advertisers and creatives from Google's Ads Transparency Center — Search, YouTube, Maps, Play and Shopping, across 244 regions.
3 endpoints134 calls2/2 passing
Look up advertisers and advertised domains by name.
GET
/v1/…google-ads/searchpassing · 0.8s5m cache
Try it
Parameters
query
string · query · required
Advertiser name to look up. A name returns advertisers; a full domain returns only the domain, whose ads the advertiser endpoint serves.
region
string · query · optional
ISO 3166-1 alpha-2 country the ads ran in. 244 supported. Default ID.
limit
number · query · optional
Advertisers to return. Default 10, max 30.
Example response
{"project":"ads:google-ads", "data": {"count":4,"query":"tokopedia","region":"ID", "domains": [ "tokopedia.com", "tokopedia.link" ], "advertisers": [ {"name":"PT. TOKOPEDIA","region":"ID","adCountMax":4000,"adCountMin":3000,"advertiserId":"AR03686725297534664705" }, {"name":"PT. TOKOPEDIA","region":"ID","adCountMax":400,"adCountMin":300,"advertiserId":"AR10309929287351795713" }, {"name":"PT GoTo Gojek Tokopedia Tbk","region":"ID","adCountMax":2000,"adCountMin":1000,"advertiserId":"AR03528791447320920065" }, {"name":"PT GOTO GOJEK TOKOPEDIA Tbk.","region":"ID","adCountMax":44,"adCountMin":44,"advertiserId":"AR00258161258572808193" } ] },"timestamp":"2026-09-02T07:34:30Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Code
const data = await client.run( "ads:google-ads", "search", { query: "tokopedia", region: "ID", limit: 10 });