Парсинг товаров из своего кода — REST API для разработчиков

apiразработчикам 07 сен 08:23 29

---

У Q-Parser появился открытый REST API. Теперь парсинг, сбор категорий и выгрузку товаров можно запускать из своего кода — так же, как в личном кабинете, только без кликов по кнопкам.

Это удобно, если вы собираете каталоги по своему сценарию: обновляете магазин по вебхуку, тянете товары в CRM, склеиваете несколько поставщиков в один пайплайн или просто не хотите каждый раз заходить на сайт.

Полный справочник методов — в инструкции для разработчиков. Ниже — зачем API нужен и как сделать первый запрос.

Что умеет API

Через API доступен тот же парсинг, что и в кабинете: больше 7000 сайтов, пробная загрузка без тарифа, авторизация на закрытых сайтах, выгрузка в привычные форматы.

Из скрипта можно:

• посмотреть тариф, баланс и AI Points;
• узнать, какие настройки нужны конкретному сайту;
• сохранить логин и пароль для сайтов с авторизацией;
• собрать дерево категорий;
• запустить парсинг товаров и следить за прогрессом;
• получить готовые товары страницами;
• выгрузить каталог в CSV, Excel, YML и другие форматы.

Пробный парсинг запускается с флагом trial: true — так можно проверить интеграцию, даже если тариф ещё не подключен.

Как начать

API-ключ лежит в настройках профиля. Там его можно скопировать или перевыпустить. Ключ передавайте только в заголовках запроса, не публикуйте его в клиентском коде и не отдавайте третьим лицам.

Базовый адрес: https://q-parser.ru/api/v1.

Ключ можно передать так:

Authorization: Bearer ВАШ_КЛЮЧ

или так:

X-Api-Key: ВАШ_КЛЮЧ

Проверить, что всё работает:

curl https://q-parser.ru/api/v1/me \
  -H "Authorization: Bearer ВАШ_КЛЮЧ"

В ответе придут email, тариф, срок действия, баланс и AI Points.

Типичный сценарий

Обычный цикл такой: запустили парсинг → дождались статуса completed → забрали товары или отправили их в выгрузку.

Сначала запускаем парсинг. Если категории не указать, их подхватит сам парсер:

curl -X POST https://q-parser.ru/api/v1/parser \
  -H "Authorization: Bearer ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com"}'

В ответе придёт идентификатор вида id1234567. По нему смотрим статус:

curl https://q-parser.ru/api/v1/parser/id1234567 \
  -H "Authorization: Bearer ВАШ_КЛЮЧ"

Статусы знакомые: queued, running, completed, canceled, error. Когда парсинг завершился, товары можно забрать страницами:

curl "https://q-parser.ru/api/v1/parser/id1234567/goods?limit=100&offset=0" \
  -H "Authorization: Bearer ВАШ_КЛЮЧ"

В каждой карточке — название, артикул, цена, наличие, фото, описание и дополнительные характеристики. Если нужен файл, а не JSON, запускайте выгрузку через POST /api/v1/export и забирайте ссылки на готовые файлы из GET /api/v1/export/:id.

Для сайтов с особыми настройками сначала вызовите GET /api/v1/website/:domain — там будет схема опций и флаг, нужна ли авторизация.

Чем API отличается от автовыгрузок

Автовыгрузки по расписанию никуда не делись. Они по-прежнему лучший способ обновлять каталог каждый день или каждую неделю без своей инфраструктуры.

API нужен в других случаях:

• парсинг должен стартовать по событию из вашей системы, а не по таймеру;
• товары нужны сразу в своей базе, без промежуточного файла;
• логика сложнее, чем «сайт → формат → почта»: несколько поставщиков, свои фильтры, очередь задач.

Можно сочетать оба подхода: расписание оставить в кабинете, а точечные загрузки и разбор товаров делать через API.

На что обратить внимание

• Тело POST-запросов — JSON с заголовком Content-Type: application/json.
• Даты в ответах — unix timestamp в миллисекундах.
• Ошибки приходят в виде { "error": { "code": "...", "message": "..." } }.
• Одновременно нельзя держать больше 100 незавершённых парсингов и 100 незавершённых выгрузок. Если лимит занят, API вернёт ошибку unprocessable.

Полноценный парсинг платного сайта по-прежнему идёт по вашему тарифу. Сам вызов API отдельно не тарифицируется: считаются сайты и товары, как при обычной загрузке из кабинета.

Что дальше

Возьмите ключ в профиле, сделайте запрос к /api/v1/me и откройте справочник API — там разобраны все методы, поля запросов и ответы.

Если вы уже пользуетесь Q-Parser и хотели встроить парсинг в свои скрипты — теперь это можно сделать напрямую.