Competitor Tracker & Co. Docs

Get the event timeline for a single competitor, newest first, where the `change_detected` line counts one entry per crawl day rather than one per analysed page. Pass `raw=true` to count each analysed page instead. A crawl day we have not merged yet keeps its per-page lines either way.

Get the event timeline for a single competitor, newest first, where the `change_detected` line counts one entry per crawl day rather than one per analysed page.

Required role: member or higher (organization-level).

Required scope: competitors:read (for both OAuth2 tokens and API keys).

GET
/v1/competitors/{id}/timeline

Authorization

X-API-Key<token>

In: header

Path Parameters

id*string
Length1 <= length

Query Parameters

raw?|

Response Body

application/json

application/json

curl -X GET "https://api.competitortracker.io/v1/competitors/01HF.../timeline"
{
  "events": [
    {
      "kind": "competitor_added",
      "occurredAt": "string",
      "params": {
        "property1": null,
        "property2": null
      }
    }
  ]
}
{
  "code": "string",
  "message": "string",
  "resolution": "string"
}