Competitor Tracker & Co. Docs
Changes

Org-wide feed of what changed across every competitor you subscribe to, merged so that an update touching 11 pages is one entry rather than 11 per-page changes. Each entry carries its member changes, their pages and the window it landed in. Pass `raw=true` for the per-page changes instead. `count=true` returns totals over the `[since, until)` window, counting entries by default and per-page changes when you add `raw=true`.

Org-wide feed of what changed across every competitor you subscribe to, merged so that an update touching 11 pages is one entry rather than 11 per-page changes.

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

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

GET
/v1/changes

Authorization

X-API-Key<token>

In: header

Query Parameters

cursor?string
limit?integer
Range0 < value <= 200
category?string|array<string>
priority?string|array<string>
competitorId?string
Formatuuid
labelId?string|array<string>
since?string
until?string
count?|
raw?|

Response Body

application/json

application/json

curl -X GET "https://api.competitortracker.io/v1/changes"
{
  "items": [
    {
      "id": "string",
      "competitorId": "string",
      "crawlDate": "string",
      "description": "string",
      "descriptionSource": "verbatim",
      "priority": "high",
      "category": "string",
      "firstDetectedAt": "string",
      "lastDetectedAt": "string",
      "memberCount": 0,
      "distinctPageCount": 0,
      "trackedPageTotal": 0,
      "pageTypeCounts": [
        {
          "pageType": "string",
          "count": 0
        }
      ],
      "members": [
        {
          "changeId": "string",
          "snapshotId": "string",
          "description": "string",
          "priority": "high",
          "detectedAt": "string",
          "trackedPageId": "string",
          "pageType": "string",
          "pageUrl": "string",
          "pagePath": "string",
          "isRepresentative": true
        }
      ]
    }
  ],
  "nextCursor": "string"
}
{
  "code": "string",
  "message": "string",
  "resolution": "string"
}

List detected changes attributed to a single snapshot. GET

List detected changes attributed to a single snapshot — Competitor Tracker & Co. API reference for GET /v1/snapshots/{id}/changes: request parameters, request.

Brief

Read the weekly brief a week at a time: every week on file with its counts, and one week's movers, totals and quiet competitors — the REST API reference.