AI Search API
Отслеживайте, как AI Overviews, ChatGPT и Google AI Mode отвечают на вопросы вашего рынка: ответы, где назван ваш бренд, насколько вы заметны и какие домены и страницы цитируются.
Доступные AI Search API
LLM Mentions API — для самих ответов, AI Search Visibility API — для итогов и разбивок, LLM Top Sources API — для самых цитируемых доменов и страниц, Google AI Mode API — для полного ответа AI Mode на один запрос.
Какие данные ИИ-поиска можно получить?
Начните с домена, бренда или ключевого слова и посмотрите, как с ними обходятся ответы ИИ.
Ответы ИИ, где упоминаетесь вы
Вопрос, полный ответ в Markdown, процитированные источники, веб-результаты, на которые опирался ответ, названные бренды и уточняющие поиски, которые выполнил ИИ.
Метрики видимости
Общее число упоминаний и объем ИИ-поиска для домена или ключевого слова с разбивкой по цитируемым доменам, доменам из выдачи, брендам и категориям брендов.
Самые цитируемые источники
Десять доменов или отдельных страниц, которые ответы ИИ чаще всего цитируют по теме, с числом упоминаний и объемом ИИ-поиска.
Ответы Google AI Mode
Полный ответ AI Mode на один запрос для любой страны и языка со всеми процитированными источниками, их заголовками, доменами и фрагментами.
История ответов
У каждого ответа есть даты первого и последнего появления, поэтому новые упоминания легко отличить от устойчивых.
Отслеживание упоминаний или ответы Google AI Mode
Чтобы измерить бренд по множеству ответов ИИ, используйте API упоминаний; чтобы прочитать один ответ целиком — Google AI Mode.
| Сравнение | LLM Mentions, AI Search Visibility и LLM Top Sources | Google AI Mode API |
|---|---|---|
| Входные данные | Домен в target или ключевое слово в query | Один запрос в query |
| Источники ответов | AI Overviews или ChatGPT через platform chat_gpt | Google AI Mode |
| Результат | Ответы, строки метрик или десять самых цитируемых источников | Один полный ответ со всеми источниками |
| Для чего подходит | Доля в ответах ИИ, конкуренты и цели для цитирования | Что AI Mode сообщает людям на конкретном рынке |
| Тарифы | 40 кредитов за запрос плюс 0,5 за строку | 2 кредита за запрос |
Как работает AI Search API
Все AI Search API используют один и тот же асинхронный процесс задач.
1. Отправьте домен или ключевое слово
Отправьте POST с доменом в target или ключевым словом в query на /v1/ai-search/llm-mentions, /v1/ai-search/llm-brand-metrics или /v1/ai-search/llm-top-mentioned либо запрос на /v1/ai-search/google-ai-mode.
2. Следите за задачей
Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
3. Прочитайте результаты
Ответы, строки метрик или источники находятся в results.items.
Авторизуйтесь API-ключом SocQ и отправьте домен, который хотите отслеживать. Запрос стоит 40 кредитов плюс 0,5 кредита за каждый возвращенный ответ.
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}'
# Poll GET /v1/tasks/{task_id}
# Read the AI answers in results.itemsТипичные сценарии использования AI Search API
Отчеты по GEO
Каждый месяц отслеживайте упоминания и объем ИИ-поиска для своего домена и показывайте, как меняется ваша доля в ответах ИИ.
Сравнение с конкурентами
Сравнивайте бренды, которые появляются рядом с вашим в ответах ChatGPT, и то, как часто называют каждый из них.
Работа с источниками цитирования
Найдите домены и страницы, которые ответы ИИ чаще всего цитируют по вашей теме, и добивайтесь публикаций или ссылок на них.
Планирование контента
Превращайте вопросы и уточняющие поиски за ответами ИИ в задания на страницы, которые ИИ сможет цитировать.
Проверки AI Mode
Смотрите, как Google AI Mode описывает вашу категорию на каждом рынке и входят ли ваши страницы в число его источников.
Правила запросов и тарифы
Эти правила действуют для всех AI Search API.
- LLM Mentions, AI Search Visibility и LLM Top Sources принимают домен в target или ключевое слово в query и по умолчанию читают AI Overviews, а с platform chat_gpt — ChatGPT.
- Данные ChatGPT охватывают США на английском языке и добавляют строки брендов; данные AI Overviews соответствуют рынку из location_code и language_code.
- LLM Mentions возвращает от 1 до 1000 ответов, по умолчанию 100; LLM Top Sources возвращает до 10 доменов или страниц, выбор задается content_type.
- Google AI Mode принимает один запрос в query и возвращает один ответ для выбранной страны и языка.
- LLM Mentions, AI Search Visibility и LLM Top Sources стоят 40 кредитов за запрос плюс 0,5 кредита за строку; Google AI Mode — 2 кредита за запрос.
Частые вопросы об AI Search API
Что такое AI Search API?
AI Search API — это набор эндпоинтов для генеративной оптимизации (GEO): он возвращает ответы AI Overviews, ChatGPT и Google AI Mode о домене, бренде или ключевом слове вместе с цитируемыми источниками и частотой появления бренда.
Какие AI Search API доступны?
LLM Mentions API, AI Search Visibility API, LLM Top Sources API и Google AI Mode API.
Какие ИИ-ассистенты охвачены?
Google AI Overviews и ChatGPT — для упоминаний, видимости и главных источников, Google AI Mode — для полных ответов на запрос.
Что отправлять: домен или ключевое слово?
Отправьте свой домен в target, чтобы найти ответы, которые цитируют ваш сайт, или бренд либо тему в query, чтобы найти ответы с их упоминанием, включая те, где бренд назван без ссылки.
Как тарифицируются запросы AI Search?
LLM Mentions, AI Search Visibility и LLM Top Sources стоят 40 кредитов за запрос плюс 0,5 кредита за каждую возвращенную строку. Google AI Mode стоит 2 кредита за запрос.
Объединяйте данные разных платформ для более полной бизнес-аналитики
Сводите публичные профили, контент и данные о вовлеченности с разных платформ в один рабочий процесс, чтобы отслеживать бренды, авторов и темы и эффективнее вести кросс-платформенный мониторинг и анализ.
Instagram API
Получайте или находите публичные профили и собирайте записи списков подписчиков, подписки, собственные публикации, публикации с отметкой профиля, результаты по хештегам, Reels, расшифровки, комментарии, счетчики аккаунтов, метрики вовлеченности и метаданные медиа в рамках одного асинхронного процесса.
TikTok API
Собирайте поддерживаемые публичные профили TikTok, метаданные видео по прямым ссылкам, комментарии верхнего уровня, результаты поиска видео и видео по заданным хештегам в едином нормализованном асинхронном процессе.
YouTube API
Собирайте поддерживаемые публичные профили каналов YouTube, данные о видео, видео каналов, комментарии, Shorts, результаты поиска по ключевым словам и хештегам и доступные расшифровки в едином нормализованном асинхронном процессе.
Facebook API
Собирайте публичные профили страниц Facebook, публикации, публикации в группах, комментарии, мероприятия по ключевому слову и доступные расшифровки видео с нормализованными полями идентичности, контента, источника, формата, места, медиа, реакций, посещаемости и вовлеченности.
X API
Собирайте публичные профили, списки подписчиков и подписок, посты, ответы, цитаты, пользователей, сделавших ретвит, результаты поиска и текущие тренды. Используйте единообразные результаты для исследований и мониторинга.
LinkedIn API
Получайте публичные данные профилей, компаний, публикаций и вакансий LinkedIn по известным URL с нормализованными полями идентичности, карьеры, компании, контента, вовлеченности и вакансии.



