Получение результата
Опрашивайте этот эндпоинт для получения результата отправленной задачи парсинга Firefox New Tab.
Эндпоинт
GET /api/parsing/v1/result/mozilla/{requestId}
Повторяйте запрос каждые несколько секунд, пока status не станет "ready" или "cancelled". Пока задача ждёт в очереди или обрабатывается, status — "queued" или "parsing", см. Статусы задачи.
ready означает, что задача завершена, а не что она успешна: проверяйте data.success. Пустая лента — это ошибка, а не ответ ready с пустыми списками. См. Как понять, что задача выполнена успешно.
Параметры пути
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| requestId | string (uuid) | да | ID задачи — поле id из ответа эндпоинта отправки |
Пример запроса
curl https://app.parsering.com/api/parsing/v1/result/mozilla/YOUR_REQUEST_ID \
--header 'Authorization: Bearer YOUR_API_KEY'Ответы
В процессе — задача ждёт в очереди ("queued") или обрабатывается ("parsing"):
{
"status": "parsing",
"requestId": "b7c1e0a4-6d29-4f83-9a15-2c8e4b6d0f31"
}
Готово — задача выполнена успешно. organic — это блок «Популярное сегодня», обрезанный limit. Одна и та же история может быть и там, и в секции; в примере один и тот же corpusItemId повторён. Рекламные слоты карточками не являются. limit также обрезает каждую секцию, и секция без оставшихся карточек — в том числе из одной рекламы — не включается.
{
"status": "ready",
"requestId": "b7c1e0a4-6d29-4f83-9a15-2c8e4b6d0f31",
"data": {
"success": true,
"data": {
"input": {
"mode": "catalog",
"locale": "en-US",
"region": "US",
"sectionId": "",
"surfaceId": "newtab",
"original_url": "https://example.com/newtab"
},
"organic": [
{
"rank": 1,
"receivedRank": 1,
"corpusItemId": "8f3c2a",
"link": "https://example.com/story",
"title": "Markets open higher",
"excerpt": "A short summary of the story.",
"publisher": "Example News",
"topic": "finance",
"imageUrl": "https://example.com/story.jpg",
"isTimeSensitive": false
}
],
"sections": [
{
"sectionId": "finance",
"title": "Finance",
"layout": "cards",
"followable": true,
"receivedRank": 1,
"cards": [
{
"rank": 1,
"receivedRank": 1,
"corpusItemId": "8f3c2a",
"link": "https://example.com/story",
"title": "Markets open higher",
"excerpt": "A short summary of the story.",
"publisher": "Example News",
"topic": "finance",
"imageUrl": "https://example.com/story.jpg",
"isTimeSensitive": false
}
]
}
]
}
},
"respondedAt": "2026-10-02T10:00:03.240Z"
}
Ошибка — парсинг не удался. status при этом всё равно "ready":
{
"status": "ready",
"requestId": "b7c1e0a4-6d29-4f83-9a15-2c8e4b6d0f31",
"data": {
"success": false,
"error": "Error message"
},
"respondedAt": "2026-10-02T10:00:03.240Z"
}
Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| status | string | "queued", "parsing", "ready" или "cancelled" |
| requestId | string | ID задачи |
| data.success | boolean | Успешно ли выполнен парсинг. Есть, когда status равен "ready" |
| data.data | object | Данные ленты, если data.success равен true |
| data.data.input | object | mode, locale, region, sectionId, surfaceId, original_url |
| data.data.organic | array | Карточки блока «Популярное сегодня», обрезанные limit |
| data.data.sections | array | Секции, в которых остались карточки. Секция только из рекламы не включается. У каждого элемента есть sectionId, title, layout, followable, receivedRank и cards |
| data.error | string | Сообщение об ошибке, присутствует при неудачном парсинге |
| respondedAt | string | Временная метка завершения в формате ISO 8601 |
input.surfaceId — идентификатор surfaceId, пришедший вместе с результатом. input.original_url — URL ленты, из которой прочитан результат. input.sectionId равен "" для каталога и запрошенному id для секции.
sections[].receivedRank — позиция секции в момент получения ленты. sections[].followable и sections[].layout совпадают с доступными секциями.
Карточка
Карточка — одна история в organic или в sections[].cards. publisher — строка. rank начинается с 1 внутри своего списка. Одна и та же история может быть и в organic, и в секции. Рекламные слоты в карточки не попадают.
| Поле | Тип | Описание |
|---|---|---|
| rank | number | Позиция в этом списке, начиная с 1 |
| receivedRank | number | Позиция истории в момент получения ленты |
| corpusItemId | string | Идентификатор истории. Один и тот же id может встретиться в organic и в секции |
| link | string | URL истории |
| title | string | Заголовок истории |
| excerpt | string | Краткое содержание |
| publisher | string | Название издателя |
| topic | string | Тема |
| imageUrl | string | URL изображения |
| isTimeSensitive | boolean | Зависит ли история от времени |
Кредиты
Firefox New Tab тарифицируется за каждые 10 результатов исходя из limit. См. Тарифы.
Следующие шаги
- Вебхуки — получение результата через callback вместо опроса
- Создание задачи — вернуться к документации по эндпоинту отправки