Developer Docs · v1
Pull your AI visibility scores, AI traffic, competitor share of voice, tracked prompts, and opportunities into your own dashboards, spreadsheets, automations, and MCP-compatible assistants.
Every request needs an API key passed as a Bearer token. Create keys in Settings → API Keys (paid plans). Keys are shown once at creation and can be revoked at any time.
Authorization: Bearer aa_live_...Base URL: https://answerarchitect.ai
Format: JSON. Successful responses wrap payloads in { "data": ... }; errors return { "error": { "message", "status } } with a matching HTTP status.
Rates & ratios: share-of-voice and rate fields are exact ratios (0–1) — multiply by 100 for percentages.
Connect Claude Desktop, Claude Code, Cursor, or another MCP-compatible client to query your Answer Architect visibility data with the same API keys.
{
"mcpServers": {
"answer-architect": {
"url": "https://answerarchitect.ai/api/mcp",
"headers": { "Authorization": "Bearer aa_live_..." }
}
}
}Available tools: list_projects, get_visibility_summary, get_competitors, get_prompts, get_opportunities, and whoami.
/api/v1/projectsAll projects on your account. Use the returned ids as projectId on the other endpoints.
Example request
curl https://answerarchitect.ai/api/v1/projects \
-H "Authorization: Bearer aa_live_..."Example response
{
"data": {
"projects": [
{ "id": "clx...", "name": "My Brand", "domain": "mybrand.com",
"industry": "accounting software", "createdAt": "2026-01-12T09:30:00.000Z" }
]
}
}/api/v1/visibility-summaryBrand-level aggregates from Arc's LLM-judge analysis of your tracked-prompt checks: GEO score, share of voice, sentiment, average rank, and recommendation rate.
Query parameters
projectIdoptional — Project id. Optional if your account has exactly one project.
lookbackDaysoptional — 7, 14, 30, or 90. Defaults to 30.
Example request
curl "https://answerarchitect.ai/api/v1/visibility-summary?projectId=clx...&lookbackDays=30" \
-H "Authorization: Bearer aa_live_..."Example response
{
"data": {
"project": { "id": "clx...", "name": "My Brand", "domain": "mybrand.com" },
"lookbackDays": 30,
"analyzedChecks": 42,
"brand": {
"shareOfVoice": 0.55, "recommendationRate": 0.31,
"avgRank": 2, "avgSentiment": 64, "avgVisibility": 58, "avgGeoScore": 61
}
}
}/api/v1/promptsYour tracked prompts with the latest citation status and Arc's latest analysis scores per prompt.
Query parameters
projectIdoptional — Project id. Optional if your account has exactly one project.
Example request
curl "https://answerarchitect.ai/api/v1/prompts?projectId=clx..." \
-H "Authorization: Bearer aa_live_..."Example response
{
"data": {
"project": { "id": "clx...", "name": "My Brand", "domain": "mybrand.com" },
"prompts": [
{ "id": "clp...", "prompt": "best accounting software uk", "platform": "chat_gpt",
"lastCheckedAt": "2026-07-16T06:04:11.000Z", "isCited": true,
"position": 2, "citationCount": 3,
"latestAnalysis": { "geoScore": 68, "sentimentScore": 71,
"rankPosition": 2, "recommendation": "strong_alternative" } }
]
}
}/api/v1/competitorsPer-competitor aggregates (share of voice, recommendation rate, average rank/sentiment/visibility), brands observed in answers that you don't track yet, and per-prompt competitive gaps ranked worst-first.
Query parameters
projectIdoptional — Project id. Optional if your account has exactly one project.
lookbackDaysoptional — 7, 14, 30, or 90. Defaults to 30.
Example request
curl "https://answerarchitect.ai/api/v1/competitors?projectId=clx..." \
-H "Authorization: Bearer aa_live_..."Example response
{
"data": {
"project": { "id": "clx...", "name": "My Brand", "domain": "mybrand.com" },
"lookbackDays": 30,
"analyzedChecks": 42,
"competitors": [
{ "id": "clc...", "name": "RivalOne", "domains": ["rivalone.com"],
"shareOfVoice": 0.47, "recommendationRate": 0.24,
"avgRank": 2, "avgSentiment": 62, "avgVisibility": 51 }
],
"observedBrands": [
{ "name": "AltProduct", "shareOfVoice": 0.12, "appearances": 5 }
],
"promptGaps": [
{ "prompt": "best accounting software uk", "platform": "chat_gpt",
"brandRate": 0.12, "leaderName": "RivalOne", "leaderRate": 0.47, "gap": 0.35 }
]
}
}/api/v1/ai-trafficReal referral visits captured by the Answer Architect traffic pixel, grouped by AI platform and day.
Query parameters
projectIdoptional — Project id. Optional if your account has exactly one project.
daysoptional — 1-90 day lookback window. Defaults to 30.
Example request
curl "https://answerarchitect.ai/api/v1/ai-traffic?projectId=clx...&days=30" \
-H "Authorization: Bearer aa_live_..."Example response
{
"data": {
"project": { "id": "clx...", "name": "My Brand", "domain": "mybrand.com" },
"days": 30,
"totalVisits": 128,
"platforms": [
{ "platform": "chatgpt", "label": "ChatGPT", "visits": 74, "share": 0.578 }
],
"daily": [
{ "date": "2026-07-17", "total": 9, "platforms": { "chatgpt": 6, "perplexity": 3 } }
]
}
}/api/v1/opportunitiesYour open, prioritised opportunity recommendations — the same list shown in the app, generated from prompt performance and competitor gaps.
Query parameters
projectIdoptional — Project id. Optional if your account has exactly one project.
Example request
curl "https://answerarchitect.ai/api/v1/opportunities?projectId=clx..." \
-H "Authorization: Bearer aa_live_..."Example response
{
"data": {
"project": { "id": "clx...", "name": "My Brand", "domain": "mybrand.com" },
"opportunities": [
{ "id": "clo...", "title": "Win the 'best accounting software uk' answer",
"description": "RivalOne appears in 47% of answers; you appear in 12%...",
"category": "create_content", "score": 82,
"targetTopic": "best accounting software uk",
"createdAt": "2026-07-15T08:00:00.000Z" } ]
}
}Ready to build?
Create an API key from your account settings.