AI-поискGEOупоминания в LLMGoogle AI Modeруководство по API

API AI-поиска: упоминания в LLM, видимость в ИИ-ответах и ответы Google AI Mode

Четыре новых эндпоинта SocQ AI Search возвращают ответы AI Overviews и ChatGPT, которые ссылаются на домен, долю голоса в ИИ-ответах, самые цитируемые источники и полные ответы Google AI Mode.

SocQОбновлено 19 ноября 2026 г.8 мин чтения

Если вы занимаетесь оптимизацией под генеративные поисковые системы (GEO), вам нужны данные о том, что говорят ИИ-ответы: какие вопросы ссылаются на ваш домен, как часто ваш бренд появляется рядом с конкурентами, каким сайтам ИИ доверяет в вашей категории и что пишет Google AI Mode в ответ на запрос. 2026-11-17 SocQ добавил для этого четыре эндпоинта на новой платформе AI Search. В этом руководстве описано, что возвращает каждый из них, как выглядит запрос, сколько он стоит и когда его использовать.

Коротко: отправьте домен (target) или ключевое слово (query) в POST /v1/ai-search/llm-mentions, /llm-brand-metrics или /llm-top-mentioned, чтобы получить ответы AI Overviews или ChatGPT. Отправьте поисковый запрос в POST /v1/ai-search/google-ai-mode, чтобы получить один ответ AI Mode с источниками. Результаты забирайте через опрос GET /v1/tasks/{task_id}.

1 кредит SocQ = $0.005.

ЭндпоинтЧто возвращаетЦена
LLM Mentions APIОдна строка на каждый ИИ-ответ, который ссылается на домен или упоминает ключевое слово: вопрос, полный ответ в Markdown, цитируемые источники и объем AI-поиска40 кредитов ($0.20) за запрос + 0.5 кредита ($0.0025) за ответ
AI Search Visibility APIОбщее число ИИ-ответов, упоминающих домен или ключевое слово, затем разбивки по цитируемым доменам, доменам из веб-результатов и (в ChatGPT) брендам и категориям брендов40 кредитов ($0.20) за запрос + 0.5 кредита ($0.0025) за строку
LLM Top Sources APIДесять доменов или страниц, которые ИИ-ответы чаще всего цитируют по ключевому слову или домену, ранжированные по числу упоминаний40 кредитов ($0.20) за запрос + 0.5 кредита ($0.0025) за каждый домен или страницу в рейтинге
Google AI Mode APIПолный ответ Google AI Mode на поисковый запрос в Markdown со всеми цитируемыми источниками2 кредита ($0.01) за запрос

Для трех LLM-эндпоинтов базовые 40 кредитов списываются и тогда, когда ничего не найдено.

Аутентификация и асинхронные задачи

Все запросы к SocQ аутентифицируются API-ключом в заголовке Authorization, и один и тот же заголовок используется для отправки задачи, проверки статуса и получения результатов:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Каждый сбор данных выполняется как фоновая задача:

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

Ответ на отправку содержит data.task_id и data.status. Опрашивайте эндпоинт задачи по этому ID:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Когда status равен succeeded, ответ содержит первую страницу нормализованных записей в data.results.items. По умолчанию limit равен 50, максимум 500. Если has_more равно true, передайте results.next_cursor как cursor, чтобы прочитать следующую страницу. Пока задача находится в состоянии queued, running или failed, эндпоинт возвращает метаданные задачи без results.

Необязательный callback_url в теле запроса заставляет SocQ отправить один POST со сводкой задачи после ее завершения; сами записи читайте через GET /v1/tasks/{task_id}. Тайм-аут на стороне клиента не отменяет задачу, поэтому продолжайте с тем же ID задачи, а не платите за дубликат. 402 означает недостаточно кредитов; 429 означает, что ключ достиг лимита запросов или кредитов.

LLM Mentions API: ответы, которые ссылаются на вас

LLM Mentions API перечисляет вопросы, в которых Google AI Overviews или ChatGPT ссылаются на ваш домен или в ответе которых появляется ваш бренд или ключевое слово. Укажите домен в target или ключевое слово в query, но не оба сразу. platform принимает значение google (AI Overviews, по умолчанию) или chat_gpt, который отслеживается для США на английском языке. По умолчанию results_limit равен 100, допустимы значения от 1 до 1,000.

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
  }'

Каждая строка содержит один вопрос и ответ. Поля, которые понадобятся чаще всего:

  • question и answer: вопрос и полный ответ в Markdown.
  • ai_search_volume: оценка того, сколько раз в месяц задают этот вопрос.
  • sources: цитируемые страницы с position, title, url, domain, source и text.
  • search_results и brands: веб-результаты, которые просмотрел ИИ, и бренды, которые он назвал (только ChatGPT).
  • fan_out_queries: уточняющие поиски, которые выполнил ИИ.
  • first_seen_at и last_seen_at: когда ответ был зафиксирован впервые и в последний раз.

Используйте его, чтобы проверить покрытие GEO, найти страницы, которым ИИ доверяет в вашей нише, или поймать ответы, в которых ваш продукт описан неверно. 100 ответов стоят 90 кредитов ($0.45). Все поля описаны в документации LLM Mentions.

AI Search Visibility API: доля голоса в ИИ-ответах

AI Search Visibility API — это отчет о доле голоса. Первая строка — общее число ИИ-ответов, которые упоминают ваш домен или ключевое слово, и стоящий за ними месячный объем AI-поиска. Далее идут до 10 строк для каждой разбивки: домены, которые ответы цитируют чаще всего, домены из веб-результатов, которые просмотрел ИИ, и, для chat_gpt, бренды и категории брендов, названные в тех же ответах.

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"
  }'

У каждой строки есть dimension (total, source_domain, search_result_domain, brand или brand_category), name, rank внутри своего измерения, mentions_count и ai_search_volume. Запустите отчет для своего бренда и двух конкурентов, чтобы сравнить, кого рекомендует ИИ. Отчет ChatGPT с итоговой строкой и четырьмя полными разбивками — это 41 строка, или 60.5 кредита ($0.3025). Справочник полей: документация AI Search Visibility.

LLM Top Sources API: сайты, которые ИИ цитирует по теме

LLM Top Sources API отвечает на другой вопрос: какие сайты цитирует ИИ, когда люди спрашивают о вашей категории? Передайте ключевое слово в query или домен в target. Установите content_type в domains (по умолчанию) или pages. По умолчанию results_limit равен 10, и это же максимум.

curl -X POST "https://api.socq.ai/v1/ai-search/llm-top-mentioned" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "crm software",
    "platform": "google",
    "content_type": "domains"
  }'

Строки имеют ту же структуру метрик, что и в AI Search Visibility, а dimension равен domain или page. Режим страниц — готовый шорт-лист для digital PR-аутрича. Десять строк рейтинга стоят 45 кредитов ($0.225). Подробности: документация LLM Top Sources.

Google AI Mode API: один полный ответ с источниками

AI Mode — это диалоговая вкладка в Google Поиске, которая пишет полный ответ вместо списка ссылок. Google AI Mode API принимает query и возвращает этот ответ в Markdown, а также дедуплицированный список цитируемых источников. По умолчанию используются США (location_code 2840) и английский язык (language_code en); меняйте их, чтобы сравнивать ответы в разных странах и на разных языках.

curl -X POST "https://api.socq.ai/v1/ai-search/google-ai-mode" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "best crm for startups",
    "location_code": 2840,
    "language_code": "en"
  }'

Каждый запрос возвращает одну строку с query, answer, references (позиция, заголовок, URL, домен, источник и фрагмент), location_code, language_code и url страницы AI Mode. При цене 2 кредита ($0.01) за поиск это недорогой способ проверить, входят ли ваши страницы в источники по важным для вас запросам. См. документацию Google AI Mode.

Какой эндпоинт выбрать

  • «Какие ИИ-ответы упоминают нас и что в них говорится?» Используйте LLM Mentions.
  • «Насколько мы заметны в ИИ-ответах по сравнению с конкурентами?» Используйте AI Search Visibility, по одному разу на домен.
  • «На какие сайты стоит выходить с питчами, чтобы ИИ нас цитировал?» Используйте LLM Top Sources с content_type: "pages".
  • «Что говорит Google AI Mode по этому конкретному запросу на этом рынке?» Используйте Google AI Mode.

Типичный порядок: LLM Top Sources для категории, AI Search Visibility для вас и конкурентов, затем LLM Mentions, чтобы прочитать ответы за цифрами. Для классических позиций в выдаче см. платформу SEO.

FAQ

Что такое API AI-поиска?

Это API, который возвращает то, что говорят ИИ-системы ответов, а не список ссылок. Версия SocQ охватывает ответы AI Overviews и ChatGPT, упоминающие домен или ключевое слово, метрики видимости, самые цитируемые источники и полные ответы Google AI Mode.

Какие ИИ-платформы поддерживаются?

Три LLM-эндпоинта принимают platform со значением google (AI Overviews, по умолчанию) или chat_gpt. ChatGPT отслеживается для США на английском языке. Строки брендов и категорий брендов, веб-результаты ИИ и списки брендов доступны только для chat_gpt.

Можно ли отправить домен и ключевое слово в одном запросе?

Нет. LLM Mentions, AI Search Visibility и LLM Top Sources принимают либо target (домен), либо query (ключевое слово), но не оба сразу. Если нужны оба среза, выполните два запроса.

Списываются ли кредиты, если ИИ-ответ не найден?

Да, для трех LLM-эндпоинтов базовые 40 кредитов списываются и тогда, когда ничего не найдено; кредиты за результаты начисляются только за возвращенные строки. Google AI Mode стоит 2 кредита за запрос.

Сколько стоит типичный GEO-аудит?

Один запрос LLM Top Sources (45 кредитов), три отчета о видимости в ChatGPT (до 60.5 кредита каждый) и один запрос LLM Mentions на 100 ответов (90 кредитов) в сумме дают не более 316.5 кредита, около $1.58. Цены могут меняться, поэтому сначала проверьте страницы эндпоинтов.

AI SEARCH API

Проверить сценарий на публичном URL AI Search

Отправляйте публичные входные данные и получайте нормализованные записи с отслеживаемым источником.

API для AI Search