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
Отправьте один запрос с кодами рынка и языка и ограниченной глубиной, а затем читайте каждый нормализованный элемент выдачи из завершенной асинхронной задачи.
- Выберите один непустой query, location_code, language_code, device и results_limit от 1 до 200.
- Отправьте данные методом POST на /v1/seo/google-organic-serp и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- Читайте 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 как гибкий объект: набор доступных ключей зависит от типа элемента выдачи и может меняться.
Связанные API
Помимо 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 по запросу, начиная с главных новостей: заголовок, издание, прямая ссылка на статью, фрагмент и время публикации.
- Keywords for Site API
- Keyword Suggestions API
- Ranked Keywords API
- Relevant Pages API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Domain Overview API
- Competitor Domains API
- Traffic Estimate API
- Domain Technologies API
- Whois Lookup API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API