Google Ads Transparency Search
Search the Google Ads Transparency Center by domain, advertiser, region, format, platform, and date. Returns creative cards and pagination (2 credits).
Credit cost: 2 credits per call
ApiKeyAuthx-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringDomain name, advertiser name, advertiser id, or a full Ads Transparency URL.
Example 1 (domain):
webapi.groupExample 2 (advertiser URL):
https://adstransparency.google.com/advertiser/AR10904289436120383489?region=FRExample 3 (advertiser id):
AR10904289436120383489Example 4 (advertiser name):
WebAPI Groupregion?stringCountry. ISO alpha-2 (FR), anywhere, or a Transparency region code (2250 for France, 250 is also accepted).
Omitted means no region filter.
domain?stringDomain filter. Used when query is not already a domain.
Example:
webapi.groupadvertiser_id?stringAdvertiser id, AR followed by digits.
Example:
AR10904289436120383489format?stringCreative format.
textimagevideo
platform?stringComma-separated surfaces.
playmapssearchshoppingyoutube
Example:
search,youtubepreset_date?stringRelative window.
todayyesterdaylast_7_dayslast_30_days
French URL labels such as 7 derniers jours, Aujourd'hui, and Hier are accepted.
start_date?stringInclusive start date, YYYY-MM-DD or YYYYMMDD.
Example:
2026-09-10end_date?stringInclusive end date, YYYY-MM-DD or YYYYMMDD. A single day uses the same value as start_date.
topic?stringAd topic. Default: commercial.
commercialpoliticalshoppingtravel_hotellocal_services
"commercial"page?numberPage number, from 1 to 20. Default: 1.
"1"per_page?numberPage size, from 1 to 100. Default: 40.
"40"cursor?stringOpaque cursor copied from pagination.next.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
falseSuccessful response
application/json- response
results?array<>pagination?curl -X GET 'https://api.piloterr.com/v2/googleadstransparency/search?query=string'{ "results": [ { "url": "https://adstransparency.google.com/advertiser/AR10904289436120383489/creative/CR10927354991047868417?region=FR", "domain": "webapi.group", "format": "text", "image_url": null, "creative_id": "CR10927354991047868417", "image_width": null, "preview_url": null, "image_height": null, "advertiser_id": "AR10904289436120383489", "last_shown_at": null, "first_shown_at": null, "advertiser_name": "WebAPI Group" } ], "pagination": { "next": null, "page": 1, "per_page": 40, "total_pages": null, "total_results": null, "total_results_max": null, "total_results_min": null }}