Skip to main content

​
Overview

Answer-Engine / Generative-Engine Optimization. Company-scoped; requires Authorization: Bearer nv_sk_…. Pay-per-use via our data provider. MCP equivalents: naive_aeo_discover + naive_aeo_execute(_async). LLM Responses (ChatGPT/Claude/Gemini) offer Live + Standard …/task; Perplexity is Live-only. LLM Scraper, AI Keywords, and LLM Mentions are Live.
REST callers: LLM Responses require user_prompt (string, ≤500 chars) and model_name (e.g. gpt-4o, claude-3-5-sonnet); the CLI maps --keyword → user_prompt. LLM Mentions require exactly one of keyword or domain, plus target as an array of objects, e.g. [{ "domain": "example.com" }].

​
LLM Responses

MethodPathDescription
POST/v1/aeo/llm-responses/chatgptChatGPT response (Live)
POST/v1/aeo/llm-responses/chatgpt/taskChatGPT response (Standard)
GET/v1/aeo/llm-responses/chatgpt/tasks-readyCheck ready tasks
GET/v1/aeo/llm-responses/chatgpt/task/:idRetrieve task results
GET/v1/aeo/llm-responses/chatgpt/modelsAvailable ChatGPT models
POST/v1/aeo/llm-responses/claudeClaude response (Live)
POST/v1/aeo/llm-responses/claude/taskClaude response (Standard)
GET/v1/aeo/llm-responses/claude/tasks-readyCheck ready tasks
GET/v1/aeo/llm-responses/claude/task/:idRetrieve task results
GET/v1/aeo/llm-responses/claude/modelsAvailable Claude models
POST/v1/aeo/llm-responses/geminiGemini response (Live)
POST/v1/aeo/llm-responses/gemini/taskGemini response (Standard)
GET/v1/aeo/llm-responses/gemini/tasks-readyCheck ready tasks
GET/v1/aeo/llm-responses/gemini/task/:idRetrieve task results
GET/v1/aeo/llm-responses/gemini/modelsAvailable Gemini models
POST/v1/aeo/llm-responses/perplexityPerplexity response (Live only)
GET/v1/aeo/llm-responses/perplexity/modelsAvailable Perplexity models

​
LLM Scraper

MethodPathDescription
POST/v1/aeo/llm-scraper/chatgptScrape ChatGPT Search (Live)
POST/v1/aeo/llm-scraper/chatgpt/htmlScrape ChatGPT Search HTML (Live)
POST/v1/aeo/llm-scraper/chatgpt/taskScrape ChatGPT Search (Standard)
GET/v1/aeo/llm-scraper/chatgpt/tasks-readyCheck ready tasks
GET/v1/aeo/llm-scraper/chatgpt/task/:idRetrieve task results
GET/v1/aeo/llm-scraper/chatgpt/task/:id/htmlRetrieve task results (HTML)

​
AI Keyword Data

MethodPathDescription
POST/v1/aeo/ai-keywords/search-volumeAI search volume estimates (Live)

​
LLM Mentions

MethodPathDescription
POST/v1/aeo/llm-mentions/searchDetailed mentions data (Live)
POST/v1/aeo/llm-mentions/aggregated-metricsAggregated mention metrics (Live)
POST/v1/aeo/llm-mentions/cross-aggregated-metricsCross-target metrics comparison (Live)
POST/v1/aeo/llm-mentions/top-domainsMost mentioned domains (Live)
POST/v1/aeo/llm-mentions/top-pagesTop mentioned pages (Live)

​
Utility

MethodPathDescription
POST/v1/aeo/id-listList task IDs

​
Examples

curl -X POST https://api.usenaive.ai/v1/aeo/llm-responses/chatgpt \
  -H "Authorization: Bearer nv_sk_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "user_prompt": "best CRM for startups", "model_name": "gpt-4o" }'