ai-search/
llm-brand-metrics

Считает, сколько ответов Google AI Overviews или ChatGPT упоминают домен или ключевое слово, и возвращает их суммарный объем ИИ-поиска, самые цитируемые домены и бренды, появляющиеся рядом.

AI Search Visibility API

Доля голоса
Цитируемые домены
Бренды рядом с вашим
AI Overviews и ChatGPT
40 кредитов за запрос + 0,5 кредита за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

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

Отправьте домен или ключевое слово и прочитайте итог и каждую разбивку.

  1. Отправьте {"target": "hubspot.com", "platform": "chat_gpt"} методом POST на /v1/ai-search/llm-brand-metrics.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Читайте 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: ответ может назвать бренд, не ссылаясь на его сайт.

Помимо 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 со всеми процитированными источниками для любой страны и языка.

Другие платформы

Объединяйте данные AI Search с публичными данными других поддерживаемых соцсетей.

AI Search Visibility API — FAQ

AI Search Visibility API измеряет, как часто ответы Google AI Overviews или ChatGPT упоминают домен или ключевое слово, и возвращает суммарный объем ИИ-поиска, процитированные и просмотренные домены, а на ChatGPT — бренды и категории, названные рядом.

Одну итоговую строку, затем до 10 строк на каждую разбивку: процитированные домены, домены из результатов поиска, а на chat_gpt — бренды и категории брендов.

mentions_count — число ответов ИИ, которые упоминают или цитируют этот домен, бренд или категорию, а ai_search_volume — суммарный месячный объем ИИ-поиска по вопросам этих ответов.

Каждый запрос стоит 40 кредитов плюс 0,5 кредита за каждую возвращенную строку; 40 кредитов списываются и тогда, когда ни один ответ не упоминает домен или ключевое слово.