Reports

One advertiser's metrics, category and saved ads

Returns one advertiser domain on the project's monitored searches: its Paid results row (visibility = observations where it showed at least one ad / observations, ad occurrences, keywords, markets, signals), the category and name your team saved for it, its automated policy review counts, and its saved ads newest first, 25 per page, each with the results-page screenshot of its first appearance when one was stored. observed_in_selection is false when the domain showed no ad in this window and filters; that is not proof it stopped advertising. Use get_advertiser_history to check how often the project measured the advertiser and where its presence changed. Metrics describe this saved sample and do not establish market share, spend, or whether a competitor stopped advertising. Includes imported studies unless engine or country filters are set. When a saved landing-page preview is available, each ad also has landing_screenshot metadata with an app_url; it is null when no preview was saved. MCP returns metadata and the app link, while REST serves the private JPEG rendered from saved HTML. New previews may include selected static styles, images and fonts fetched at render time; scripts and nested documents remain disabled, and fetched assets may differ from the original capture time.

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

Request

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

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[]
cursorstring

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

Response

One advertiser's metrics, category and saved ads

domainstring required
namestring nullable required

The label your team saved; not a verified company.

classification'unclassified' | 'competitor' | 'authorized_retailer' | 'affiliate' | 'reseller' | 'marketplace' | 'publisher' | 'coupon_site' | 'other' required

The category your team chose on the Advertisers page; unclassified when none.

observed_in_selectionboolean required
observationsinteger required

Saved observations: the visibility denominator.

ads_totalinteger required
next_cursorstring nullable required

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

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.