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.

AI Checker
POST /v1/ai-check

Ask ChatGPT, Gemini, Claude, Perplexity, DeepSeek & Grok about a brand and get each model's verdict + a visibility summary.

AI Visibility Score
POST /v1/score

Score any URL across AI and Web signals, with category breakdowns and prioritized fixes.

Keyword Research
POST /v1/keywords

Search volume, AI search demand, difficulty, CPC, related keywords, and live SERPs.

Prompt Advisor
POST /v1/prompt-advisor

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
Get a key in seconds: log in to seoai.space → API tab → Create API key. Every new key includes 5 free calls; top up with prepaid packs anytime. For committed volume or a co-funded integration, email info@blocksky.xyz.

Endpoints

POST/v1/ai-checkapi key
Ask real AI models a question and see what they say about a brand. Body: {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.
POST/v1/scoreapi key
Same engine as the homepage Free Score / 簡易診断. Body: {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).
POST/v1/keywordsapi key
Keyword research. Body: {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.
POST/v1/prompt-advisorapi key
Cluster keywords into intent-based AI prompts. Body: {keywords (≥3), locale?, seed_keyword?, business_context?}. Returns prompt clusters + a top-5 priority list.
GET/v1/healthpublic
Liveness check. Returns {"ok": true} when the API is reachable.
Corpus data endpoints (/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.

STARTER
$50 / 2,000 calls
  • $0.025 per call
  • 5 trial calls on a new key
GROWTH
$100 / 5,000 calls
  • $0.02 per call
  • Volume discount
PRO
$200 / 15,000 calls
  • $0.013 per call
  • Volume discount
SCALE
$500 / 40,000 calls
  • $0.0125 per call
  • Largest self-serve pack
Self-serve checkout is locked for now. Email info@blocksky.xyz for a key and a pack (or an invoice for partner volume). Pricing indicative.

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

StatusBodyMeaning
400missing_paramsRequired fields missing or invalid.
401missing_api_key / invalid_api_keyNo / unknown / revoked key.
402out_of_creditsPrepaid balance is 0 — top up.
429rate_limitedPer-IP burst cap. Retry-After is set.
503*_unavailableAn upstream provider is temporarily down.

Status

Live: seoai.space/v1/health · full endpoint list at seoai.space/v1/