API reference
The Competitor Tracker & Co. REST API: base URL, authenticating with an OAuth token or API key, the shape of requests and responses, where every endpoint lives.
Everything Competitor Tracker & Co. does is here as a plain REST API over HTTPS. You subscribe to competitors, read the changes we caught, manage labels and dispatches, run your organization. JSON goes in, JSON comes out. Our lead detective C. T. Lucky checks every credential at the door. No badge, no entry.
Base URL
https://api.competitortracker.io/v1Every route lives under /v1. The pages in this section give the full path for each one.
Authenticate
Every call to /v1/* needs a credential, and the API takes two kinds:
- OAuth 2.0 bearer token for apps that sign a person in. Send it on the
Authorization: Bearer …header. See Using OAuth2. - API key for scripts and headless jobs. Send it on the
X-API-Keyheader. See Using API keys.
If both headers arrive the API key wins. What a credential may do comes down to its scopes and your role in the organization.
Requests and responses
Send and read application/json. List endpoints page with an opaque cursor: pass the nextCursor from one response as the cursor on the next. When something goes wrong the reply carries a machine-readable code and a human-readable message, so you can branch on the code and show the message.
When you need to slow down, that comes back the same way — a plain error telling you to back off.
Browse by area
Each area has its own page listing every endpoint, with a "try it" console on each call. The pages are generated from the live API description, so they track what the API actually serves.
Competitors
Subscribe, list, update and unsubscribe from tracked competitors.
Pages
The tracked pages behind each competitor you subscribe to.
Snapshots
Snapshots for a tracked page, plus signed URLs for the artifacts.
Detected changes
What the pack caught: per competitor, per snapshot or org-wide.
Labels
Create organization labels and pin them on competitors.
Dispatches
Recipients, webhooks and the delivery log for the weekly brief.
Organization
Leave, transfer ownership or close the organization.
Users
Read and update the signed-in user's profile.
Billing
The per-organization coin balance and transaction ledger.
Onboarding
Activation-checklist progress, and dismissing the checklist.
API keys
Mint and manage keys for scripts, jobs and AI agents.
Feedback
File a bug or suggestion, or find the feature idea board.
Health
A readiness probe for the service.
New here? Getting started walks the whole flow end to end, from your first key to reading a competitor's changes. Prefer to drive it from an AI client? The same endpoints are exposed over the Model Context Protocol.
MCP tools
The catalog of ~50 tools the Competitor Tracker & Co. MCP server exposes: competitors, changes, snapshots, labels, dispatches and org management, with params.
Competitors
Subscribe, list, get, update, and unsubscribe from tracked competitors — the REST API reference for this group: every path with its parameters, the request.