API Documentation

Access AI citation data programmatically. Measure how AI models remember brands across categories.

Quick Start

Authentication

All API requests require a Bearer token in the Authorization header. Get your API key after signing up.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.outcited.com/v1/brand/stripe.com

Example Request

GET /api/v1/brand/stripe.com
Authorization: Bearer sk_live_...

Example Response

Returns AI citation scores—the percentage of times AI models recommend this brand when asked about relevant categories.

{
  "brandId": 42,
  "domain": "stripe.com",
  "overallScore": 82.3,
  "categoryScores": [
    {
      "category": "Payment Processing",
      "score": 87.5,
      "modelCount": 4,
      "consensus": 92.0,
      "rank": 2
    },
    {
      "category": "E-commerce Platforms",
      "score": 45.2,
      "modelCount": 3,
      "consensus": 78.5,
      "rank": 12
    }
  ],
  "modelScores": [
    {
      "model": "gpt-4o-mini",
      "score": 84.1,
      "isPremium": false
    },
    {
      "model": "gemini-1.5-flash",
      "score": 78.2,
      "isPremium": false
    },
    {
      "model": "deepseek-chat",
      "score": 81.8,
      "isPremium": false
    },
    {
      "model": "llama-3.1-70b",
      "score": 85.1,
      "isPremium": false
    }
  ]
}

Understanding the data: Scores represent citation rates (0-100%). A score of 87.5% means AI models recommend Stripe 87.5% of the time when asked about "Payment Processing". Consensus shows how much models agree (0-100%). Rank is the brand's position in that category.

API Pricing

API Tier

$49/mo

✓4 mass-market models (GPT-4o-mini, Gemini Flash, DeepSeek, Llama)
✓Category-level scores and rankings
✓Model consensus analysis
✓100 requests/day
✗Premium models (GPT-4, Claude, Gemini Pro)
✗Historical data / drift tracking

Enterprise Tier

$499/mo

✓7+ models (includes GPT-4, Claude, Gemini Pro)
✓Historical data and drift tracking
✓1,000 requests/day
✓Webhooks & custom integrations
✓Priority support
✓Custom rate limits available

API Endpoints

GET/api/v1/brand/{domain}

Get brand overview with AI citation scores from all available models. Returns overall score, category breakdown, and model-specific scores.

Available in: API Tier (4 models), Enterprise (7+ models)

Example: /api/v1/brand/stripe.com

Returns overall citation rate, scores by category, and how each AI model remembers the brand.

GET/api/v1/brand/{domain}/categories

Get detailed category breakdown with rankings. Shows where the brand ranks in each category and citation rates per category.

Available in: API Tier, Enterprise

Example: /api/v1/brand/stripe.com/categories

Returns all categories where the brand appears, with scores, ranks, and model consensus for each.

GET/api/v1/brand/{domain}/consensus

Get model consensus analysis. Shows how much AI models agree when citing this brand (agreement scores, variance, model-specific patterns).

Available in: API Tier, Enterprise

Example: /api/v1/brand/stripe.com/consensus

Returns consensus metrics: high consensus means models agree, low consensus means model-specific bias.

GET/api/v1/brand/{domain}/history

Get historical data showing how AI citation scores changed over time. Track drift, gains, and losses in AI memory.

Available in: Enterprise only

Example: /api/v1/brand/stripe.com/history?months=6

Returns time-series data showing citation rate changes. Useful for detecting shifts in AI model training or brand visibility.

GET/api/v1/leaderboard

Get top brands leaderboard. Rank brands by overall AI citation score or filter by category.

Query params: ?category=payments&limit=50

Example: /api/v1/leaderboard?category=Payment+Processing&limit=20

Returns ranked list of brands by citation score in the specified category.

GET/api/v1/categories

Get all available categories (2,147+). List of all categories we track AI citations for.

Available in: API Tier, Enterprise

Example: /api/v1/categories?search=payment

Returns list of categories. Use search param to filter by keyword.

Use Cases

Marketing Agencies

Pull AI citation data for client reports. Show clients how AI models remember their brand compared to competitors. Track category-specific visibility.

Analytics Platforms

Integrate competitive intelligence. Add AI citation scores to your dashboards. Monitor brand strength in the AI ecosystem.

Investment Firms

Monitor brand strength over time. Track how AI model training affects brand visibility. Detect shifts before they become public.

Internal Dashboards

Build custom monitoring systems. Track your brand's AI memory across categories. Alert on significant changes in citation rates.

Integration Examples

Node.js

const response = await fetch('https://api.outcited.com/v1/brand/stripe.com', {
  headers: {
    'Authorization': `Bearer ${process.env.OUTCITED_API_KEY}`
  }
});

const data = await response.json();

// Overall AI citation rate
console.log(`Stripe's AI citation rate: ${data.overallScore}%`);

// Category breakdown
data.categoryScores.forEach(cat => {
  console.log(`${cat.category}: ${cat.score}% (rank #${cat.rank})`);
});

Python

import requests

response = requests.get(
    'https://api.outcited.com/v1/brand/stripe.com',
    headers={'Authorization': f'Bearer {API_KEY}'}
)

data = response.json()

# Overall AI citation rate
print(f"Stripe's AI citation rate: {data['overallScore']}%")

# Category breakdown
for cat in data['categoryScores']:
    print(f"{cat['category']}: {cat['score']}% (rank #{cat['rank']})")

cURL

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.outcited.com/v1/brand/stripe.com

Rate Limits

API Tier100 requests/day

Enterprise1,000 requests/day

Need more? Contact us for custom rate limits.

Ready to get started?

Get API Key