Google Ads Transparency Ad
GET
Get one Google Ads Transparency creative by URL: dates, impressions, platforms, regions, and the text read from the preview image (2 credits).
Credit cost: 2 credits per call
ApiKeyAuthheader
x-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringCreative URL from search.
Example:
https://adstransparency.google.com/advertiser/AR10904289436120383489/creative/CR10927354991047868417?region=FRregion?stringISO alpha-2. The matching region is returned first.
Example:
FRfields?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}.
Default
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
Default
falseSuccessful response
application/json- response
url?stringformat?stringregions?array<>video_id?unknownimage_url?unknownplatforms?array<unknown>last_shown?unknownvariations?array<unknown>creative_id?stringfirst_shown?unknownimage_width?unknownpreview_url?unknownimage_height?unknownadvertiser_id?stringcreative_text?unknownlast_shown_at?unknownfirst_shown_at?unknownadvertiser_name?stringimpressions_max?unknownimpressions_min?unknowncurl -X GET 'https://api.piloterr.com/v2/googleadstransparency/ad?query=string'Example Response
{ "url": "https://adstransparency.google.com/advertiser/AR10904289436120383489/creative/CR10927354991047868417?region=FR", "format": "text", "regions": [ { "region": "FR", "platforms": [], "last_shown": null, "first_shown": null, "region_code": 2250, "impressions_max": null, "impressions_min": null } ], "video_id": null, "image_url": null, "platforms": [], "last_shown": null, "variations": [], "creative_id": "CR10927354991047868417", "first_shown": null, "image_width": null, "preview_url": null, "image_height": null, "advertiser_id": "AR10904289436120383489", "creative_text": null, "last_shown_at": null, "first_shown_at": null, "advertiser_name": "WebAPI Group", "impressions_max": null, "impressions_min": null}