Pricing
Sign inStart free trial→
Try free
Track

MentionShare Tracking

See your brand mention rate across 9 AI engines daily

Competitor Intelligence

Track share-of-voice vs competitors across all engines

Prompt Performance

Per-query mention rates and 90-day trend lines

Citation Sources

See which URLs AI engines cite when mentioning your brand

Fix

Fix Generator

Generate FAQ blocks, JSON-LD schema, and answer paragraphs

AI SEO Audit

Page-by-page AI readiness scoring with specific fixes

Schema Audit

Find missing structured data and generate JSON-LD fixes

LLMs.txt Scanner

Verify AI crawlers can access and read your website

Authority Capture

Build topical authority signals AI engines trust and cite

Sentiment Analysis

Track if AI describes your brand positively or negatively

IntegrationsGA4Search ConsoleAPI

By Team

Marketing Teams

Track AI visibility and generate content at scale

Founders & Startups

Get cited by AI engines from day one — no SEO agency needed

Agencies

Manage client workspaces with white-label PDF reporting

B2B SaaS Companies

Win AI-generated buyer comparisons in your software category

By Use Case

Improve AI Citations

Publish content that trains ChatGPT and Perplexity to recommend you

Beat Competitors in AI

Steal share-of-voice from brands dominating AI answers

Audit AI Readiness

Find every technical and content gap hurting your visibility

Prove AI-Driven ROI

Connect AI citations to real traffic and pipeline via GA4

Managing multiple clients?See Agency plan →

Content

Blog

New

AEO strategies, AI visibility guides, and industry insights

What's New

Updated

Latest product releases, features, and platform updates

AEO Beginner Guide

Free

Free 10-step guide to getting cited in AI search results

Reference

Documentation

Platform guide — features, workflows, and getting started

API Reference

REST API docs, authentication, and code examples

New to AEO?Read the free guide →

On this page

Overview
Authentication
Base URL
Rate Limits
Endpoints
GET /businessesPOST /scansGET /scans/:idPOST /fixes/generateGET /mention-shareGET /competitors
SDKs
Code Examples
Webhooks
Error Codes

Need help?

hello@truecite.ai

TrueCite REST API

Track AI visibility and generate fix content programmatically. Available on Pro and Enterprise plans.

✓ REST API
✓ JSON responses
✓ Webhook support

Authentication

All API requests require an API key passed in the Authorization header. Get your API key from your dashboard settings.

Authorization headercurl
curl https://api.truecite.ai/v1/businesses \
  -H "Authorization: Bearer tc_live_your_api_key_here" \
  -H "Content-Type: application/json"

⚠️ Keep your API key secret. Never expose it in client-side code or public repositories. Rotate immediately if compromised.

Base URL

Production
https://api.truecite.ai

Rate Limits

PlanRequests/minScans/monthConcurrent scans
Pro606005
Enterprise300Custom20

Endpoints

GET/v1/businessesList all businesses in your account

Response

200 OK
{
  "businesses": [
    {
      "id": "biz_abc123",
      "name": "Acme Corp",
      "website": "https://acme.com",
      "industry": "B2B SaaS",
      "created_at": "2026-05-01T00:00:00Z"
    }
  ]
}
POST/v1/scansTrigger a new AI visibility scan

Request Body

{
  "business_id": "biz_abc123",
  "prompts": [
    "What is the best AEO tool for B2B SaaS?",
    "How do I get my brand cited by ChatGPT?"
  ],
  "engines": ["chatgpt", "perplexity", "gemini", "claude"]
}

Response

200 OK
{
  "scan_id": "scan_xyz789",
  "status": "processing",
  "estimated_seconds": 30,
  "results_url": "https://api.truecite.ai/v1/scans/scan_xyz789"
}
GET/v1/scans/:scan_idGet scan results by ID

Response

200 OK
{
  "scan_id": "scan_xyz789",
  "status": "completed",
  "mention_share_score": 34,
  "results": [
    {
      "engine": "chatgpt",
      "prompt": "What is the best AEO tool?",
      "brand_mentioned": true,
      "brand_position": 2,
      "mention_share_score": 45,
      "brand_sentiment": "positive",
      "competitors_mentioned": ["Profound", "HubSpot AEO"],
      "scanned_at": "2026-05-03T10:00:00Z"
    }
  ]
}
POST/v1/fixes/generateGenerate AEO fix content for a scan

Request Body

{
  "scan_id": "scan_xyz789",
  "engine": "chatgpt",
  "types": ["faq_block", "answer_paragraph", "json_ld"]
}

Response

200 OK
{
  "fix_id": "fix_def456",
  "engine": "chatgpt",
  "blocks": [
    {
      "type": "faq_block",
      "title": "FAQ Block",
      "content": "<div itemscope itemtype='https://schema.org/FAQPage'>..."
    },
    {
      "type": "json_ld",
      "title": "JSON-LD Schema",
      "content": "{"@context": "https://schema.org", ...}"
    }
  ]
}
GET/v1/mention-shareGet MentionShare trend data for a business

Response

200 OK
{
  "business_id": "biz_abc123",
  "current_score": 34,
  "trend": [
    { "date": "2026-04-27", "score": 20 },
    { "date": "2026-04-28", "score": 25 },
    { "date": "2026-04-29", "score": 28 },
    { "date": "2026-04-30", "score": 30 },
    { "date": "2026-05-01", "score": 34 }
  ]
}
GET/v1/competitorsList competitors for a business

Response

200 OK
{
  "competitors": [
    {
      "id": "comp_111",
      "name": "Profound",
      "website": "https://profound.co",
      "mention_count": 8
    }
  ]
}

Official SDKs

Native SDK packages for the most common languages are in development. Until release, use the REST API directly with any HTTP client.

⬡Node.jsAvailable Q3 2026
npm install @truecite/sdk
🐍PythonAvailable Q3 2026
pip install truecite

Subscribe to the changelog to be notified when SDKs ship.

Code Examples

Pythonrequests library
import requests, time

API_KEY = "tc_live_your_api_key_here"
BASE_URL = "https://api.truecite.ai/v1"
headers = {"Authorization": f"Bearer {API_KEY}"}

# Trigger a scan
scan = requests.post(f"{BASE_URL}/scans", headers=headers, json={
    "business_id": "biz_abc123",
    "prompts": ["What is the best AEO tool for B2B SaaS?"],
    "engines": ["chatgpt", "perplexity", "gemini"]
}).json()

print(f"Scan started: {scan['scan_id']}")

# Poll for results
time.sleep(30)
results = requests.get(
    f"{BASE_URL}/scans/{scan['scan_id']}",
    headers=headers
).json()

print(f"MentionShare: {results['mention_share_score']}%")
Node.jsfetch API
const API_KEY = 'tc_live_your_api_key_here'
const BASE_URL = 'https://api.truecite.ai/v1'
const headers = {
  'Authorization': `Bearer ${API_KEY}`,
  'Content-Type': 'application/json'
}

// Trigger a scan
const scan = await fetch(`${BASE_URL}/scans`, {
  method: 'POST',
  headers,
  body: JSON.stringify({
    business_id: 'biz_abc123',
    prompts: ['What is the best AEO tool for B2B SaaS?'],
    engines: ['chatgpt', 'perplexity', 'gemini']
  })
}).then(r => r.json())

// Get results after processing
await new Promise(r => setTimeout(r, 30000))
const results = await fetch(`${BASE_URL}/scans/${scan.scan_id}`, { headers })
  .then(r => r.json())

console.log('MentionShare:', results.mention_share_score + '%')

Webhooks

Receive real-time notifications when scans complete. Configure your webhook URL in dashboard settings.

Webhook payload — scan.completed
{
  "event": "scan.completed",
  "scan_id": "scan_xyz789",
  "business_id": "biz_abc123",
  "mention_share_score": 34,
  "scanned_at": "2026-05-03T10:00:00Z",
  "summary": {
    "total_prompts": 5,
    "mentioned": 2,
    "not_mentioned": 3,
    "engines": ["chatgpt", "perplexity", "gemini"]
  }
}

Error Codes

CodeMeaningSolution
401UnauthorizedCheck your API key is valid and included in the Authorization header
403ForbiddenThis endpoint requires a Pro or Enterprise plan
404Not FoundThe resource ID does not exist or belongs to another account
429Rate LimitedSlow down requests. Check the Retry-After header for when to retry
500Server ErrorSomething went wrong on our end. Retry after a few seconds

Ready to integrate?

API access is available on Pro and Enterprise plans.

Upgrade to Pro →Contact for Enterprise

© 2026 truecite. — A product of AI Collective Labs Inc.

PrivacyTermsSupport