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

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

Отправьте задачу парсинга ленты Firefox New Tab. В режиме catalog лента свежая и без подписок: в неё входят блок «Популярное сегодня» и те секции, в которых остались карточки историй. limit обрезает «Популярное сегодня» и каждую секцию. Секция без карточек — в том числе состоящая только из рекламы — в ответ не попадает. В режиме section задача подписывается на одну секцию, после чего источник меняет порядок секций в ленте.

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

Эндпоинт

POST /api/parsing/v1/mozilla

Тело запроса

ПараметрТипОбязательныйОписание
modestringдаcatalog или section. catalog — свежая лента без подписок: «Популярное сегодня» и секции, в которых остались карточки. section подписывается на одну секцию; источник после этого переставляет секции
localestringдаЛокаль ленты. Допустимые значения перечислены ниже
regionstringнетДвухбуквенный код страны. Если не указан, берётся из суффикса локали (en-US → US)
limitnumberнетКоличество элементов ленты, от 1 до 100. По умолчанию 100. «Популярное сегодня» и каждая секция обрезаются до этого числа карточек. Секция без карточек в ответ не попадает. Десять результатов стоят 1 кредит
sectionIdstringесли mode — sectionСекция, на которую нужно подписаться. Возьмите значение из доступных секций
sectionTitlestringнетПодпись только для ваших логов. В парсер не передаётся и на ленту не влияет
callbackUrlstringнетURL вебхука для отправки результата по завершении

Допустимые значения locale: de-AT, de-CH, de-DE, en-CA, en-GB, en-IE, en-US, es-AR, es-CL, es-ES, es-MX, fr-BE, fr-FR, it-IT, pl-PL.

В форме личного кабинета по умолчанию en-US. Регистр суффикса приводится к каноническому (en-gb → en-GB). Неизвестная локаль в ленте — это ошибка, а не пустая лента. Идентификаторы секций берутся из доступных секций.

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

Каталог — свежая лента.

curl -X POST 'https://app.parsering.com/api/parsing/v1/mozilla' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{"mode":"catalog","locale":"en-US","limit":20}'

Секция — подписка на секцию finance. callbackUrl необязателен.

curl -X POST 'https://app.parsering.com/api/parsing/v1/mozilla' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
  "mode": "section",
  "locale": "en-US",
  "sectionId": "finance",
  "callbackUrl": "https://my-server.com/webhook/parsing"
}'

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

Ответ ниже соответствует запросу каталога.

{
  "id": "b7c1e0a4-6d29-4f83-9a15-2c8e4b6d0f31",
  "status": "queued",
  "scope": "mozilla",
  "costCredits": 2,
  "createdAt": "2026-10-02T10:00:00.000Z"
}
ПолеТипОписание
idstringID задачи для опроса результата
statusstringСтатус задачи — сразу после создания queued. Все статусы: Коды ответов API
scopestringТип задачи — всегда mozilla для этого эндпоинта
costCreditsnumberКоличество кредитов, списанных за задачу
createdAtstringВременная метка создания задачи в формате ISO 8601

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

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