Market NinjaMarket Ninja
方法

按 ID 获取商品

GET
/products/{id}

id 是我们自己的内部标识符（一个 UUID），不是市场平台的 SKU。获取它的唯一途径是 调用 GET /products（通过 url、external_id+marketplace，或 seller_code）——外部无法提前得知它。

Authorization

bearerAuth
AuthorizationBearer <token>

Bearer 令牌——获取和使用方法请参阅文档中的「API 概览」页面。

In: header

Path Parameters

id*string
Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/products/e86bee19-9cc9-4a83-b9cc-6b61f1209d90"
{  "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"  }}

列出类目 GET

`marketplace` 为必填——不同平台的类目体系各不相同，如果不限定平台，列表会把互不 相关的层级结构混在一起。 该接口不计入每日数据配额——只受每分钟请求频率限制约束。它是用于筛选前导航的 查询类接口，不属于数据导出，因此不会返回 `quota_exceeded`。 这是每日预先计算好的快照，而不是实时查询——数据相较于当天新抓取的内容最多 可能有 24 小时的延迟。

获取商品价格历史 GET

某个商品价格与库存观测记录的完整时间序列——与当前价格不同（当前价格已包含在 `GET /products` 和 `GET /products/{id}` 中），这个端点仅在需要分析历史趋势时才用到。