ai-search/
llm-mentions

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

LLM Mentions API

AI Overviews и ChatGPT
Полный текст ответа
Процитированные источники
Объем ИИ-поиска
40 кредитов за запрос + 0,5 кредита за результат
Готово
Готово

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

README

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

LLM Mentions

Упоминание в LLM — это вопрос, отвечая на который Google AI Overviews или ChatGPT цитирует домен или употребляет ключевое слово; запись хранит полный ответ, процитированные страницы, модель, давшую ответ, и то, сколько раз вопрос задают в месяц, а для ChatGPT еще и названные бренды и выполненные дополнительные поиски. Если читать такие ответы рядом, видно, по каким вопросам бренд попадает к пользователям ИИ, на какие источники опираются модели и где продукт описан неточно, — это основа для GEO-аудита, контент-планирования и сравнения с конкурентами.

Возможности LLM Mentions API

  • Отправная точка — домен или ключевое словоtarget ищет ответы, цитирующие домен вроде notion.so, а query — ответы, где встречается ключевое слово или название бренда, так что можно отслеживать и свой сайт, и то, как говорят о вашей категории.
  • Ответ в том виде, в каком его читает пользовательanswer хранит весь ответ в Markdown с заголовками, списками и ссылками в тексте, чтобы цитировать или проверять формулировки модели.
  • Каждая процитированная страницаВ sources для каждой страницы есть позиция, заголовок, URL, домен, название сайта и фрагмент текста — видно, чей контент сформировал ответ.
  • Спрос за каждым вопросомai_search_volume оценивает, сколько раз в месяц задают вопрос, поэтому упоминания в популярных вопросах легко отличить от редких.
  • Бренды, веб-результаты и дополнительные поиски в ChatGPTПри platform chat_gpt в brands по порядку перечислены названные бренды, в search_results — страницы, которые просматривал ChatGPT, а в fan_out_queries — выполненные им дополнительные поиски.
  • Когда ответ был зафиксированfirst_seen_at и last_seen_at датируют каждый ответ и помогают отделить давние ответы от новых.

Параметры LLM Mentions API

ПараметрыОбязательныйОписание
targetОбязательный (хотя бы один)Домен, который отслеживается в ответах ИИ, например hubspot.com, без пути страницы. Передайте target или query.
queryОбязательный (хотя бы один)Ключевое слово или название бренда для отслеживания в ответах ИИ, например crm software, до 250 символов. Передайте 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.
results_limitНеобязательныйМаксимальное число ответов от 1 до 1000. По умолчанию 100.

Как использовать LLM Mentions API

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

  1. Отправьте {"target": "notion.so", "platform": "google", "results_limit": 100} методом POST на /v1/ai-search/llm-mentions.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Читайте ответы из results.items и запрашивайте следующую страницу через results.next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/ai-search/llm-mentions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":"notion.so","platform":"google","results_limit":100}'

Сценарии использования LLM Mentions API

  • Аудит присутствия домена в ответах ИИ: Укажите свой домен в target, отсортируйте по ai_search_volume и прочитайте answer и sources — станет видно, какие популярные вопросы вас цитируют и как вас описывают.
  • Поиск страниц, которым доверяет ИИ в категории: Передайте ключевое слово категории в query и посчитайте домены и URL из sources, чтобы составить список статей для сотрудничества или для обгона.
  • Сравнение брендов в ответах ChatGPT: С platform chat_gpt запросите свой бренд и конкурентов и сравните brands вместе с позициями на одних и тех же вопросах.
  • Планирование контента по пропущенным темам: Соберите question и fan_out_queries из ответов, где вашего бренда нет, и превратите их в задания на страницы, которые модели смогут цитировать.

Практические советы по LLM Mentions API

  • Проверяйте бренд в двух формах — домен в target и название в query: цитирование сайта и упоминание имени дают разные наборы ответов.
  • Получайте нужные ответы одним запросом с большим results_limit, поскольку базовые 40 кредитов списываются за каждый запрос.
  • Сохраняйте id каждой строки и при следующем запуске сравнивайте last_seen_at, чтобы отличать новые ответы от уже просмотренных.

Помимо LLM Mentions API, используйте эти API, когда нужен другой тип публичных данных AI Search.

  • AI Search Visibility API — Измеряйте, как часто ответы ИИ упоминают домен или ключевое слово: объем ИИ-поиска, самые цитируемые домены и бренды, которые ChatGPT называет рядом.
  • LLM Top Sources API — Ранжируйте 10 доменов или страниц, которые AI Overviews и ChatGPT чаще всего цитируют по ключевому слову или домену, по упоминаниям и объему ИИ-поиска.
  • Google AI Mode API — Получайте полный ответ Google AI Mode на поисковый запрос в Markdown со всеми процитированными источниками для любой страны и языка.

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

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

LLM Mentions API — FAQ

LLM Mentions API по одному домену или ключевому слову возвращает ответы Google AI Overviews и ChatGPT, которые цитируют этот домен или упоминают это слово. В каждой строке — вопрос, полный ответ, процитированные источники, модель и месячный объем ИИ-поиска по вопросу.

При platform google читаются Google AI Overviews на выбранном рынке, при chat_gpt — ответы ChatGPT для США на английском.

target с доменом находит ответы, цитирующие этот сайт; query с ключевым словом или названием бренда — ответы, где оно упомянуто. В одном запросе используется что-то одно.

Названия брендов, просмотренные веб-результаты и дополнительные поиски фиксируются для ответов ChatGPT, поэтому установите platform в chat_gpt.

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