Создание задачи
Отправьте задачу парсинга ленты Firefox New Tab. В режиме catalog лента свежая и без подписок: в неё входят блок «Популярное сегодня» и те секции, в которых остались карточки историй. limit обрезает «Популярное сегодня» и каждую секцию. Секция без карточек — в том числе состоящая только из рекламы — в ответ не попадает. В режиме section задача подписывается на одну секцию, после чего источник меняет порядок секций в ленте.
Требует области действия mozilla для вашего API-ключа.
Эндпоинт
POST /api/parsing/v1/mozilla
Тело запроса
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| mode | string | да | catalog или section. catalog — свежая лента без подписок: «Популярное сегодня» и секции, в которых остались карточки. section подписывается на одну секцию; источник после этого переставляет секции |
| locale | string | да | Локаль ленты. Допустимые значения перечислены ниже |
| region | string | нет | Двухбуквенный код страны. Если не указан, берётся из суффикса локали (en-US → US) |
| limit | number | нет | Количество элементов ленты, от 1 до 100. По умолчанию 100. «Популярное сегодня» и каждая секция обрезаются до этого числа карточек. Секция без карточек в ответ не попадает. Десять результатов стоят 1 кредит |
| sectionId | string | если mode — section | Секция, на которую нужно подписаться. Возьмите значение из доступных секций |
| sectionTitle | string | нет | Подпись только для ваших логов. В парсер не передаётся и на ленту не влияет |
| callbackUrl | string | нет | 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"
}
| Поле | Тип | Описание |
|---|---|---|
| id | string | ID задачи для опроса результата |
| status | string | Статус задачи — сразу после создания queued. Все статусы: Коды ответов API |
| scope | string | Тип задачи — всегда mozilla для этого эндпоинта |
| costCredits | number | Количество кредитов, списанных за задачу |
| createdAt | string | Временная метка создания задачи в формате ISO 8601 |
Задача обрабатывается асинхронно. Используйте id для опроса результата или укажите callbackUrl для получения вебхука по завершении парсинга.
Следующие шаги
- Получение результата — опрос результата по ID задачи
- Вебхуки — получение результата через callback вместо опроса
- Доступные секции — поиск идентификаторов секций по локали
- Тарифы — как рассчитываются кредиты для этого запроса