Market NinjaMarket Ninja

Список товаров

GET
/products

Возвращает страницу товаров, подходящих под фильтры. Ни один фильтр не является обязательным по отдельности, но для точного результата почти всегда стоит указать хотя бы один identifying-параметр (url, external_id+marketplace или seller_code) — иначе вернётся широкий срез всего датасета.

Authorization

bearerAuth
AuthorizationBearer <token>

Bearer-токен — как получить и использовать, см. Обзор API.

In: header

Query Parameters

marketplace?string

Value in

  • "ozon"
  • "wildberries"
  • "yandex_market"
  • "lamoda"
seller_id?string

Идентификатор продавца на маркетплейсе. Обычно используется вместе с marketplace — сам по себе не гарантирует уникальность между маркетплейсами.

seller_code?string

Собственный внутренний артикул продавца или бренда для этого товара (не наш external_id). Специально НЕ требует обязательной пары с seller_id — типичный сценарий бренда: «найти мой артикул везде, где он перепродаётся», а не «только у одного конкретного продавца».

external_id?string

Собственный SKU (артикул) маркетплейса (WB nmId, Ozon sku и т. п.). Уникален только в паре с marketplace — передавайте оба параметра.

url?string

Ссылка на страницу товара. Query-параметры и фрагмент (?utm_source=..., #reviews и т. п.) отбрасываются перед сравнением автоматически — можно передавать ссылку как есть, скопированную прямо из браузера.

Formaturi
category?string

Совпадение по вхождению в category_path (на любом уровне иерархии, не обязательно последнем). Список доступных категорий — через GET /categories.

brand?string

Точное совпадение по названию бренда, без учёта регистра — в отличие от q, это не поиск по подстроке. Регистр названия бренда варьируется между маркетплейсами/сабмишенами как шум скрапинга, а не как значимое различие, поэтому сравнение его игнорирует. Список доступных значений — через GET /brands.

q?string

Простой поиск по названию товара (регистронезависимый, без учёта морфологии).

Lengthlength <= 200
trust_status?string

Фильтр по статусу доверия. По умолчанию (если не указан) возвращаются товары любого статуса — API намеренно не скрывает unverified/flagged записи, решение о доверии остаётся за вызывающей стороной.

Value in

  • "unverified"
  • "verified"
  • "flagged"
page?integer

Некорректные или отсутствующие значения тихо приводятся к значению по умолчанию, а не отклоняются с ошибкой 400.

Range1 <= value
Default1
page_size?integer

Максимум 500 — специально больше типичного значения для UI-ориентированных API, рассчитан на массовую выгрузку.

Range1 <= value <= 500
Default100

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/products?marketplace=wildberries&seller_id=2557&seller_code=BV2648-010&external_id=231151629&url=https%3A%2F%2Fwww.wildberries.ru%2Fcatalog%2F231151629%2Fdetail.aspx&category=%D0%97%D0%BE%D0%BE%D1%82%D0%BE%D0%B2%D0%B0%D1%80%D1%8B&brand=Nike&q=Nike"
{  "data": [    {      "id": "e86bee19-9cc9-4a83-b9cc-6b61f1209d90",      "marketplace": "wildberries",      "external_id": "231151629",      "url": "https://www.wildberries.ru/catalog/231151629/detail.aspx",      "name": "Air Rift Breathe White Pure Platinum Women's",      "brand": "Nike",      "category_path": [        "Обувь",        "Женская",        "Туфли и лоферы"      ],      "attributes": {        "color": "желтый",        "season": "демисезон",        "is_authentic": true      },      "image_cover": "https://basket-15.wbbasket.ru/vol2311/part231151/231151629/images/big/1.webp",      "image_gallery": [        "https://basket-15.wbbasket.ru/vol2311/part231151/231151629/images/big/1.webp"      ],      "video_cover": null,      "video_gallery": [],      "seller": {        "id": "3994154",        "name": "POIZON(ДЭВУ)",        "code": "2604540"      },      "trust_status": "unverified",      "price_flagged": false,      "prices": [        {          "country_code": "ru",          "region_code": null,          "user_auth_status": "anonymous",          "price": 7093,          "old_price": 8651,          "currency": "RUB",          "stock_status": null,          "stock_quantity": null,          "recorded_at": "2026-08-02T23:21:53.185302+00:00"        }      ],      "special_price": [        {          "country_code": "ru",          "region_code": "",          "user_auth_status": "anonymous",          "min": 6783,          "max": 6880        }      ],      "stats": null,      "first_seen_language": "ru",      "default_language": "ru",      "translations": [        {          "language": "ru",          "name": "Air Rift Breathe White Pure Platinum Women's",          "category_path": [            "Обувь",            "Женская",            "Туфли и лоферы"          ],          "attributes": {            "color": "желтый",            "season": "демисезон",            "is_authentic": true          },          "updated_at": "2026-08-02T23:21:53.081+00:00"        }      ],      "first_seen_at": "2026-08-01T01:03:17.913664+00:00",      "last_seen_at": "2026-08-02T23:21:53.081+00:00"    }  ],  "meta": {    "total": 13663,    "page": 1,    "page_size": 100  }}