SEOAI's AI-visibility engine, in your own apps.
One REST API to ask real AI models what they say about a brand, score any URL's AI-readiness, research keywords, and turn them into AI-search prompts — the same engines that power seoai.space, callable from your product, scripts, or backend.
Ask ChatGPT, Gemini, Claude, Perplexity, DeepSeek & Grok about a brand and get each model's verdict + a visibility summary.
Score any URL across AI and Web signals, with category breakdowns and prioritized fixes.
Search volume, AI search demand, difficulty, CPC, related keywords, and live SERPs.
Cluster keywords into intent-based, natural-language prompts people actually ask AI.
Quickstart
Every endpoint is a stable JSON REST contract. No SDK required.
curl https://seoai.space/v1/health
# Ask AI models what they say about a brand
curl -X POST https://seoai.space/v1/ai-check \
-H "Authorization: Bearer $SEOAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "best CRM for startups", "brand_name": "Acme", "brand_domain": "acme.com"}'
Authentication
Every product endpoint requires a Bearer token in the Authorization
header. Query-string keys are rejected (they leak into proxy logs). Each call
is logged with status, latency, and credit cost.
Authorization: Bearer sk_seoai_XXXXXXXXXXXXXXXXXXXXXXXXXXXX
Endpoints
{query, brand_name, brand_domain?, models?, search_mode?}.
models defaults to a fast 3 (ChatGPT, Gemini, Perplexity) and is
capped by your plan; search_mode is knowledge or
web. Returns per-model verdicts, mentions, citations, and a
visibility summary. Queries run sequentially, so large model sets take longer.
{url, locale?, async?}. locale is
en / ja / vi.
async: true returns 202 + job_id
— poll GET /v1/jobs/<id>. A scan can take up to 180 seconds.
Not /v1/demo (that is a lighter public demo).
{keywords?, seed?, limit?, language?, serp?} —
pass keywords for exact metrics, seed for related-keyword
expansion, and/or serp for a live top-10. language is
ja or en.
{keywords (≥3), locale?, seed_keyword?, business_context?}.
Returns prompt clusters + a top-5 priority list.
{"ok": true} when the API is reachable./v1/domain, /v1/search,
/v1/industry/…) over our index of crawled companies are also
available on request — ask sales if your use case needs them.
Pricing
Simple and flat: 1 successful call = 1 prepaid call. Every new key starts with 5 free calls. Four prepaid packs only — cap is 40,000 calls. No subscription; unused calls don't expire.
- $0.025 per call
- 5 trial calls on a new key
- $0.02 per call
- Volume discount
- $0.013 per call
- Volume discount
- $0.0125 per call
- Largest self-serve pack
Example response — /v1/ai-check
{
"ok": true,
"query": "best CRM for startups",
"brand_name": "Acme",
"models": ["ChatGPT", "Gemini", "Perplexity"],
"results": [
{
"model": "ChatGPT",
"verdict": "knows",
"business_mentioned": true,
"mention_level": "recognized",
"citations": ["https://acme.com/"],
"response": "..."
}
],
"summary": {
"engines_recognized": 2,
"engines_not_mentioned": 1,
"verdict": "mentioned"
},
"diagnosis": { "domain": "acme.com", "reachable": true, "has_llms_txt": false }
}
Errors
| Status | Body | Meaning |
|---|---|---|
| 400 | missing_params | Required fields missing or invalid. |
| 401 | missing_api_key / invalid_api_key | No / unknown / revoked key. |
| 402 | out_of_credits | Prepaid balance is 0 — top up. |
| 429 | rate_limited | Per-IP burst cap. Retry-After is set. |
| 503 | *_unavailable | An upstream provider is temporarily down. |
Status
Live: seoai.space/v1/health · full endpoint list at seoai.space/v1/