Brand share of voice in AI answers

Embed

<a href="https://seolyticize.com/docs/ref-get-ai-brand-mentions"><img src="https://seolyticize.com/docs/_api/public/orgs/71cb2b7a-a719-4003-b3ea-6321dc1db8ab/spaces/3bf2dbf7-3faa-473c-ba3b-30588f5f8de4/pages/c4526aab-f3aa-4cdf-bd92-2c75152fb6dc/social-card.svg?v=3e7ae33eec8b" alt="Brand share of voice in AI answers" width="600" height="315"></a>

POSThttps://seolyticize.com/api/v1/tools/get_ai_brand_mentions

How often AI answers (Google AI Overviews, or ChatGPT) mention or cite each brand — the client and up to 9 competitors, each given as domains and/or brand keywords — across DataForSEO's database of real AI answers, with share of voice, the AI search volume behind the mentions, and the domains cited. No question tracking needed; works for any brand. Answers 'what is our share of voice in AI search' and 'who do AI answers recommend'. Rows carry source: dataforseo (real users' prompts, with AI search volume) or sampled (the client's tracked questions asked by Seolyticize, no volume); the two are never summed. For platforms other than google and chat_gpt only sampled rows exist and the call is free. A paid lookup on the client's account unless anyone read the same thing recently (spend says which); quote it with estimate_cost. (about $0.10 a call)

Parameters

Idempotency-Keystringheader

Any unique string, up to 200 characters. A retry with the same key and body is answered from the first answer (Idempotent-Replayed: true) for a day, so it never buys or writes twice; the same key with another body is refused.

Request body

application/json

clientIdstringrequired

brandsobject[]required

Show child parameters

namestringrequired

domainsstring[]

= []

keywordsstring[]

= []

platformstring

google: AI Overviews; chat_gpt: ChatGPT (US English only) — both from DataForSEO's database plus Seolyticize's samples. claude, gemini, perplexity, copilot, grok, meta_ai, deepseek, ai_mode: Seolyticize's own sampled answers only (free).

includeSampledboolean

Add Seolyticize's own sampled answers to the client's tracked questions (run_ai_visibility_check), tagged source sampled.

= true

sampledDaysinteger

= 90

locationCodeinteger

Default: the client's project (2840 United States).

= null

languageCodestring

Default: the client's project.

= null

maxCostMicrosinteger

Optional spending limit for this call, in micro-USD (1,000,000 = $1). A purchase that would take the call past it is refused before anything is bought. Pass the estimate from estimate_cost, or what the user agreed to spend.

dryRunboolean

True to buy nothing and get the quote instead: what the call would cost at most and what it would buy.

{
  "clientId": "string",
  "brands": [
    {
      "name": "string",
      "domains": [],
      "keywords": []
    }
  ],
  "platform": "google",
  "includeSampled": true,
  "sampledDays": 90,
  "locationCode": null,
  "languageCode": null,
  "maxCostMicros": 0,
  "dryRun": true
}

Code samples

cURL

curl -X POST "https://seolyticize.com/api/v1/tools/get_ai_brand_mentions" \
  -H "Authorization: Bearer $SEOLYTICIZE_API_KEY" \
  -H "Idempotency-Key: <value>" \
  -H "Content-Type: application/json" \
  -d '{"clientId":"string","brands":[{"name":"string","domains":[],"keywords":[]}],"platform":"google","includeSampled":true,"sampledDays":90,"locationCode":null,"languageCode":null,"maxCostMicros":0,"dryRun":true}'

TypeScript

Python

PHP

Ruby

Java

Responses

200 The tool's result under data, and its meta.

Example

{
  "data": {},
  "meta": {
    "requestId": "string",
    "costMicros": 0,
    "cached": true,
    "cachedFrom": "string",
    "dataAsOf": "string",
    "sources": [
      "string"
    ],
    "partial": true,
    "next": [
      {
        "tool": "string",
        "args": {},
        "why": "string"
      }
    ],
    "nextCursor": "string",
    "dryRun": true
  }
}

Schema

datarequired

metaobjectrequired

Beside every answer: what it cost, whether it came from cache, how fresh it is, whether it is complete, and what to call next.

Show child parameters

requestIdstringrequired

costMicrosintegerrequired

Charged by this call, micro-USD (1,000,000 = $1).

cachedbooleanrequired

True when nothing was bought.

cachedFromstring

When the oldest cached answer used was bought.

dataAsOfstring

sourcesstring[]

partialbooleanrequired

True when the data is incomplete: a running crawl, unfinished days, unread pages.

nextobject[]required

Show child parameters

toolstring

argsobject

whystring

nextCursorstring

Pass as cursor for the next page.

dryRunboolean

Headers

X-RateLimit-Limitinteger

Requests this key may make per window.

X-RateLimit-Remaininginteger

Requests left in the current window.

X-RateLimit-Resetinteger

Seconds until the current window resets.

X-Request-Idstring

The id to quote about this request.

400 The body was not JSON or did not match the tool's input schema.

Example

{
  "error": "string",
  "code": "string",
  "next": "string",
  "requestId": "string"
}

Schema

errorstringrequired

A sentence written for the caller. Internal failures are reduced to 'The request could not be completed.' and never carry detail.

codestring

A stable snake_case reason to branch on; GET /api/v1/errors lists them all.

nextstring

The call or step that fixes it, when there is one.

requestIdstring

Quote it when asking about a failure.

Headers

X-RateLimit-Limitinteger

Requests this key may make per window.

X-RateLimit-Remaininginteger

Requests left in the current window.

X-RateLimit-Resetinteger

Seconds until the current window resets.

401 No key, or a key that is unknown or revoked.

Same as 400 · POST /api/v1/tools/get_ai_brand_mentions

Headers

WWW-Authenticatestring

403 The key's role does not permit the tool, or the key may not reach the named client.

Same as 400 · POST /api/v1/tools/get_ai_brand_mentions

Headers

X-RateLimit-Limitinteger

Requests this key may make per window.

X-RateLimit-Remaininginteger

Requests left in the current window.

X-RateLimit-Resetinteger

Seconds until the current window resets.

404 No tool by that name.

Same as 400 · POST /api/v1/tools/get_ai_brand_mentions

Headers

X-RateLimit-Limitinteger

Requests this key may make per window.

X-RateLimit-Remaininginteger

Requests left in the current window.

X-RateLimit-Resetinteger

Seconds until the current window resets.

409 A request with this Idempotency-Key is still running.

Same as 400 · POST /api/v1/tools/get_ai_brand_mentions

Headers

X-RateLimit-Limitinteger

Requests this key may make per window.

X-RateLimit-Remaininginteger

Requests left in the current window.

X-RateLimit-Resetinteger

Seconds until the current window resets.

422 A well-formed request the product declined, with the reason — a duplicate name, a plan limit, nothing configured to run.

Same as 400 · POST /api/v1/tools/get_ai_brand_mentions

Headers

X-RateLimit-Limitinteger

Requests this key may make per window.

X-RateLimit-Remaininginteger

Requests left in the current window.

X-RateLimit-Resetinteger

Seconds until the current window resets.

429 This key has used its window.

Same as 400 · POST /api/v1/tools/get_ai_brand_mentions

Headers

X-RateLimit-Limitinteger

Requests this key may make per window.

X-RateLimit-Remaininginteger

Requests left in the current window.

X-RateLimit-Resetinteger

Seconds until the current window resets.

Retry-Afterinteger

Seconds to wait before retrying.

500 The request could not be completed.

Same as 400 · POST /api/v1/tools/get_ai_brand_mentions

Headers

X-RateLimit-Limitinteger

Requests this key may make per window.

X-RateLimit-Remaininginteger

Requests left in the current window.

X-RateLimit-Resetinteger

Seconds until the current window resets.

Updated Nov 4, 2026

Was this page helpful?