Публичное API · v1

API документация ParserHub

Интегрируйте мониторинг цен Wildberries и Ozon в свои сервисы: товары, история цен, конкуренты — всё через простое REST API.

Начало работы

Базовый URL

https://parserhub.ru

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

Все запросы требуют API токен в заголовке:

Authorization: Token ваш_токен

Получить токен можно в личном кабинете — Профиль → API токены.

Управление токенами

Получить список токенов

GET/api/tokens/

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

curl -H "Authorization: Token ваш_токен" https://parserhub.ru/api/tokens/
bash

Ответ

[
  {
    "id": 1,
    "name": "Мой сервис",
    "token": "abc123...",
    "created_at": "2026-05-29T10:00:00Z",
    "last_used_at": "2026-05-29T12:00:00Z"
  }
]
json

Создать токен

POST/api/tokens/

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

curl -X POST https://parserhub.ru/api/tokens/ \
  -H "Authorization: Token ваш_токен" \
  -H "Content-Type: application/json" \
  -d '{"name": "Мой сервис"}'
bash

Удалить токен

DELETE/api/tokens/<id>/delete/

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

curl -X DELETE https://parserhub.ru/api/tokens/1/delete/ \
  -H "Authorization: Token ваш_токен"
bash

Wildberries — Товары

Получить все товары

GET/api/wb/products/all/

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

curl -H "Authorization: Token ваш_токен" \
  https://parserhub.ru/api/wb/products/all/
bash

Ответ

[
  {
    "id": 1,
    "article": "123456",
    "name": "Название товара",
    "brand": "Бренд",
    "price": 1500,
    "price_spp": 1350,
    "stock_quantity": 100,
    "image": "https://..."
  }
]
json

Добавить артикулы

POST/api/wb/products/add/

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

curl -X POST https://parserhub.ru/api/wb/products/add/ \
  -H "Authorization: Token ваш_токен" \
  -H "Content-Type: application/json" \
  -d '{"articles": "123456, 789012, 345678"}'
bash

Ответ

{
  "created": ["123456", "789012"],
  "already_exists": ["345678"]
}
json

Удалить по артикулу

DELETE/api/wb/products/article/<артикул>/delete/

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

curl -X DELETE https://parserhub.ru/api/wb/products/article/123456/delete/ \
  -H "Authorization: Token ваш_токен"
bash

Удалить по ID

DELETE/api/wb/products/<id>/delete/

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

curl -X DELETE https://parserhub.ru/api/wb/products/1/delete/ \
  -H "Authorization: Token ваш_токен"
bash

Wildberries — История цен своих товаров

История цен

GET/api/wb/products/history/

Параметры

ПараметрОписание
daysЗа сколько дней история (по умолчанию 30). days=0 — все замеры за сегодня (каждые 15 минут)
articleТолько один артикул (необязательно)

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

# История всех товаров за 30 дней
curl -H "Authorization: Token ваш_токен" \
  "https://parserhub.ru/api/wb/products/history/?days=30"

# История одного артикула
curl -H "Authorization: Token ваш_токен" \
  "https://parserhub.ru/api/wb/products/history/?days=30&article=123456"

# Замеры за сегодня (каждые 15 минут)
curl -H "Authorization: Token ваш_токен" \
  "https://parserhub.ru/api/wb/products/history/?days=0"
bash

Ответ (days > 0 — по одной записи в день):

[
  {
    "id": 1,
    "article": "123456",
    "name": "Название товара",
    "snapshots": [
      {
        "snapshot_date": "2026-07-12",
        "price_min": "1400.00",
        "price_max": "1500.00",
        "price_avg": "1450.00",
        "price_close": "1500.00"
      }
    ]
  }
]
json

Ответ (days = 0 — замеры за сегодня):

[
  {
    "id": 1,
    "article": "123456",
    "name": "Название товара",
    "today_history": [
      {
        "price": "1500.00",
        "price_spp": "1350.00",
        "recorded_at": "2026-07-13T10:15:00Z"
      }
    ]
  }
]
json

Wildberries — Bulk: товары + конкуренты за один запрос

Массовое добавление товаров с конкурентами

POST/api/wb/products/bulk-add/

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

curl -X POST https://parserhub.ru/api/wb/products/bulk-add/ \
  -H "Authorization: Token ваш_токен" \
  -H "Content-Type: application/json" \
  -d '{
    "products": [
      {"article": "123456", "competitors": ["789012", "345678", "901234"]},
      {"article": "111111", "competitors": ["222222"]},
      {"article": "333333", "competitors": []}
    ]
  }'
bash

Ответ

[
  {
    "article": "123456",
    "created": true,
    "competitors_added": ["789012", "345678", "901234"],
    "competitors_skipped": []
  },
  {
    "article": "333333",
    "created": true,
    "competitors_added": [],
    "competitors_skipped": []
  }
]
json

Wildberries — Конкуренты

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

GET/api/wb/products/<id>/competitors/

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

curl -H "Authorization: Token ваш_токен" \
  https://parserhub.ru/api/wb/products/1/competitors/
bash

Добавить конкурентов

POST/api/wb/products/<id>/competitors/add/

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

curl -X POST https://parserhub.ru/api/wb/products/1/competitors/add/ \
  -H "Authorization: Token ваш_токен" \
  -H "Content-Type: application/json" \
  -d '{"articles": "789012, 345678"}'
bash

Удалить конкурента

DELETE/api/wb/competitors/<id>/delete/

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

curl -X DELETE https://parserhub.ru/api/wb/competitors/5/delete/ \
  -H "Authorization: Token ваш_токен"
bash

История цен конкурента

GET/api/wb/competitors/<id>/history/?days=30

days=0 — замеры за сегодня. Формат ответа такой же, как у истории своих товаров.

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

curl -H "Authorization: Token ваш_токен" \
  "https://parserhub.ru/api/wb/competitors/5/history/?days=30"
bash

Ozon — Товары

Получить все товары

GET/api/ozon/products/all/

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

curl -H "Authorization: Token ваш_токен" \
  https://parserhub.ru/api/ozon/products/all/
bash

Ответ

[
  {
    "id": 1,
    "sku": "123456789",
    "name": "Название товара",
    "brand": "Бренд",
    "price_with_card": 2000,
    "price_without_card": 2200,
    "original_price": 2500,
    "stock_count": 50,
    "cover_image": "https://..."
  }
]
json

Добавить артикулы (SKU)

POST/api/ozon/products/add/

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

curl -X POST https://parserhub.ru/api/ozon/products/add/ \
  -H "Authorization: Token ваш_токен" \
  -H "Content-Type: application/json" \
  -d '{"skus": "123456789, 987654321"}'
bash

Удалить по SKU

DELETE/api/ozon/products/sku/<sku>/delete/

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

curl -X DELETE https://parserhub.ru/api/ozon/products/sku/123456789/delete/ \
  -H "Authorization: Token ваш_токен"
bash

Удалить по ID

DELETE/api/ozon/products/<id>/delete/

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

curl -X DELETE https://parserhub.ru/api/ozon/products/1/delete/ \
  -H "Authorization: Token ваш_токен"
bash

Ozon — История цен своих товаров

История цен

GET/api/ozon/products/history/

Параметры

ПараметрОписание
daysЗа сколько дней история (по умолчанию 30). days=0 — все замеры за сегодня (каждые 15 минут)
skuТолько один SKU (необязательно)

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

# История всех товаров за 30 дней
curl -H "Authorization: Token ваш_токен" \
  "https://parserhub.ru/api/ozon/products/history/?days=30"

# История одного SKU
curl -H "Authorization: Token ваш_токен" \
  "https://parserhub.ru/api/ozon/products/history/?days=30&sku=123456789"
bash

Ответ (days > 0 — по одной записи в день):

[
  {
    "id": 1,
    "sku": "123456789",
    "name": "Название товара",
    "snapshots": [
      {
        "snapshot_date": "2026-07-12",
        "price_min": "1900.00",
        "price_max": "2000.00",
        "price_avg": "1950.00",
        "price_close": "2000.00"
      }
    ]
  }
]
json

Ответ (days = 0 — замеры за сегодня):

[
  {
    "id": 1,
    "sku": "123456789",
    "name": "Название товара",
    "today_history": [
      {
        "price_with_card": "1900.00",
        "price_without_card": "2000.00",
        "original_price": "2500.00",
        "recorded_at": "2026-07-13T10:15:00Z"
      }
    ]
  }
]
json

Ozon — Конкуренты

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

GET/api/ozon/products/<id>/competitors/

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

curl -H "Authorization: Token ваш_токен" \
  https://parserhub.ru/api/ozon/products/1/competitors/
bash

Добавить конкурентов

POST/api/ozon/products/<id>/competitors/add/

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

curl -X POST https://parserhub.ru/api/ozon/products/1/competitors/add/ \
  -H "Authorization: Token ваш_токен" \
  -H "Content-Type: application/json" \
  -d '{"skus": "987654321, 111222333"}'
bash

Удалить конкурента

DELETE/api/ozon/competitors/<id>/delete/

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

curl -X DELETE https://parserhub.ru/api/ozon/competitors/5/delete/ \
  -H "Authorization: Token ваш_токен"
bash

История цен конкурента

GET/api/ozon/competitors/<id>/history/?days=30

days=0 — замеры за сегодня. Формат ответа такой же, как у истории своих товаров.

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

curl -H "Authorization: Token ваш_токен" \
  "https://parserhub.ru/api/ozon/competitors/5/history/?days=30"
bash

Коды ответов

КодОписание
200Успешно
201Создано
204Удалено
400Ошибка в запросе
401Нет токена или токен недействителен
403Подписка истекла
404Не найдено

Нужен API токен?

Зарегистрируйтесь и создайте токен в личном кабинете — это займёт пару минут.

Задать вопрос в Telegram