Google SERP Парсер

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

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

Эндпоинт

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

Продолжайте опрос, пока status не перестанет быть "parsing".

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

Параметр	Тип	Обязательный	Описание
requestId	string (uuid)	да	ID задачи, возвращённый эндпоинтом отправки

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

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

Ответы

В процессе — задача ещё обрабатывается:

{
  "status": "parsing"
}

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

{
  "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": []
  },
  "respondedAt": "2026-03-20T10:35:35.866Z"
}

Поля ответа

Поле	Тип	Описание
status	string	`"ready"` при завершении
requestId	string	ID задачи
data.input.original_url	string	Разрешённый URL поиска Google
data.organic	array	Органические результаты поиска
data.organic[].rank	number	Позиция в результатах (начиная с 1)
data.organic[].link	string	URL результата
data.organic[].title	string	Заголовок результата
data.organic[].description	string	Сниппет результата
data.screenshots	string[]	Скриншоты
data.related	array	Связанные поисковые запросы
data.related[].link	string	Ссылка связанного запроса
data.related[].rank	string	Ранг связанного запроса
data.related[].text	string	Текст связанного запроса
respondedAt	string	Временная метка завершения в формате ISO 8601

Важно! Скриншот хранится 1 час после парсинга.
Сохраните результаты на своей стороне, чтобы не потерять их.

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

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