ai-search/
llm-brand-metrics

The AI Search Visibility API counts how many AI Overviews or ChatGPT answers mention a domain or keyword, with their combined AI search volume, the domains those answers cite most and the brands that appear beside it.

AI Search Visibility API

Share of voice
Cited domains
Brands named alongside
AI Overviews and ChatGPT
40 credits / request + 0.5 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

AI Search Visibility

AI search visibility is the share of AI-generated answers that bring up a brand: how many answers in Google AI Overviews or ChatGPT mention or cite it, how much monthly search demand sits behind those questions, which sites the answers draw on, and which other brands are named in the same breath. Measured side by side for a brand and its rivals, it shows who AI recommends in a category, which publishers decide that recommendation and whether visibility is rising after content or PR work.

AI Search Visibility API Features

  • One total for the whole footprintThe total row gives mentions_count, the number of AI answers that mention or cite the domain or keyword, and ai_search_volume, the combined monthly demand behind their questions.
  • Domains the answers citesource_domain rows rank the 10 sites those answers cite most, so you can see which publishers shape what AI says about you.
  • Domains in the web results AI readsearch_result_domain rows rank the sites that appeared in the web results the AI looked at before answering, the reading list behind the answers.
  • Brands and categories named beside youOn chat_gpt, brand and brand_category rows list the brands and product categories that show up in the same answers, a direct read on who you are compared with.
  • Domain or keyword as the subjectThe AI Search Visibility API measures a site through target or a product name, category or topic through query, on either AI Overviews or ChatGPT.

AI Search Visibility API Parameters

ParametersRequiredDescription
targetRequired (at least one)Domain to measure, such as hubspot.com, without a page path. Send either target or query.
queryRequired (at least one)Keyword, brand name or topic to measure, such as crm software. Send either target or query.
platformOptionalgoogle reads Google AI Overviews and is the default; chat_gpt reads ChatGPT answers for the United States in English and adds brand rows.
location_codeOptionalMarket location code. Defaults to 2840 (United States), the market covered by chat_gpt answers.
location_nameOptionalMarket name as an alternative to location_code. When filled, it is used instead of location_code.
language_codeOptionalLanguage code of the answers. Defaults to en, the language of chat_gpt answers.
languageOptionalLanguage name as an alternative to language_code. When filled, it is used instead of language_code.

How to Use the AI Search Visibility API

Send a domain or keyword to the AI Search Visibility API and read the total and each breakdown.

  1. POST {"target": "hubspot.com", "platform": "chat_gpt"} to /v1/ai-search/llm-brand-metrics.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. Read results.items, grouping rows by dimension: total first, then source_domain, search_result_domain, brand and brand_category in rank order.
curl -X POST "https://api.socq.ai/v1/ai-search/llm-brand-metrics" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":"hubspot.com","platform":"chat_gpt"}'

AI Search Visibility API Use Cases

  • Benchmark AI share of voice against competitors: Run the AI Search Visibility API on the same platform for your domain and two rivals and compare mentions_count and ai_search_volume on the total rows to see who AI brings up more often.
  • Find the publishers behind your AI presence: Use the source_domain rows to pick the review sites, media and communities worth pitching, since those are the pages AI answers lean on when they mention you.
  • Track visibility after a launch or campaign: Store the AI Search Visibility API total row on a schedule and compare it before and after a product launch, PR push or content refresh.

AI Search Visibility API Pro Tips

  • If you need brand and brand_category rows, set platform to chat_gpt; AI Overviews requests to the AI Search Visibility API return the total and domain breakdowns.
  • When comparing brands, keep platform, market and language identical across requests so the totals measure the same answer pool.
  • If you need the exact pages rather than domains, run the LLM Top Sources API with content_type set to pages for the same target or query.
  • When a total row shows few mentions for a domain, run the brand name as query too, because answers can name a brand without linking its site.

Beyond the AI Search Visibility API, use these APIs when you need a different type of public AI Search data.

  • LLM Mentions API — Find the AI Overviews and ChatGPT answers that cite a domain or mention a keyword, with the full answer, cited sources and each question's AI search volume.
  • LLM Top Sources API — Rank the 10 domains or pages that AI Overviews and ChatGPT cite most for a keyword or domain, by mentions and AI search volume.
  • Google AI Mode API — Get the full Google AI Mode answer for a search in Markdown, with every cited source, for any country and language.

Explore other platforms

Combine AI Search data with public data from other supported social platforms.

AI Search Visibility API — FAQ

AI Search Visibility API measures how often Google AI Overviews or ChatGPT answers mention a domain or keyword, with the combined AI search volume behind them, the domains they cite and look at, and on ChatGPT the brands and categories named alongside it.

One total row, then up to 10 rows for each breakdown: cited domains, search result domains, and on chat_gpt brands and brand categories.

mentions_count is the number of AI answers that mention or cite that domain, brand or category, and ai_search_volume is the combined monthly AI search volume of those answers' questions.

Each request costs 40 credits plus 0.5 credits per row returned, and the 40 credits also apply when no answers mention the domain or keyword.