AI Search Visibility
Видимость в ИИ-поиске показывает, какое место бренд занимает в ответах, сгенерированных ИИ: сколько ответов Google AI Overviews или ChatGPT его упоминают или цитируют, какой месячный спрос стоит за этими вопросами, на какие сайты опираются ответы и какие еще бренды называются в том же контексте. Если измерять её параллельно для бренда и конкурентов, видно, кого ИИ рекомендует в категории, какие издания влияют на эту рекомендацию и растет ли видимость после работы с контентом или PR.
Возможности AI Search Visibility API
- Один итог по всему присутствиюСтрока total содержит mentions_count — число ответов ИИ, которые упоминают или цитируют домен или ключевое слово, — и ai_search_volume, суммарный месячный спрос по их вопросам.
- Домены, которые цитируют ответыСтроки source_domain ранжируют 10 сайтов, которые эти ответы цитируют чаще всего, и показывают, какие издания формируют то, что ИИ говорит о вас.
- Домены из веб-результатов, прочитанных ИИСтроки search_result_domain ранжируют сайты из веб-результатов, которые ИИ просмотрел перед ответом, — по сути список чтения, стоящий за ответами.
- Бренды и категории рядом с вамиНа chat_gpt строки brand и brand_category перечисляют бренды и категории товаров из тех же ответов — прямо видно, с кем вас сравнивают.
- Объект измерения — домен или ключевое словоИзмеряйте сайт через target, а название продукта, категорию или тему — через query, в AI Overviews или в ChatGPT.
Параметры AI Search Visibility API
| Параметры | Обязательный | Описание |
|---|---|---|
target | Обязательный (хотя бы один) | Домен для измерения, например hubspot.com, без пути страницы. Передайте target или query. |
query | Обязательный (хотя бы один) | Ключевое слово, название бренда или тема для измерения, например crm software. Передайте target или query. |
platform | Необязательный | google читает Google AI Overviews и используется по умолчанию; chat_gpt читает ответы ChatGPT для США на английском и добавляет строки брендов. |
location_code | Необязательный | Код локации рынка. По умолчанию 2840 (США) — это и рынок ответов chat_gpt. |
location_name | Необязательный | Название рынка вместо location_code. Если заполнено, используется вместо location_code. |
language_code | Необязательный | Код языка ответов. По умолчанию en — это и язык ответов chat_gpt. |
language | Необязательный | Название языка вместо language_code. Если заполнено, используется вместо language_code. |
Как использовать AI Search Visibility API
Отправьте домен или ключевое слово и прочитайте итог и каждую разбивку.
- Отправьте {"target": "hubspot.com", "platform": "chat_gpt"} методом POST на /v1/ai-search/llm-brand-metrics.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте results.items, группируя по dimension: сначала total, затем source_domain, search_result_domain, brand и brand_category в порядке rank.
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
- Сравнение доли голоса в ИИ с конкурентами: Запросите на одной платформе свой домен и домены двух конкурентов и сравните mentions_count и ai_search_volume в строках total — станет видно, кого ИИ упоминает чаще.
- Поиск изданий, на которых держится ваше присутствие в ИИ: По строкам source_domain выберите обзорные сайты, СМИ и сообщества для сотрудничества: именно на эти страницы опираются ответы ИИ, когда упоминают вас.
- Отслеживание видимости после запуска или кампании: Регулярно сохраняйте строку total и сравнивайте её до и после запуска продукта, PR-активности или обновления контента.
Практические советы по AI Search Visibility API
- Если нужны строки brand и brand_category, установите platform в chat_gpt; запросы к AI Overviews возвращают итог и разбивки по доменам.
- Сравнивая несколько брендов, держите одинаковыми платформу, рынок и язык, чтобы итоги считались по одному набору ответов.
- Если нужны конкретные страницы, а не домены, вызовите LLM Top Sources API для того же target или query с content_type pages.
- Если в строке total у домена мало упоминаний, запросите и название бренда через query: ответ может назвать бренд, не ссылаясь на его сайт.
Связанные API
Помимо AI Search Visibility API, используйте эти API, когда нужен другой тип публичных данных AI Search.
- LLM Mentions API — Находите ответы AI Overviews и ChatGPT, которые цитируют домен или упоминают ключевое слово, с полным текстом, источниками и объемом ИИ-поиска по вопросу.
- LLM Top Sources API — Ранжируйте 10 доменов или страниц, которые AI Overviews и ChatGPT чаще всего цитируют по ключевому слову или домену, по упоминаниям и объему ИИ-поиска.
- Google AI Mode API — Получайте полный ответ Google AI Mode на поисковый запрос в Markdown со всеми процитированными источниками для любой страны и языка.