# History and insights (/docs/tracking/history-and-insights)



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 [#query-individual-snapshots]

```bash
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 [#build-a-dashboard]

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

* [`GET /v1/brands/{id}/overview`](/docs/api/brands/getBrandOverview) returns coverage, average position, share of voice, sentiment, engine breakdowns, and common competitors.
* [`GET /v1/brands/{id}/timeline`](/docs/api/brands/getBrandTimeline) groups measurements by day and engine.

Both endpoints are free and support engine and date filters.

## Get recommendations [#get-recommendations]

[`POST /v1/recommendations`](/docs/api/recommendations/getRecommendations) 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 [#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`](/docs/api/alerts/getAlerts).

To deliver those changes automatically, configure [email or signed webhook notifications](/docs/webhooks).