Ко всем API
Данные ИИ-поиска

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 SourcesGoogle AI Mode API
Входные данныеДомен в target или ключевое слово в queryОдин запрос в query
Источники ответовAI Overviews или ChatGPT через platform chat_gptGoogle AI Mode
РезультатОтветы, строки метрик или десять самых цитируемых источниковОдин полный ответ со всеми источниками
Для чего подходитДоля в ответах ИИ, конкуренты и цели для цитированияЧто AI Mode сообщает людям на конкретном рынке
Тарифы40 кредитов за запрос плюс 0,5 за строку2 кредита за запрос

Как работает AI Search API

Все AI Search API используют один и тот же асинхронный процесс задач.

  1. 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. 2. Следите за задачей

    Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.

  3. 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 с нормализованными полями идентичности, карьеры, компании, контента, вовлеченности и вакансии.