# Google Ads Transparency โ€” Zapi reference > Advertisers and creatives from Google's Ads Transparency Center โ€” Search, YouTube, Maps, Play and Shopping, across 244 regions. **Base URL:** `https://api.zpi.web.id` **Auth:** Send `x-api-key: YOUR_KEY` header on every request. Get a free key at https://zpi.web.id/dashboard/keys. **Response envelope:** `{ content, message, errors }` **Rate limit:** 60 req/min on free tier. **Related:** - Detail page: https://zpi.web.id/api/ads/google-ads - Endpoint catalog: https://zpi.web.id/category/ads - Concise index: https://zpi.web.id/llms.txt - Full reference: https://zpi.web.id/llms-full.txt --- ## Google Ads Transparency **Category:** ads ยท **Slug:** `google-ads` **Detail page:** https://zpi.web.id/api/ads/google-ads Advertisers and creatives from Google's Ads Transparency Center โ€” Search, YouTube, Maps, Play and Shopping, across 244 regions. **Tags:** ads, google, youtube, advertising, creative, competitor, transparency ### Find advertisers Look up advertisers and advertised domains by name. - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/ads:google-ads/search` - **Cache TTL:** 300s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `query` | string | query | yes | 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 | no | ISO 3166-1 alpha-2 country the ads ran in. 244 supported. Default ID | | `limit` | number | query | no | Advertisers to return. Default 10, max 30 | **cURL:** ```bash curl "https://api.zpi.web.id/v1/ads:google-ads/search?query=tokopedia®ion=ID&limit=10" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/ads:google-ads/search?query=tokopedia®ion=ID&limit=10", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zpi.web.id/v1/ads:google-ads/search?query=tokopedia®ion=ID&limit=10", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "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" } ] } ``` --- ### Advertiser creatives Creatives for one advertiser or advertised domain, filterable by format and Google surface. - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/ads:google-ads/advertiser` - **Cache TTL:** 300s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `advertiserId` | string | query | no | Advertiser ID from the search endpoint. Give this or `domain` | | `domain` | string | query | no | Advertised domain, with its TLD. Give this or `advertiserId` | | `region` | string | query | no | ISO 3166-1 alpha-2 country the ads ran in. 244 supported. Default ID | | `format` | enum(text|image|video) | query | no | Creative format. Omit for all formats | | `platform` | enum(play|maps|search|shopping|youtube) | query | no | Google surface the ad ran on. Omit for all surfaces | | `page` | number | query | no | Page number. The upstream pages by cursor, so page N costs N round trips. Default 1 | | `limit` | number | query | no | Creatives per page. Default 40, max 40 | **cURL:** ```bash curl "https://api.zpi.web.id/v1/ads:google-ads/advertiser?advertiserId=AR03686725297534664705&domain=tokopedia.com®ion=ID&format=video&platform=youtube&page=1&limit=40" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/ads:google-ads/advertiser?advertiserId=AR03686725297534664705&domain=tokopedia.com®ion=ID&format=video&platform=youtube&page=1&limit=40", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zpi.web.id/v1/ads:google-ads/advertiser?advertiserId=AR03686725297534664705&domain=tokopedia.com®ion=ID&format=video&platform=youtube&page=1&limit=40", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "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" } ``` --- ### Creative detail One creative with every size variant it was served at. - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/ads:google-ads/creative-detail/:advertiserId/:creativeId` - **Cache TTL:** 300s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `advertiserId` | string | path | yes | Advertiser ID that owns the creative | | `creativeId` | string | path | yes | Creative ID from the advertiser endpoint | | `region` | string | query | no | ISO 3166-1 alpha-2 country the ad ran in. 244 supported. Default ID | **cURL:** ```bash curl "https://api.zpi.web.id/v1/ads:google-ads/creative-detail/:advertiserId/:creativeId?region=ID" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/ads:google-ads/creative-detail/:advertiserId/:creativeId?region=ID", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zpi.web.id/v1/ads:google-ads/creative-detail/:advertiserId/:creativeId?region=ID", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "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" } ``` --- _Generated: 2026-09-02T14:19:54.488Z_