zapi.
APIsPricingDocsMCP
APIsPricingDocsMCPSign in
zapi.
APIsPricingDocsMCP
APIsPricingDocsMCPSign in
On this page
  • Playground
  • Code examples
  • Full reference
  • Related APIs
Ads/Google Ads Transparency
Logo Google Ads Transparency

Google Ads Transparency

Advertisers and creatives from Google's Ads Transparency Center — Search, YouTube, Maps, Play and Shopping, across 244 regions.

Endpoints
3
Requests
130
Updated
7 hours ago
For LLMs
llms.txt
Endpoint healthnot yet measured
  • searchnot measured
  • advertisernot measured
  • creative-detailnot measured
no measurements yetdaily 01:00 WIB

Playground

3 endpoints
GET/v1/ads:google-ads/search5m cache3 paramschecking key…
Parameters
querystringrequired

Advertiser name to look up. A name returns advertisers; a full domain returns only the domain, whose ads the advertiser endpoint serves

regionstring

ISO 3166-1 alpha-2 country the ads ran in. 244 supported. Default ID

limitnumber

Advertisers to return. Default 10, max 30

·
Response
EXAMPLE
{
  "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"
    }
  ]
}

Code examples

Find advertisers
zpi-sdkrecommended
// npm i zpi-sdk
import { ZpiClient } from "zpi-sdk";

const client = new ZpiClient({ apiKey: "zpi_xxxxxxxxxxxxxxxxxxxxxxxx" });

const data = await client.run("ads:google-ads", "search", {
  "query": "tokopedia",
  "region": "ID",
  "limit": 10
});
console.log(data);
Full SDK reference →
request.sh
curl -X GET "https://api.zpi.web.id/v1/ads:google-ads/search?query=tokopedia&region=ID&limit=10" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Full reference

3 endpoints · plain text
GETFind advertisers/v1/ads:google-ads/searchLook up advertisers and advertised domains by name.

Parameters

querystringrequired
Advertiser name to look up. A name returns advertisers; a full domain returns only the domain, whose ads the advertiser endpoint serves
regionstringoptional
ISO 3166-1 alpha-2 country the ads ran in. 244 supported. Default ID
limitnumberoptional
Advertisers to return. Default 10, max 30

Request

curl -X GET "https://api.zpi.web.id/v1/ads:google-ads/search?query=tokopedia&region=ID&limit=10" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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"
    }
  ]
}
GETAdvertiser creatives/v1/ads:google-ads/advertiserCreatives for one advertiser or advertised domain, filterable by format and Google surface.

Parameters

advertiserIdstringoptional
Advertiser ID from the search endpoint. Give this or domain
domainstringoptional
Advertised domain, with its TLD. Give this or advertiserId
regionstringoptional
ISO 3166-1 alpha-2 country the ads ran in. 244 supported. Default ID
formatenumoptional
Creative format. Omit for all formats Values: text, image, video.
platformenumoptional
Google surface the ad ran on. Omit for all surfaces Values: play, maps, search, shopping, youtube.
pagenumberoptional
Page number. The upstream pages by cursor, so page N costs N round trips. Default 1
limitnumberoptional
Creatives per page. Default 40, max 40

Request

curl -X GET "https://api.zpi.web.id/v1/ads:google-ads/advertiser?advertiserId=AR03686725297534664705&domain=tokopedia.com&region=ID&format=video&platform=youtube&page=1&limit=40" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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"
}
GETCreative detail/v1/ads:google-ads/creative-detail/:advertiserId/:creativeIdOne creative with every size variant it was served at.

Parameters

advertiserIdstringrequiredin path
Advertiser ID that owns the creative
creativeIdstringrequiredin path
Creative ID from the advertiser endpoint
regionstringoptional
ISO 3166-1 alpha-2 country the ad ran in. 244 supported. Default ID

Request

curl -X GET "https://api.zpi.web.id/v1/ads:google-ads/creative-detail/AR03686725297534664705/CR01905301583323725825?region=ID" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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"
}

Related APIs

More in ads

Meta Ad Library

ads/meta

Competitor ads running on Facebook, Instagram, Messenger and Threads — creative, copy, carousel cards and direct media, from Meta's public Ad Library.

85 calls·10m cache
Browse APIsPricingDocsMCP serverGet an API key
zapi.One key, one response shape.
TermsPrivacyCookiesAUPRefunds© 2026