API Documentation

Build with AnswerPilot

Integrate AI citation tracking and AEO insights directly into your products. Full API access available on Enterprise plans.

Quick Start

1. Get Your API Key

Generate an API key from your dashboard settings or upgrade to Enterprise.

# Your API key looks like:
ap_live_Xk9sLm2nQp4rTvW...

2. Make Your First Request

Track a new brand with a simple API call.

curl -X POST https://api.answerpilot.ai/v1/brands \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Acme Corp", "url": "https://acme.com"}'

Base URL

https://api.answerpilot.ai/v1

Authentication

All API requests require authentication via Bearer token in the Authorization header.

Authorization: Bearer ap_live_Xk9sLm2nQp4rTvW...

Endpoints

POST /brands

Create Brand

Add a new brand to track.

Request Body

{
  "name": "Acme Corp",
  "url": "https://acme.com",
  "industry": "technology"
}

Response

{
  "id": "brand_abc123",
  "name": "Acme Corp",
  "url": "https://acme.com",
  "created_at": "2026-07-07T10:00:00Z"
}
GET /brands

List Brands

Get all brands in your account.

Response

{
  "brands": [
    {
      "id": "brand_abc123",
      "name": "Acme Corp",
      "url": "https://acme.com",
      "citation_count": 2847
    }
  ],
  "total": 1
}
GET /brands/{brand_id}/citations

Get Brand Citations

Retrieve citation data for a specific brand.

Query Parameters

Parameter Type Description
platform string Filter by platform (chatgpt, perplexity, gemini, claude, aio)
from date Start date (ISO 8601)
to date End date (ISO 8601)
limit integer Results per page (default: 50, max: 500)

Response

{
  "citations": [
    {
      "id": "cit_xyz789",
      "platform": "chatgpt",
      "query": "best project management tools",
      "source_url": "https://acme.com/blog/pm-guide",
      "cited_at": "2026-07-07T08:30:00Z"
    }
  ],
  "total": 2847,
  "page": 1,
  "per_page": 50
}
GET /brands/{brand_id}/stats

Get Brand Statistics

Get aggregated statistics for a brand.

Response

{
  "brand_id": "brand_abc123",
  "total_citations": 2847,
  "citations_by_platform": {
    "chatgpt": 1247,
    "perplexity": 892,
    "gemini": 456,
    "claude": 252
  },
  "share_of_voice": 72,
  "trend_30d": 127
}
GET /keywords

List Keywords

Get all keywords being tracked for your brands.

Response

{
  "keywords": [
    {
      "id": "kw_123",
      "brand_id": "brand_abc123",
      "keyword": "project management software",
      "volume": 12500,
      "difficulty": 72
    }
  ]
}
POST /keywords

Add Keyword

Add a new keyword to track for a brand.

Request Body

{
  "brand_id": "brand_abc123",
  "keyword": "best PM tools for startups"
}
GET /competitors/{brand_id}

Get Competitor Analysis

Compare your brand's citations with competitors.

Response

{
  "your_brand": {
    "name": "Acme Corp",
    "citations": 2847,
    "share_of_voice": 72
  },
  "competitors": [
    {
      "domain": "competitora.com",
      "citations": 3172,
      "share_of_voice": 80,
      "trend": 12
    }
  ]
}

Rate Limits

Plan Requests/minute Requests/day
Starter 30 1,000
Professional 100 10,000
Enterprise 500 Unlimited

Error Codes

Code Meaning
400 Bad Request — Invalid parameters
401 Unauthorized — Invalid or missing API key
403 Forbidden — Plan doesn't include this feature
404 Not Found — Resource doesn't exist
429 Too Many Requests — Rate limit exceeded
500 Server Error — Something went wrong on our end

SDKs & Libraries

Node.js

Official Node.js SDK

npm install @answerpilot/sdk
Python

Official Python SDK

pip install answerpilot
Go

Official Go SDK

go get answerpilot.io/sdk

Need Help?

Our team is ready to help you integrate AnswerPilot into your product.

Contact Support View on GitHub