Observations

Organic search observations with detailed result content

Reads saved organic results without buying searches. Each observation includes keyword, market, engine, device, OS, location and time, organic and absolute positions when supplied, snippets, displayed URLs, sitelinks, images, ratings, prices and flags when available. Filters use OR within a dimension and AND between dimensions, before coverage counts and pagination. captured with zero results means an observed empty list; unavailable means organic data was missing or unreadable; legacy means historical capture completeness is unknown. Coverage describes the whole filtered window, not just this page. Results describe a first-page sample, not traffic, impressions or a fixed ranking. Unknown fields and internal acquisition metadata remain private. Defaults to the last 30 days.

get/projects/{project_id}/organic-observations

Request

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

keyword_idstring
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[]
limitinteger

Items per page, 1 to 200.

cursorstring

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

Response

Organic search observations with detailed result content

next_cursorstring nullable required
request_idstring

Changes

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