InstaRank SEO
AI Visibility API

AI Visibility API

Measure whether — and where — a domain is cited by the major AI assistants (ChatGPT, Claude, Gemini, Perplexity) for the queries that matter in its niche.

POST/api/v1/ai-visibility$0.10 per keywordscope ai:read
Get your API keyFull API reference
Quick start

One request, structured JSON back

Request
curl -X POST https://instarankseo.com/api/v1/ai-visibility \
  -H "X-API-Key: isk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com", "count": 3}'
Response
{
  "success": true,
  "domain": "example.com",
  "keywordsAnalyzed": 3,
  "visibilityScore": 41,
  "mentionedInQueries": 1,
  "queries": [
    { "query": "...", "visibilityScore": 75, "citedByEngines": 3,
      "engines": { "chatgpt": { "cited": true, "position": 1 } },
      "citationSources": [ ... ] }
  ],
  "meta": { "creditsUsed": 300, "creditsRemaining": 18700, "apiVersion": "1.0" }
}
Reference

Parameters

FieldTypeRequiredDescription
domainstringrequiredTarget domain (hostname or URL).
keywordsstring[]optionalExplicit queries to test (max 4). Omit to auto-generate real niche queries.
countintegeroptionalQueries to generate when keywords is omitted, 1–4 (default 3).
Why this API

Built for builders

All four major engines

Every query is run through ChatGPT, Claude, Gemini, and Perplexity, with per-engine "cited / not cited" and citation position.

Real niche queries

Skip vanity brand-name lookups — it generates the natural questions a user actually asks an AI assistant in your niche, so the score reflects organic AI visibility.

Citation sources

For every query you get the deduped list of URLs the engines cited — see exactly who AI is recommending and where the opportunities are.

Transparent

Pricing & limits

Price

$0.10 per keyword

100 credits per keyword

Billed from one credit wallet. Failed upstream calls are refunded automatically.

Rate limits

  • Free10 / min
  • SEO+60 / min
  • Agency120 / min

Surfaced as X-RateLimit-* headers on every response.

Errors

Every non-2xx shares one envelope with a machine-readable code, a retryable flag, and a requestId for tracing.

Send an Idempotency-Key header to retry POSTs safely without double-charging.

The new front line of search is AI answers. This is the direct way to measure your generative-engine visibility across all four major assistants in one call.

Get your API keyBrowse all APIs

Last updated:

FAQ

AI Visibility API FAQ

Common questions about the AI Visibility API — pricing, auth, and what it returns.

  • What does the AI Visibility API measure?

    For a set of niche queries, it asks the four major AI assistants — ChatGPT, Claude, Gemini, and Perplexity — and reports whether each one cites your domain, at what position, and an aggregate visibility score. It also returns the third-party URLs each engine cited so you can see who AI recommends.

  • How is it priced?

    One hundred credits per keyword, which is $0.10 per keyword at the standard rate. If you request three queries the call costs 300 credits. The charge is fully refunded if every engine fails to respond.

  • Do I have to supply the queries?

    No. If you omit keywords, the API generates real, natural-language niche queries for your domain (1–4, default 3). You can also pass your own keywords array to test specific questions.

  • Why generate queries instead of using my brand name?

    Asking an AI about your brand by name produces a vanity result — it just repeats the name you gave it. Testing real niche questions measures whether AI recommends you organically, which is what actually drives discovery.

  • Which scope is required?

    The ai:read scope on your API key, sent in the X-API-Key header.