JustSERPDocs
Google

Google Ads Transparency Center Advertiser Search

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.

GET
/v1/google/ads-transparency/advertiser-search

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. Answered as the document: search_metadata, search_parameters, search_information (always {}), advertisers and domains, in the Center's order. A keyword with no match is a 200 with both lists empty. region changes the counts and which advertisers qualify (Germany: Tesla Inc. 400 to 500 ads, against 5000 to 6000 anywhere). 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
q*string

The keyword.

Length1 <= length <= 200
region?string

anywhere or a country code the Center lists; the advertisers' ad counts are for that region.

Default"anywhere"
num_advertisers?integer

Advertisers to return.

Range0 <= value <= 100
Default10
num_domains?integer

Domains to return.

Range0 <= value <= 100
Default10

Response Body

The advertisers and domains, as the document. When the answer could not be parsed, the usual envelope.

application/json
  1. response

The advertiser search document.

search_metadata?
search_parameters?

The request as sent.

search_information?

Always empty here.

advertisers?array<>
domains?array<>
[key: string]?any
Example Request
curl -X GET 'https://api.justserp.com/v1/google/ads-transparency/advertiser-search?q=tesla&region=anywhere&num_advertisers=10&num_domains=10'
Example Response
{  "search_metadata": {    "id": "string",    "status": "string",    "created_at": "string",    "request_url": "string"  },  "search_parameters": {},  "search_information": {},  "advertisers": [    {      "name": "string",      "id": "string",      "region": "string",      "ads_count": {        "lower": 0,        "upper": 0      },      "is_verified": true    }  ],  "domains": [    {      "name": "string"    }  ]}

Google Ads Transparency Center GET

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.

Google Ads Transparency Center Ad Details GET

One ad from the Ads Transparency Center: its format and topic, the regions it ran in (with impressions where Google gives them, mostly the EU), the audience selection, and the variations of the ad (headline, description, link, picture, video).