Bulk scans

A bulk scan accepts up to 25 prompts and runs every prompt against every selected engine. It supports chatgpt, claude, and gemini; use a live visibility check for Perplexity.

Start a scan

curl -X POST https://api.trackee.dev/v1/scans \
  -H "x-access-key: YOUR_ACCESS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brand": "Acme",
    "brandId": "BRAND_ID",
    "prompts": [
      "What is the best project management software?",
      "Which project management tool is best for startups?"
    ],
    "engines": ["chatgpt", "claude", "gemini"],
    "competitors": ["Linear", "Asana"],
    "sentiment": true
  }'

Bulk scans cost 5 credits per prompt-and-engine check, plus 1 when sentiment is enabled. Trackee charges the full grid when the scan starts. The example has six checks and costs 36 credits.

Poll for completion

The create response contains data.id and normally starts in a pending state. Poll until data.done is true:

curl https://api.trackee.dev/v1/scans/SCAN_ID \
  -H "x-access-key: YOUR_ACCESS_KEY"

Polling is free and advances the scan by collecting newly ready results. Read data.progress for completed, failed, and pending counts.

If you include brandId, completed checks become brand snapshots. Without it, the scan still retains its own results but does not add them to brand history.

List recent scans with GET /v1/scans. See the Scans API reference for schemas and pagination.