Reports

Your affiliate IDs seen behind ads that use your brand

Lists the project's affiliate IDs found in destination URLs of ads whose copy uses the brand, with case status, networks, advertiser domains and example URLs. Use these scoped findings to prioritize partner review. Match the returned keyword text and market against list_keywords to resolve its keyword_id, then call list_keyword_ads with that keyword_id, view=ads, one advertiser domain from the finding, and the same date window and observation filters. After the team's review, record its outcome with set_affiliate_case_status. Requires an affiliate URL parameter in project settings; configured is false otherwise and the list is empty. A finding is a lead to review with the partner, not proof of a violation.

get/projects/{project_id}/affiliate-findings

Request

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

status'new' | 'in_progress' | 'resolved' | 'ignored'

Only cases with this status.

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

Your affiliate IDs seen behind ads that use your brand

next_cursorstring nullable required

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

configuredboolean required
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.