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
Отправьте поисковый запрос и прочитайте ответ с источниками.
- Отправьте {"query": "best crm for startups", "location_code": 2840, "language_code": "en"} методом POST на /v1/ai-search/google-ai-mode.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Прочитайте единственную строку в 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.
Связанные API
Помимо 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 чаще всего цитируют по ключевому слову или домену, по упоминаниям и объему ИИ-поиска.