Piloterr

Google Ads Transparency Ad

GET
/v2/googleadstransparency/ad

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

Autorización

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Parámetros de consulta

query*string

Creative URL from search.

Example:

https://adstransparency.google.com/advertiser/AR10904289436120383489/creative/CR10927354991047868417?region=FR
region?string

ISO alpha-2. The matching region is returned first.

Example:

FR

Cuerpo de la respuesta

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/googleadstransparency/ad?query=string"
{  "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}
{  "error": "Bad Request"}
{  "error": "Invalid API Key"}
{  "error": "Payment required"}
{  "error": "Rate limit exceeded for the API key: quota monthly"}
{  "error": "Internal Error"}