Market NinjaMarket Ninja
使用场景

批量导出

分页遍历数据集中的大规模数据切片——用于 LLM 上下文、自建数据库或数据分析——同时遵守每日配额限制。

导出前先浏览类目

在拉取整个市场平台的商品目录之前,先通过类目列表缩小范围通常会更高效——先调用 GET /categories,再将得到的 category_path 作为 GET /products 的 category 筛选参数。完整指南(包括在任意层级深度的包含匹配,以及如何理解空的 category_path: [])请参阅类目。您也可以用同样的方式, 通过 brand 参数把导出范围缩小到某个具体品牌——可用名称与完整示例请参阅 品牌。

分页

page_size 默认值为 100,最大为 500——相比典型的面向 UI 的 API,这个默认值刻意设得更宽松, 专门为这种使用场景设计。GET /products 不会返回 meta.total——请根据 meta.has_more 驱动循环:

#!/bin/bash
PAGE=1
while true; do
  RESPONSE=$(curl -s -G -H "Authorization: Bearer mn_live_..." \
    "https://data.marketninja.ru/v1/products" \
    --data-urlencode "marketplace=wildberries" \
    --data-urlencode "category=Зоотовары" \
    --data-urlencode "page_size=500" \
    --data-urlencode "page=$PAGE")

  echo "$RESPONSE" | jq -c '.data[]' >> products.jsonl

  HAS_MORE=$(echo "$RESPONSE" | jq '.meta.has_more')
  if [ "$HAS_MORE" != "true" ]; then break; fi
  PAGE=$((PAGE + 1))
done

注意每日配额

配额统计的是响应中实际返回的记录数,而不是请求次数,因此分页导出消耗的配额取决于您取得的商品数, 与用了多少次请求无关。每个响应都带有 X-Quota-Remaining 响应头。上面的示例会在它变为 0 (或收到 429 quota_exceeded)时停止,收到 429 rate_limited 时则等待 Retry-After 秒后重试同一页。 收到 503 时,示例会等待 Retry-After 秒(没有该响应头时为 30 秒),每次重试等待更久,重试三次后放弃: 如果反复出现 query_timeout,说明请求本身过重,应缩小查询范围(使用更精确的筛选条件),而不是原样重试。 每个密钥当天的配额使用情况可在账户的 API 密钥页面查看。各项限制的数值与计算规则 详见限制与配额。

配额于 UTC 00:00(北京时间 08:00)重置。如果您要导出整个数据集,请将导出分散到数天完成。如果每天 75,000 条记录无法满足您的需求,请通过微信联系我们(微信号:getmarketninja)。

用于 LLM 上下文

如果目标是为模型提供一份最新的数据切片(而不是维护数据集的完整本地副本),通常更好的做法是 按用户的每次提问做针对性的窄范围查询,而不是提前「以防万一」批量导出全部数据:通过 查找商品中的场景,定位用户实际询问的那个商品或卖家, 然后把这段紧凑的 JSON 直接交给模型即可。

最后更新于

本页目录