Парсер ленты Firefox

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

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

Эндпоинт

GET /api/parsing/v1/result/mozilla/{requestId}

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

ready означает, что задача завершена, а не что она успешна: проверяйте data.success. Пустая лента — это ошибка, а не ответ ready с пустыми списками. См. Как понять, что задача выполнена успешно.

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

ПараметрТипОбязательныйОписание
requestIdstring (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"
}

Поля ответа

ПолеТипОписание
statusstring"queued", "parsing", "ready" или "cancelled"
requestIdstringID задачи
data.successbooleanУспешно ли выполнен парсинг. Есть, когда status равен "ready"
data.dataobjectДанные ленты, если data.success равен true
data.data.inputobjectmode, locale, region, sectionId, surfaceId, original_url
data.data.organicarrayКарточки блока «Популярное сегодня», обрезанные limit
data.data.sectionsarrayСекции, в которых остались карточки. Секция только из рекламы не включается. У каждого элемента есть sectionId, title, layout, followable, receivedRank и cards
data.errorstringСообщение об ошибке, присутствует при неудачном парсинге
respondedAtstringВременная метка завершения в формате 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, и в секции. Рекламные слоты в карточки не попадают.

ПолеТипОписание
ranknumberПозиция в этом списке, начиная с 1
receivedRanknumberПозиция истории в момент получения ленты
corpusItemIdstringИдентификатор истории. Один и тот же id может встретиться в organic и в секции
linkstringURL истории
titlestringЗаголовок истории
excerptstringКраткое содержание
publisherstringНазвание издателя
topicstringТема
imageUrlstringURL изображения
isTimeSensitivebooleanЗависит ли история от времени

Кредиты

Firefox New Tab тарифицируется за каждые 10 результатов исходя из limit. См. Тарифы.

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

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