Google SERP Парсер

Получение результата

Опрашивайте этот эндпоинт для получения результата отправленной задачи парсинга Google SERP.

Эндпоинт

GET /api/parsing/v1/result/serp-google/{requestId}

Повторяйте запрос каждые несколько секунд, пока status не станет "ready" или "cancelled". Пока задача ждёт в очереди или обрабатывается, status — "queued" или "parsing", см. Статусы задачи.

Параметры пути

ПараметрТипОбязательныйОписание
requestIdstring (uuid)даID задачи — поле id из ответа эндпоинта отправки

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

curl https://app.parsering.com/api/parsing/v1/result/serp-google/YOUR_REQUEST_ID \
  --header 'Authorization: Bearer YOUR_API_KEY'

Ответы

В процессе — задача ждёт в очереди ("queued") или обрабатывается ("parsing"):

{
  "status": "parsing",
  "requestId": "abaf4ac3-d9e7-43f2-a414-e7d2ca9ff635"
}

Готово — задача выполнена успешно:

{
  "status": "ready",
  "requestId": "abaf4ac3-d9e7-43f2-a414-e7d2ca9ff635",
  "data": {
    "input": {
      "original_url": "https://www.google.com/search?q=Buy+pizza&hl=en&gl=us"
    },
    "organic": [
      {
        "link": "https://example.com/pizza",
        "rank": 1,
        "title": "Order Pizza Online",
        "description": "Fast delivery. Order now at example.com."
      }
    ],
    "related": [],
    "html": [
      {
        "page": 1,
        "body": "<!doctype html><html>…</html>"
      }
    ]
  },
  "respondedAt": "2026-03-20T10:35:35.866Z"
}

Поля ответа

ПолеТипОписание
statusstring"ready" при завершении
requestIdstringID задачи
data.input.original_urlstringРазрешённый URL поиска Google
data.organicarrayОрганические результаты поиска
data.organic[].ranknumberПозиция в результатах (начиная с 1)
data.organic[].linkstringURL результата
data.organic[].titlestringЗаголовок результата
data.organic[].descriptionstringСниппет результата
data.relatedarrayСвязанные поисковые запросы
data.related[].linkstringСсылка связанного запроса
data.related[].rankstringРанг связанного запроса
data.related[].textstringТекст связанного запроса
data.htmlarrayИсходный HTML каждой загруженной страницы — есть только если в запросе указан parseHTML: true
data.html[].pagenumberНомер страницы (начиная с 1)
data.html[].bodystringHTML страницы
respondedAtstringВременная метка завершения в формате ISO 8601

Важно! Исходный HTML хранится 7 дней после парсинга.
Сохраните результаты на своей стороне, чтобы не потерять их.

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

  • Вебхук — получение результата через callback вместо опроса
  • Создание задачи — вернуться к документации по эндпоинту отправки