Skip to main content

Bulk Scans API

Bulk Scans API

Run your brand's entire prompt set across every engine in one job.

Track visibility across

  • ChatGPT
  • Claude
  • Gemini
  • Grok
  • Perplexity
  • Google
scans.sh
POST https://api.trackee.dev/v1/scans
{ "brand": "Polar", "prompts": ["…", "…"], "engines": ["chatgpt", "gemini"] }
Mentions
Across AI answers

126

+18% this week

Share of voice
Against competitors

34%

+4.2 points

Citations
Pages used as sources

48

12 new sources

POST /v1/scans

One request. Structured response.

Clean, predictable JSON that is easy to parse and build on. 5 credits per check.

POSTRequest
curl -X POST https://api.trackee.dev/v1/scans \
  -H "x-access-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brand": "Polar",
    "domain": "polar.sh",
    "prompts": ["best merchant of record", "stripe alternatives"],
    "engines": ["chatgpt", "gemini"]
  }'
JSONResponse
{
  "success": true,
  "credits": { "charged": 20, "remaining": 4980 },
  "data": {
    "id": "scn_123",
    "status": "pending",
    "progress": { "total": 4, "completed": 0, "failed": 0, "pending": 4 },
    "done": false
  }
}

Live in three steps

From access key to your first call in minutes.

01

Get your access key

Create a free account and copy your access key from the dashboard.

02

Call POST /v1/scans

Send one request with the x-access-key header. No SDK required.

03

Build on clean JSON

Parse the typed response and ship it into your product, dashboard, or agent.

AI visibility at scale

Checking one prompt at a time doesn't scale. Scans run your entire prompt set across every engine as a single background job.

Submit once

Send your whole grid of prompts and engines in a single request; we register them all as background tasks and return a scan id.

Poll for status

Check progress any time — total, completed, failed, and per-check results stream in as they finish. Poll until `done`.

Full visibility per check

Each check returns whether your brand was mentioned, its position, the competitors named alongside it, and cited sources.

Feeds your history

Tie a scan to a saved brand and every completed check becomes a snapshot — powering timelines, overview, and alerts.

SDKs and tools

One API. Every way to build.

Start with Node.js over REST, or hand the query to an agent. The same visibility contract sits underneath.

01

REST API

API docs

One predictable contract for visibility checks, normalized results, and organization-scoped access.

02

SDK

Coming soon

Official TypeScript and Python clients are on the way.

03

AI agents

AI docs

Let Claude, Codex, Cursor, or your own agent query Trackee through MCP and agent-ready tools.

04

Dashboard

Open app

Use the same underlying data in a visual workspace for teams that prefer to inspect and compare results.

visibility.js
const response = await fetch(
  "https://api.trackee.dev/v1/track",
  {
    method: "POST",
    headers: {
      "x-access-key": process.env.TRACKEE_ACCESS_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      brand: "Acme",
      prompt: "best project management software",
      engines: ["chatgpt", "claude", "google"],
    }),
  },
);

const visibility = await response.json();
One request · every configured engine

Frequently asked questions

How do I get the results?

Poll GET /v1/scans/{id}. Each poll advances the scan and returns its status, progress, and per-check results. Keep polling until `done` is true.

Which engines are supported?

The async-capable ones: ChatGPT, Claude, and Gemini. Perplexity has no async mode — use the AI Visibility API for it.

What does it cost?

5 credits per check (prompts × engines), plus 1 per check if you enable sentiment. You're charged upfront when the scan is submitted.

See every field and status code in the API reference.

One access key

Explore the Trackee API

AI Visibility API

Check whether ChatGPT, Claude, Gemini, and Perplexity mention your brand for any prompt.

Rank Tracking API

Get a domain's Google position and AI Overview presence for any keyword.

Keyword Research API

Search volume, CPC, and competition for any list of keywords, in one request.

AI Mentions API

Find the real AI answers that mention your brand across Google AI Overviews and ChatGPT.

AI Citations API

See which pages and domains AI models cite most when they mention your brand.

AI Alerts API

Get notified the moment AI changes what it says about your brand.

Recommendations API

Turn your AI-visibility data into a prioritized to-do list.

Ranked Keywords API

See every keyword a domain ranks for in Google.

Domain Overview API

Size up any domain's organic search footprint in one call.

Backlinks API

Get any domain's backlink profile in a single call.

SEO Audit API

Audit any page's on-page SEO in one instant call.

SERP Competitors API

Discover the domains that compete for your keywords in Google, ranked by visibility.

Brand Tracking API

Save brands with their prompts and competitors, then reuse them. Free to manage.

Keyword Ideas API

Turn one seed keyword into hundreds of related ideas with volume, CPC, and intent.

Monitoring API

Store every check and query your visibility history by brand, engine, and date.

Trackers API

Schedule recurring scans so your AI visibility history keeps building without you lifting a finger.

Bulk Scans API

Run your brand's entire prompt set across every engine in one job.

AI Answers API

Run one prompt across every major AI model and get their answers plus cited sources.

AI Keyword Volume API

See how often keywords are searched inside AI assistants, with a monthly trend.

Start building with the Bulk Scans API

Create a free account, grab an access key, and make your first call in minutes.
Start Tracking for Free

No credit card required.