Если вы занимаетесь оптимизацией под генеративные поисковые системы (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}.
Новые эндпоинты AI Search
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