Ozon REST API JSON

API парсер Ozon: данные карточки товара по ссылке

Передайте URL товара Озон и получите цены, характеристики, описание и изображения в JSON. Подключайте карточки к своим каталогам, отчётам и инструментам мониторинга цен.

Какие данные возвращает парсер Озон

Цены и идентификаторы

ID товара, ссылка на карточку, валюта и цены в price_info. Идентификаторы и цены передаются строками, отсутствующая цена — как null.

Характеристики и контент

Название, бренд, описание, категории, характеристики и ссылки на изображения. Эти поля помогают наполнять каталог и сопоставлять карточки товаров.

Рейтинг и магазин

Оценка товара и количество отзывов в review_info, название и логотип магазина в shop_info, когда эти сведения доступны в карточке.

Состав данных зависит от карточки: необязательные значения могут быть null, списки — пустыми. Полная схема полей приведена в документации ответа.

Как получить карточку Ozon через API

Создайте API-токен Ozon в кабинете BHAPI. Отправьте POST-запрос с заголовком X-API-Token и ссылкой на товар в JSON-поле url.

Пример cURL — замените токен и ссылку на товар
curl -X POST "https://bhapi.ru/ozon/api/v1/item/detail-by-url" \
  -H "X-API-Token: ВАШ_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.ozon.ru/product/primer-tovara-123456789/"}'

Один запрос возвращает одну карточку. Используйте полный HTTPS-адрес товара на ozon.ru или www.ozon.ru с путём /product/…. Успешный ответ содержит status: "ok" и объект data.

Вопросы об Ozon API

Какую ссылку передать?

Полную ссылку на карточку товара Ozon, содержащую числовой ID товара. Формат URL и правила проверки описаны в параметрах метода.

Как работать с отсутствующими данными?

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

Где посмотреть стоимость запросов?

Актуальные предложения доступны в разделе тарифов BHAPI. Правила учёта запросов описаны в документации Ozon.

Подключите данные Ozon к своему приложению

Зарегистрируйтесь в BHAPI и используйте примеры запросов для своей интеграции. Другие поддерживаемые площадки собраны в обзоре API маркетплейсов.