JustSERPDocs
Google

Google Ads Transparency Center

The ads Google has shown for an advertiser or a domain, from the Ads Transparency Center (adstransparency.google.com): the ads with their dates, format and ids, and a token for the next page.

GET
/v1/google/ads-transparency

The ads Google has shown for an advertiser or a domain, from the Ads Transparency Center (adstransparency.google.com): the ads with their dates, format and ids, and a token for the next page. Answered as the document: search_metadata (request_url is the Center's page for the request), search_parameters (with the defaults used), search_information (total_results is the lower end of the range the Center gives, not a count), ad_creatives and pagination.next_page_token. An advertiser the Center does not know is a 200 with ad_creatives: [] and total_results: 0. No snapshot.

Authorization

headerX-API-Key<token>

Your API key.

Query Parameters

cancel_token?string

A name you make up for this request (a UUID is fine), so you can later GET /v1/cancel with it. Only you know it, so only you can cancel. Use a new one for every request, retries included: a cancelled token stays cancelled for a few minutes.

Length1 <= length <= 128
advertiser_id?string

An advertiser's id (AR and 20 digits); up to 20, separated by commas. Get one from /v1/google/ads-transparency/advertiser-search.

domain?string

The advertiser's verified domain, e.g. tesla.com (lower-cased).

region?string

anywhere or a country code the Center lists (243: US, GB, DE...).

Default"anywhere"
platform?string

Only ads shown on this platform.

Value in"google_play""google_maps""google_search""youtube""google_shopping"
ad_format?string

Only ads of this format.

Value in"text""image""video"
time_period?string

today, yesterday (also spelled yesteday), last_7_days, last_30_days, or YYYY-MM-DD..YYYY-MM-DD (both days inclusive, UTC days, not ending before it starts). Filters by the days an ad was shown.

next_page_token?string

The pagination.next_page_token of an answer.

num?integer

Ads per page.

Range1 <= value <= 100
Default40

Response Body

The ads, as the document. When the answer could not be parsed, the usual envelope.

application/json
  1. response

The Ads Transparency Center document.

search_metadata?
search_parameters?

The request as sent, with the defaults that were used (region, num).

search_information?
ad_creatives?array<>
pagination?
[key: string]?any
Example Request
curl -X GET 'https://api.justserp.com/v1/google/ads-transparency?domain=tesla.com&region=US&platform=youtube&num=40'
Example Response
{  "search_metadata": {    "id": "string",    "status": "string",    "created_at": "string",    "request_url": "string"  },  "search_parameters": {},  "search_information": {    "total_results": 0  },  "ad_creatives": [    {      "position": 0,      "id": "string",      "target_domain": "string",      "advertiser": {        "id": "string",        "name": "string"      },      "first_shown_datetime": "string",      "last_shown_datetime": "string",      "total_days_shown": 0,      "format": "text",      "details_link": "string",      "details_script_link": "string",      "image": "string",      "image_width": 0,      "image_height": 0    }  ],  "pagination": {    "next_page_token": "string"  }}

Google Trends Trending Now News GET

The news articles of one Trending Now trend, by the `news_token` of a trend from `/v1/google/trends/trending-now`.

Google Ads Transparency Center Advertiser Search GET

Advertisers and domains that match a keyword in the Ads Transparency Center: each advertiser with its id, country and the range of its ads, and the domains apart.