Skip to main content

AI Alerts API

AI Visibility Alerts API

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

Track visibility across

  • ChatGPT
  • Claude
  • Gemini
  • Grok
  • Perplexity
  • Google
Start Tracking for FreeView API Reference
alerts.sh
GET https://api.trackee.dev/v1/alerts
GET /v1/alerts?type=mention_lost
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

GET /v1/alerts

One request. Structured response.

Clean, predictable JSON that is easy to parse and build on. Free.

GETRequest
curl https://api.trackee.dev/v1/alerts?type=competitor_new \
  -H "x-access-key: YOUR_API_KEY"
JSONResponse
{
  "success": true,
  "data": {
    "total": 3,
    "limit": 50,
    "offset": 0,
    "alerts": [
      {
        "type": "competitor_new",
        "brand": "Salesforce",
        "prompt": "best CRM for enterprise sales teams",
        "engine": "chatgpt",
        "message": "Competitor HubSpot now appears for \"best CRM for enterprise sales teams\" on chatgpt.",
        "createdAt": "2026-08-27T17:00:00.000Z"
      }
    ]
  }
}

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 GET /v1/alerts

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.

Never miss a visibility change

Your brand's standing in AI answers shifts quietly. Alerts turn every scheduled scan into a feed of exactly what moved.

Change detection

Trackers compare every scheduled run to the last, so you see what changed instead of re-reading raw results.

The alerts that matter

Mention lost or gained, position moved, a new competitor cited, or sentiment flipped — each with a plain-English message.

Poll and react

One GET returns the change feed, filterable by brand and type, so you can wire it into Slack, email, or your own workflow.

No setup tax

Alerts are generated automatically by the trackers you already run. Reading them never costs credits.

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 are alerts generated?

Scheduled trackers re-run your brand's prompts, then compare each run to the previous one. Any meaningful change becomes an alert — no rules to configure.

What changes are detected?

Your brand being dropped from or added to a prompt, its position moving, a competitor newly appearing, and sentiment shifting between positive, neutral, and negative.

Does reading alerts cost credits?

No. Alerts are free to read. You only spend credits on the scheduled tracker runs that produce them.

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.

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.

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 AI Alerts API

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

No credit card required.