ai-search/
google-ai-mode

Отправьте поисковый запрос и получите полный ответ, который пишет Google AI Mode, в Markdown, а также список процитированных источников без повторов — с заголовком, URL, доменом и фрагментом.

Google AI Mode API

Полный ответ в Markdown
Процитированные источники
Любая страна и язык
Одна строка на запрос
2 кредита за запрос
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

Google AI Mode

Google AI Mode — это диалоговая вкладка поиска Google, которая вместо списка ссылок пишет полный ответ на запрос и рядом с текстом указывает страницы, на которые опиралась. Если читать такие ответы по важным для бизнеса запросам, видно, что Google рассказывает людям о категории, есть ли сайт среди процитированных источников, каких конкурентов рекомендуют и как меняется ответ от страны к стране и от языка к языку.

Возможности Google AI Mode API

  • Весь ответ с форматированиемanswer хранит ответ AI Mode в Markdown с заголовками, списками и таблицами — его можно сохранить, сравнить или показать.
  • Каждый источник — один разreferences перечисляет процитированные источники без повторов: position, title, url, domain, название сайта и фрагмент, показанный рядом с ответом.
  • Выбор рынкаlocation_code или location_name и language_code или language задают страну и язык поиска, так что один запрос можно прочитать на нескольких рынках.
  • Ссылка на живую страницуurl открывает страницу AI Mode для того же запроса — удобно, чтобы проверить ответ глазами.

Параметры Google AI Mode API

ПараметрыОбязательныйОписание
queryОбязательныйЗапрос к AI Mode, например best crm for startups.
location_codeНеобязательныйКод локации поискового рынка. По умолчанию 2840 (США).
location_nameНеобязательныйНазвание рынка вместо location_code. Если заполнено, используется вместо location_code.
language_codeНеобязательныйКод языка поиска. По умолчанию en.
languageНеобязательныйНазвание языка вместо language_code. Если заполнено, используется вместо language_code.

Как использовать Google AI Mode API

Отправьте поисковый запрос и прочитайте ответ с источниками.

  1. Отправьте {"query": "best crm for startups", "location_code": 2840, "language_code": "en"} методом POST на /v1/ai-search/google-ai-mode.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Прочитайте единственную строку в results.items: answer — текст ответа, references — процитированные страницы.
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"}'

Сценарии использования Google AI Mode API

  • Проверка, цитируются ли ваши страницы: Запустите приоритетные запросы, найдите свой домен в references и запишите позицию и фрагмент, который показывает Google.
  • Какие бренды рекомендует AI Mode: Читайте answer по запросам с намерением покупки, например «лучшие инструменты» в вашей категории, и фиксируйте, какие продукты названы и в каком порядке.
  • Сравнение ответов на разных рынках: Задайте один и тот же запрос с другими настройками страны и языка и локализуйте контент там, где AI Mode рассказывает каждому рынку разное.

Практические советы по Google AI Mode API

  • Если отслеживаете ответы во времени, сохраняйте answer в Markdown и сравнивайте версии: изменения формулировок видны как текстовый diff.
  • Если ответ цитирует страницу конкурента, прочитайте фрагмент в соответствующей записи references, чтобы понять, на какой абзац опирался Google.
  • Если нужны ответы ИИ по множеству вопросов, а не по одному поиску, используйте LLM Mentions API со своим доменом в target.

Помимо Google AI Mode API, используйте эти API, когда нужен другой тип публичных данных AI Search.

  • LLM Mentions API — Находите ответы AI Overviews и ChatGPT, которые цитируют домен или упоминают ключевое слово, с полным текстом, источниками и объемом ИИ-поиска по вопросу.
  • AI Search Visibility API — Измеряйте, как часто ответы ИИ упоминают домен или ключевое слово: объем ИИ-поиска, самые цитируемые домены и бренды, которые ChatGPT называет рядом.
  • LLM Top Sources API — Ранжируйте 10 доменов или страниц, которые AI Overviews и ChatGPT чаще всего цитируют по ключевому слову или домену, по упоминаниям и объему ИИ-поиска.

Другие платформы

Объединяйте данные AI Search с публичными данными других поддерживаемых соцсетей.

Google AI Mode API — FAQ

Google AI Mode API возвращает полный ответ, который AI Mode пишет на поисковый запрос, в Markdown, вместе с процитированными источниками без повторов и их заголовками, URL, доменами и фрагментами.

AI Mode — отдельная диалоговая вкладка поиска Google, которая пишет полный ответ на каждый запрос, и этот API читает именно её; ответы AI Overviews покрывает LLM Mentions API.

Да. По умолчанию это США (2840) и английский (en); их меняют через location_code или location_name и language_code или language.

Каждый запрос стоит 2 кредита и возвращает одну строку с ответом и его источниками.