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
Отправьте домен или ключевое слово и получите по строке на каждый ответ ИИ.
- Отправьте {"target": "notion.so", "platform": "google", "results_limit": 100} методом POST на /v1/ai-search/llm-mentions.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте ответы из 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, чтобы отличать новые ответы от уже просмотренных.
Связанные API
Помимо 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 со всеми процитированными источниками для любой страны и языка.