Skip to main content
POST
AI Search Visibility API

AI Search Visibility

A share-of-voice report for AI search. One request returns the total number of AI answers that mention your domain or keyword and the monthly search volume behind them, then breaks those answers down: the domains they cite most, the domains in the web results the AI looked at, and on ChatGPT the brands and brand categories named in the same answers. Run it for your brand and two competitors and you have a quick comparison of who AI recommends.
Provide a domain in target or a keyword in query, not both. platform is google (the default) or chat_gpt (tracked for the United States in English); brand rows appear on chat_gpt. Rows are the total followed by up to 10 entries for each breakdown. Each request costs 40 credits plus 0.5 credits per row; the 40 credits also apply when nothing is found.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Provide a domain in target or a keyword in query. Rows give the total mentions and AI search volume, then the most cited source domains, the domains in the answers' search results, and, on chat_gpt, the brands and brand categories named alongside it.

query
string
required

Keyword or brand name to track in AI answers, such as crm software. Give either target or query.

Minimum string length: 1
callback_url
string<uri>
language
string
Minimum string length: 1
language_code
string
Required string length: 2 - 10
location_code
integer

Search market location code.

Required range: x >= 1
location_name
string

Search market location name.

Minimum string length: 1
platform
enum<string>
default:google

AI answers to read: google (AI Overviews) or chat_gpt (ChatGPT, tracked for the United States in English).

Available options:
chat_gpt,
google
Minimum string length: 1
target
string

Domain to track in AI answers, such as hubspot.com. Give either target or query.

Minimum string length: 1

Response

Task accepted

code
integer
data
object