Skip to main content
DocsAPI ReferenceAI Agents & Resources
Tracking

History and insights

Query snapshots, build overview and timeline views, get recommendations, and react to alerts.

View Markdown

Trackee stores snapshots when:

  • a live visibility check includes brandId;
  • a bulk scan includes brandId and its checks complete;
  • a recurring tracker runs.

Query individual snapshots

curl "https://api.trackee.dev/v1/snapshots?brand_id=BRAND_ID&engine=chatgpt&from=2026-09-01&to=2026-09-30&limit=100" \
  -H "x-access-key: YOUR_ACCESS_KEY"

Snapshot queries are free. Filter by brand, engine, prompt, mention state, and date range.

Build a dashboard

Use the brand-level read models instead of calculating every metric from raw snapshots:

Both endpoints are free and support engine and date filters.

Get recommendations

POST /v1/recommendations turns stored snapshots into prioritized gaps and opportunities. It can identify prompts where competitors appear but the brand does not, negative-sentiment topics, weak engines, and the largest competitive threat.

Recommendations are free because they analyze data you already collected. They become more useful after several prompts and dates have produced snapshots.

React to changes

Scheduled trackers create alerts for gained or lost mentions, position changes, new competitors, and sentiment changes. Query them with GET /v1/alerts.

To deliver those changes automatically, configure email or signed webhook notifications.

On this page