GPT-4o·CRAWLING·/pricing PerplexityBot·CITED·/blog/ai-search Gemini-Crawler·READING·/features ClaudeBot·INDEXING·/case-studies SemrushBot·BLOCKED·/api/internal GPT-4o·CRAWLING·/integrations PerplexityBot·CITED·/docs/overview Gemini-Crawler·READING·/about Ahrefsbot·CRAWLING·/sitemap.xml ClaudeBot·CITED·/pricing GPT-4o·CRAWLING·/pricing PerplexityBot·CITED·/blog/ai-search Gemini-Crawler·READING·/features ClaudeBot·INDEXING·/case-studies SemrushBot·BLOCKED·/api/internal GPT-4o·CRAWLING·/integrations PerplexityBot·CITED·/docs/overview Gemini-Crawler·READING·/about Ahrefsbot·CRAWLING·/sitemap.xml ClaudeBot·CITED·/pricing

Developers

Build on
BotIntel.

A clean REST API, webhook events, and SDKs for Node and Python. Pull your visibility data into any pipeline, dashboard, or automation.

base_urlapi.botintel.ai/v2

authBearer token

formatJSON

rate_limit1000 req/min

statusv2 stable

Authentication

API Keys

All requests require a Bearer token in the Authorization header. Generate keys from your account dashboard under Settings → API Keys. Keys are scoped per workspace and can be restricted to read-only.

Bearer Token Read-Only Scope Per-Workspace

          curl https://api.botintel.ai/v2/agents \
            -H "Authorization: Bearer YOUR_KEY" \
            -H "Content-Type: application/json"
        

Core Endpoints

GET /agents

Returns a paginated list of all AI agent visits for your domain. Filter by date range, agent type, page path, or action (READ, CRAWL, CITED, BLOCKED).

            {
              "data": [
                {
                  "agent": "GPT-4o",
                  "path": "/pricing",
                  "action": "READ",
                  "ts": 1741234567
                }
              ],
              "total": 4820,
              "page": 1
            }
          

GET /citations

Returns citation events — instances where your content was referenced in an AI-generated answer. Includes the citing agent, source page, query context, and rank position.

            {
              "citations": [
                {
                  "cited_by": "Perplexity AI",
                  "source_url": "/blog/ai-search",
                  "rank": 2,
                  "query": "best AI tracking tools"
                }
              ]
            }
          

GET /score

Returns the AI Visibility Score for a given page or domain. Includes sub-scores for crawl frequency, extraction depth, structured data quality, and citation rate.

            {
              "url": "https://yourdomain.com/pricing",
              "score": 91,
              "crawl_freq": 94,
              "extraction": 88,
              "schema": 72,
              "citation_rate": 0.34
            }
          

POST /webhooks

Register a webhook URL to receive real-time event payloads. Supported events: agent.visit, citation.detected, score.change, competitor.update. HMAC-SHA256 signature included on every request.

            {
              "event": "citation.detected",
              "ts": 1741234567,
              "data": {
                "agent": "GPT-4o",
                "page": "/case-studies",
                "rank": 1
              }
            }
          

SDKs

Node.js

npm install @botintel/sdk

          import BotIntel from '@botintel/sdk'
          // initialize
          const bi = new BotIntel({ key: process.env.BI_KEY })
          // get recent citations
          const citations = await bi.citations.list({ days: 7 })
        

Python

pip install botintel

          from botintel import Client
          # initialize
          bi = Client(api_key=os.environ["BI_KEY"])
          # get visibility score
          score = bi.score.get(url="/pricing")
        

Build onBotIntel.

The AI visibilitywindow is open —but closing fast.

Build on
BotIntel.

The AI visibility
window is open —
but closing fast.