Redirect chains

Queue a server-side trace of a saved ad destination

Queues a trace of one destination URL that a saved ad of the project pointed to (use the url from list_keyword_ads or the observations list; other URLs are refused). Use it to inspect the recorded destination path and any affiliate IDs in that path. Our servers follow it hop by hop with a clear user agent and no cookies, recording each status code, the redirect mechanism, the final URL and any affiliate IDs present. It runs from our servers, not the searcher's country or device, so a location- or device-dependent redirect may differ. Script redirects are read from page source without running it. Each new trace uses one of the account's daily traces (resets 00:00 UTC); repeating the call for the same URL within the same UTC hour returns the same trace and uses nothing. The trace usually finishes within a minute: read it with get_redirect_chain. Requires the write scope and explicit user authorization.

post/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.

Request body

urlstring required

The saved ad destination URL, exactly.

Response

Queue a server-side trace of a saved ad destination

createdboolean required

False when a trace of this URL was already requested this hour.

request_idstring

Changes

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