Google SERP Парсер

Создание задачи

Отправьте задачу парсинга Google SERP для получения органических результатов поиска по заданному запросу.

Требует области действия serp:google для вашего API-ключа.

Эндпоинт

POST /api/parsing/v1/serp-google

Тело запроса

ПараметрТипОбязательныйОписание
qstringдаПоисковый запрос
countnumberдаКоличество результатов (мин.: 10, макс.: 100)
hlstringнетКод языка результатов (например, en, ru)
glstringнетКод страны для результатов поиска (например, us, ru) — см. Доступные страны
canonicalLocationNamestringнетМестоположение для локализованных результатов (например, New York,New York,United States) — см. Доступные города
isDesktopbooleanнетЭмуляция десктопного браузера (по умолчанию: true)
aiOverviewbooleanнетПарсинг Google AI Overview (по умолчанию: false)
callbackUrlstringнетURL вебхука для отправки результата по завершении
useragentstringнетПользовательская строка User-Agent (только печатаемые ASCII-символы)
screenResolutionstringнетРазрешение экрана браузера (например, 1920x1080, 360x640)
parsingDomainstringнетПользовательский домен поиска (например, google.de)
takeScreenshotbooleanнетСделать скриншот страницы (по умолчанию: false)
paramsarray of recordsнетДополнительные параметры поиска (например, [{"key": "tbs", "value": "qdr:m"}])

Пример запроса

curl https://app.parsering.com/api/parsing/v1/serp-google \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --data '{
  "q": "купить пиццу",
  "hl": "ru",
  "gl": "ru",
  "canonicalLocationName": "Moscow,Moscow,Russia",
  "count": 10,
  "isDesktop": false
}'

Пример ответа

{
  "id": "abaf4ac3-d9e7-43f2-a414-e7d2ca9ff635",
  "status": "parsing",
  "scope": "serp:google",
  "costCredits": 1,
  "createdAt": "2026-03-20T12:48:05.935Z"
}

Задача обрабатывается асинхронно. Используйте id для опроса результата или укажите callbackUrl для получения вебхука по завершении парсинга.

Следующие шаги