Reports

Advertiser domains with visibility and signals

Ranks the advertiser domains seen on the project's monitored searches in the window and filters. Use the ranking to prioritize domains for review, then inspect a recurring advertiser with get_advertiser_history. visibility = observations_with_ads / observations: the share of saved checks where the domain showed at least one ad. It is not impression share, spend, or proof that the advertiser bought the keyword. keywords narrows to checks of those searched keywords, like the Paid results keyword filter. Tags are signals to review. When observations is small the note says so; repeat it when reporting. Includes saved studies, which have no engine or country, unless those filters are set.

get/projects/{project_id}/advertisers

Request

  • Base URL: https://adslighthouse.com/api/v1
  • URL: https://adslighthouse.com/api/v1/projects/{project_id}/advertisers
  • 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.

Query parameters

range'7d' | '14d' | '30d' | '12m' | 'custom'

Window ending today: 7d, 14d, 30d (default) or 12m. Use custom with from and to for fixed dates.

fromstring

First local day, YYYY-MM-DD (custom range).

tostring

Last local day, YYYY-MM-DD, included in full (custom range).

time_zonestring

IANA time zone for day boundaries, such as America/New_York. Defaults to the time zone of the person the credential acts for.

'google' | 'bing'
OR
string[]
'desktop' | 'mobile'
OR
string[]
'windows' | 'macos' | 'android' | 'ios' | 'unspecified'
OR
string[]
string
OR
string[]
string
OR
string[]
string
OR
string[]
limitinteger

Items per page, 1 to 200.

cursorstring

The next_cursor value from the previous page. Omit it for the first page.

Response

Advertiser domains with visibility and signals

next_cursorstring nullable required

Pass as cursor to get the next page; null on the last page.

observationsinteger required

Saved observations in the selection: the visibility denominator.

notestring nullable required

A caution about sample size or configuration to repeat when reporting results.

request_idstring

Changes

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