查找商品

GET /products 是唯一的入口，只要您还不知道商品的内部 id（关于「先查找后获取」的模式， 请参阅 API 概览）。以下是四个真实使用场景，每个都有各自的参数组合。

场景 1：您已有商品链接

最常见的情况——链接直接从浏览器复制，或从表格中取得。

curl -G -H "Authorization: Bearer mn_live_..." \
  "https://data.marketninja.ru/v1/products" \
  --data-urlencode "url=https://www.wildberries.ru/catalog/231151629/detail.aspx?utm_source=instagram"

场景 2：您知道市场平台的 SKU

如果您手上有某个市场平台专属的 SKU（WB 的 nmId、Ozon 的 sku 等）——请连同 marketplace 一起传入，否则结果可能出现歧义（同一个 external_id 理论上可能出现在不同平台上）。

curl -G -H "Authorization: Bearer mn_live_..." \
  "https://data.marketninja.ru/v1/products" \
  --data-urlencode "external_id=231151629" \
  --data-urlencode "marketplace=wildberries"

场景 3：您知道卖家货号

这是一个独立参数——seller_code——不要和 external_id 混淆（后者是我们的市场平台 SKU， 而 seller_code 是您自己的、卖家在自己商品页面上标注的那个货号）。典型需求是「找出我这个货号 在哪里都有销售」，因此该参数特意不要求必须配合 seller_id 使用——如果您的商品被多个卖家转售， 您会看到所有匹配结果。

curl -G -H "Authorization: Bearer mn_live_..." \
  "https://data.marketninja.ru/v1/products" \
  --data-urlencode "seller_code=BV2648-010"

如果只想限定在某一个卖家范围内——添加 seller_id（可选再加上 marketplace）：

curl -G -H "Authorization: Bearer mn_live_..." \
  "https://data.marketninja.ru/v1/products" \
  --data-urlencode "seller_code=BV2648-010" \
  --data-urlencode "seller_id=2557" \
  --data-urlencode "marketplace=wildberries"

场景 4：需要品牌的全部商品

这是一个独立参数——brand——不要与场景 3 混淆：seller_code 用于查找您某个具体 货号在所有转售渠道中的记录，而 brand 则查找数据集中该品牌的全部商品，与货号无关， 采用不区分大小写的精确匹配。可用品牌名称列表与示例请参阅品牌。

其他筛选方式

GET /products 还支持更宽泛的搜索——例如按名称（q）或类目（category，与 category_path 做包含匹配——某市场平台的类目列表及完整筛选指南请参阅 类目）。完整参数列表请见参考文档。

拿到结果之后

响应中已经包含当前价格、图片、规格参数、可信度状态和卖家信息——大多数场景无需再单独调用 GET /products/{id}。只有当您需要在某个特定时刻获取保证最新的状态、且与查找结果本身 相互独立时，才直接按 id 调用它。