Advertiser identity

Read Google's Ads Transparency record for an advertiser domain (1 on-demand check)

Queues a lookup of the Google Ads Transparency Center record for an advertiser domain that the project's saved ads used (other domains are refused). A new lookup uses 1 on-demand check from the account's allowance, reserved before anything runs; quota_exceeded means none are left and nothing was queued. A result younger than 30 days is returned without a new lookup unless refresh is true; a lookup already running is joined; repeating the idempotency key returns the same lookup. Each of those returns outcome cached, pending or replayed and uses nothing. The lookup usually finishes within a few minutes: poll get_advertiser_identity. If it could not start, the check is given back. Requires the write scope and an idempotency key. Confirm with the user before calling, because it uses their allowance.

post/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.

Headers

Idempotency-Keystring required

A unique value you choose for this request, such as a UUID. Repeating the same key returns the first result instead of starting paid work again.

Request body

Response

Read Google's Ads Transparency record for an advertiser domain (1 on-demand check)

outcome'created' | 'pending' | 'cached' | 'replayed' required

created: a new lookup was queued and 1 on-demand check used. pending: one was already running. cached: a recent result is returned. replayed: this idempotency key was used before. Only created uses a check.

lookup_idstring required
request_idstring

Changes

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