Advertiser identity

Who Google's Ads Transparency Center says advertises to a domain

Returns the Google Ads Transparency Center identity on record for an advertiser domain of the project: each advertiser account Google lists for ads pointing to the domain, with the name (the verified name when verified is true), country, Transparency ID, how many of the sampled ads it ran and their first and last shown dates, plus a link to Google's page. Several advertisers can share a domain (the brand, agencies, resellers, affiliates). state tells found, not_found (Google listed none), failed (the record could not be read; not the same as not_found), pending or none (never looked up). Free to call: it reads what is on record and never starts a lookup; use request_advertiser_identity_lookup for that. Google's record links advertiser accounts to ads that pointed to the domain; it does not prove who placed a specific ad seen in a check.

get/projects/{project_id}/advertisers/{domain}/identity

Request

  • Base URL: https://adslighthouse.com/api/v1
  • URL: https://adslighthouse.com/api/v1/projects/{project_id}/advertisers/{domain}/identity
  • Auth: HTTP bearer

Path parameters

project_idstring required

The project: its id, its brand domain (for example nike.example) or its exact project or brand name. Unknown or ambiguous references return not_found; call list_projects then.

domainstring required

Advertiser domain as it appears in list_advertisers, such as summit-outdoors.com.

Response

Who Google's Ads Transparency Center says advertises to a domain

domainstring required
state'none' | 'pending' | 'found' | 'not_found' | 'failed' required

The headline state: pending while a lookup runs; otherwise the latest attempt: found, not_found (Google listed no advertiser), failed (the record could not be read; never the same as not_found) or none (never looked up).

transparency_search_urlstring required

Google Ads Transparency Center search for this domain, to check the record yourself.

request_idstring

Changes

No recorded changes to this operation across all 1 revision of this API.