Redirect chains

Traced redirect chains of a project

Lists the project's redirect traces requested in the window, newest first, with the same fields as get_redirect_chain. Use outcome and affiliate-ID filters to find chains for follow-up review. Engine, device, system, country and location filters apply to the saved check of the ad that asked for the trace. with_affiliate_ids keeps chains where an affiliate ID was observed. A trace is one visit from our servers; any inference is a prompt to review, not proof of who placed an ad or broke a rule. Defaults to the last 30 days in the person's time zone.

get/projects/{project_id}/redirect-traces

Request

  • Base URL: https://adslighthouse.com/api/v1
  • URL: https://adslighthouse.com/api/v1/projects/{project_id}/redirect-traces
  • 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[]
outcome'landed' | 'http_error' | 'blocked' | 'timeout' | 'too_many_hops' | 'loop' | 'network_error' | 'rate_limited' | 'invalid_destination'
boolean
OR
'true' | 'false'
limitinteger

Items per page, 1 to 200.

cursorstring

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

Response

Traced redirect chains of a project

next_cursorstring nullable required
total_rowsinteger required
request_idstring

Changes

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