seo/
google-organic-serp

Получайте актуальную страницу результатов Google для одного запроса и рынка: целевые URL, заголовки, позиции, типы элементов и детали результатов в нормализованных записях.

Google Organic SERP API

Снимок выдачи в реальном времени
Выбор устройства
Разные элементы выдачи
0,1 кредита за результат
Готово
Готово

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

README

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

Google Organic SERP

Страницы органической выдачи Google объединяют ранжированные ссылки с другими видимыми элементами: расширенными сниппетами, вопросами, локальными результатами и видео. Целевые адреса, позиции, типы элементов и детали отображения помогают фиксировать снимки позиций, анализировать структуру выдачи и сравнивать результаты по устройствам или рынкам.

Возможности Google Organic SERP API

  • Снимок рынка по одному запросуВыполняет один поисковый запрос с явно заданными рынком, языком и устройством (desktop или mobile), чтобы получить сопоставимую страницу результатов на определенный момент.
  • Поля позиций и целевых адресовВозвращает доступные целевые URL, отображаемые заголовки, позиции в группе, абсолютные позиции и номера страниц выдачи в нормализованных полях.
  • Охват разных элементов выдачиСохраняет органические ссылки и другие возвращенные типы результатов, а extra.type указывает, какой элемент представляет каждая запись.
  • Полный контекст элементаХранит весь объект с полями конкретного элемента в extra, чтобы домены, сниппеты, хлебные крошки, изображения и атрибуты расширенных результатов были доступны, если они есть.

Параметры Google Organic SERP API

ПараметрыОбязательныйОписание
queryОбязательныйОбязательный непустой поисковый запрос. Одна задача принимает один запрос.
location_codeНеобязательныйПоложительный числовой код рынка. В песочнице по умолчанию используется 2840 — США.
location_nameНеобязательныйНеобязательное название поискового рынка вместо location_code. Если оно заполнено, оно имеет приоритет над location_code.
language_codeНеобязательныйКод языка поиска длиной от 2 до 10 символов. В песочнице по умолчанию используется en.
languageНеобязательныйНеобязательное название языка поиска вместо language_code. Если оно заполнено, оно имеет приоритет над language_code.
deviceНеобязательныйУстройство для поиска: desktop или mobile.
results_limitНеобязательныйЗапрошенная глубина выдачи от 1 до 700. Это верхний предел, и он не гарантирует такое же число элементов после разворачивания.

Как использовать Google Organic SERP API

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

  1. Выберите один непустой query, location_code, language_code, device и results_limit от 1 до 200.
  2. Отправьте данные методом POST на /v1/seo/google-organic-serp и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
  4. Читайте data.results.items, а затем запрашивайте возвращенный next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/seo/google-organic-serp" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"keyword research","location_code":2840,"language_code":"en","device":"desktop","results_limit":10}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

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

  • Снимки текущих позиций: Используйте целевые URL вместе с rank.group, rank.absolute, rank.page и collected_at, чтобы фиксировать, где возвращенные страницы появляются по заданному запросу.
  • Сравнение по устройствам и рынкам: Отправляйте одинаковые запросы с контролируемыми значениями device, location_code и language_code, чтобы сравнивать целевые адреса и позиции в разных контекстах.
  • Анализ структуры выдачи: Изучайте extra.type и поля конкретных элементов, чтобы отличать ранжированные ссылки от вопросов, сниппетов, локальных результатов, видео и других элементов страницы.

Практические советы по Google Organic SERP API

  • Не меняйте query, location_code и language_code при сравнении desktop и mobile, чтобы устройство оставалось единственной намеренно изменяемой переменной.
  • Указывайте results_limit не больше 200, хотя проверка маршрута принимает и большие значения: глубина расширенных результатов в реальном времени ограничена 200.
  • Проверяйте extra.type, прежде чем читать ключи конкретного элемента, и допускайте отсутствие url и значений rank у элементов, которые их не содержат.
  • Считайте rank.page номером страницы выдачи; для пагинации сохраненных записей результатов SocQ отдельно используйте next_cursor.
  • Храните extra как гибкий объект: набор доступных ключей зависит от типа элемента выдачи и может меняться.

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

  • Keyword Difficulty API — Сравнивайте сложность продвижения в органической выдаче для пакета ключевых слов и получайте нормализованную оценку для каждого доступного слова.
  • Keyword Overview API — Дополняйте пакет ключевых слов доступными данными о спросе, конкуренции в платной выдаче, сложности, ежемесячной частотности и интенте.
  • Keyword Search Volume API — Измеряйте известные ключевые слова: доступная частотность, CPC, конкуренция в платной выдаче и история частотности по месяцам.
  • Related Keywords API — Проходите по цепочкам связанных запросов от одного исходного запроса с контролем глубины, доступными метриками ключевых слов, интентом и полными исходными строками.
  • Search Intent API — Определяйте основной и дополнительный поисковый интент для пакета ключевых слов с сохранением исходных вероятностей и полных записей.
  • Google News API — Собирайте статьи Google News по запросу, начиная с главных новостей: заголовок, издание, прямая ссылка на статью, фрагмент и время публикации.

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

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

Google Organic SERP API — FAQ

Google Organic SERP API — это программный интерфейс для получения одной актуальной страницы результатов Google по запросу, коду рынка, коду языка и устройству. Он возвращает нормализованные целевые адреса, заголовки, позиции, типы элементов и полные детали каждого элемента.

Песочница принимает один обязательный query, а также location_code, language_code, device и results_limit. Она использует коды рынка и языка, чтобы избежать неоднозначных сочетаний с альтернативами по названию.

Нет. Страница расширенных результатов в реальном времени может содержать органические ссылки, расширенные сниппеты, вопросы, локальные результаты, видео и другие видимые элементы; проверяйте extra.type у каждой записи.

Да. Некоторые элементы страницы выдачи не содержат целевого URL или всех значений позиции, поэтому клиентам следует допускать null в url, rank.group, rank.absolute и rank.page.

Каждый возвращенный нормализованный элемент выдачи стоит 0,1 кредита SocQ. За пустой набор результатов плата не взимается, а глубина запроса — это оценка, а не гарантированное число возвращенных записей.