botclick.ru

Публичный REST API

Программный доступ к botclick для создания задач и скачивания датасетов.

Аутентификация

Передавайте API-ключ в заголовке X-API-Key. Ключ создаётся в личном кабинете (тариф Про WB+ и выше).

curl -H "X-API-Key: bc_live_xxx" \
  https://botclick.ru/api/v1/public/sources

Эндпоинты

  • GET /api/v1/public/sources — список доступных источников
  • POST /api/v1/public/jobs — создать задачу парсинга
  • GET /api/v1/public/jobs — список задач
  • GET /api/v1/public/jobs/{id} — статус задачи
  • GET /api/v1/public/datasets/{id}/download — скачать файл

Для ключей с правом monitoring:read доступны данные мониторинга:

  • GET /api/v1/public/monitoring/targets — отслеживаемые товары
  • GET /api/v1/public/monitoring/targets/{id}/history?days=30 — история по товару (до 180 дней)
  • GET /api/v1/public/monitoring/events — изменения по отслеживаемым объектам, постранично через cursor

Пример: создать задачу WB

curl -X POST https://botclick.ru/api/v1/public/jobs \
  -H "X-API-Key: bc_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"source_code":"wildberries","params":{"query":"ноутбук","limit":10}}'

Вебхуки

Вебхук сообщает на ваш URL о завершении задачи, чтобы не опрашивать статус. Адрес и события настраиваются в разделе «Вебхуки» кабинета (тариф Про WB+ и выше). События: job.completed и job.failed.

{
  "event": "job.completed",
  "job_id": "…",
  "source_code": "wildberries",
  "rows_scraped": 100,
  "status": "completed",
  "completed_at": "2026-10-11T09:00:00+00:00",
  "error": null,
  "datasets": [{ "id": "…", "format": "csv" }]
}

Каждый запрос подписан: заголовок X-Botclick-Signature-256 имеет вид t=<unix>,v1=<hex>, где v1 — HMAC-SHA256 строки t.тело_запроса на секрете эндпоинта. Отклоняйте подписи старше 5 минут. Заголовок X-Botclick-Delivery не меняется при повторных попытках — используйте его как ключ идемпотентности.

Rate limits

Стартер: 60 req/min · Про WB+: 300 · Про все площадки: 600

Создать API-ключ

Поля выгрузки по источникам: Wildberries, Яндекс Маркет, Avito. Лимиты запросов и строк — на странице тарифов.