Other advertisers ranked by ad occurrences, with your categories
Lists the advertiser domains other than your own seen on the project's monitored keywords in the window and filters, as on the Advertisers page: ads_observed = paid ad occurrences, average_position = mean paid slot (1 is the first ad), last_seen, and the category your team saved (unclassified when none). Use it to identify advertisers recurring in the monitored results, then call get_advertiser_history to check when they appeared and whether monitoring covered the period. This ranks the project's saved checks, not the full market, and does not measure advertiser spend. Use set_advertiser_classification to save your team's category. Imported studies are not included.
Request
- Base URL: https://adslighthouse.com/api/v1
- URL: https://adslighthouse.com/api/v1/projects/{project_id}/competitors
- Auth: HTTP bearer
Path parameters
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
Window ending today: 7d, 14d, 30d (default) or 12m. Use custom with from and to for fixed dates.
First local day, YYYY-MM-DD (custom range).
Last local day, YYYY-MM-DD, included in full (custom range).
IANA time zone for day boundaries, such as America/New_York. Defaults to the time zone of the person the credential acts for.
Items per page, 1 to 200.
The next_cursor value from the previous page. Omit it for the first page.
Response
Other advertisers ranked by ad occurrences, with your categories
Changes
No recorded changes to this operation across all 1 revision of this API.