API

1688 API：批发报价与工厂信息，返回 JSON

1688 面向企业的开放平台需要资质和审核，返回的也是你自己店铺的数据。这里读取的是 1688 公开展示的内容：报价、起订量、供应商与商品详情，直接返回 JSON。有一点值得先说清楚：找「卖货的报价」和找「做货的工厂」是两件事，这里是两个不同的接口。

获取免费密钥完整文档：每个接口、每个参数 →

接口

endpoint返回内容必填
search按关键词搜索批发报价。中文关键词返回的结果最完整，英文次之。query
category/offers按类目浏览并正确翻页。这是深度接口：连续翻页不会重复同一批结果。category_id
supplier/search查找真正生产这类商品的已认证工厂，而不是转手销售的店铺。做采购时这通常才是要找的。query
categories1688 的类目树，已翻译。三层共 54 个顶级类目。全部可选
product/detail单个报价的完整信息：报价页与 1688 自身的规格模型合并后的结果，含规格、起订量与图片。offer_id
product/reviews该报价的买家评价：平均星级（满分 5 分）与好评比例。offer_id

每次调用按额度计费。失败和被拦截的调用不计费。

可运行示例

采购时先用 supplier/search 找工厂，再用 search 看同类报价，两者结合才能判断价格是否合理。只看报价很容易把转手的中间商当成生产方。

请求
curl -X POST https://api.reefapi.com/1688/v1/supplier/search \
  -H "x-api-key: 你的密钥" \
  -H "content-type: application/json" \
  -d '{"query": "硅胶厨具"}'
响应（节选）
{
  "ok": true,
  "data": {
    "results": [
      {
        "supplier_id": "...",
        "name": "...",
        "years": 8,
        "location": "广东 东莞",
        "is_verified": true
      }
    ]
  },
  "meta": { "record_count": 20, "cache_hit": false, "mode": "live" }
}

与其自己写 1688 爬虫

自己写 1688 的爬虫，第一天通常能跑。难的是之后：页面结构一变，解析器不会报错，而是安静地返回空列表；风控一旦触发，请求被拦下。两种情况在你这边看起来一样，都像「没有商品」。

这里维护由我们负责：结构变了我们修引擎，被拦截时返回的是明确的错误码，而且该次调用不计费。

如果只是一次性的调研，自己写脚本确实更便宜，这一点我们直说。要做长期运行的采购比价，花钱的不是代码，而是没人察觉的故障。

This page in English →完整文档：每个接口、每个参数 →

更多中文文档

限制与诚实说明

  • 这不是 1688 的官方开放平台接口，我们与 1688 没有合作关系。
  • 🔴 `price_tiers`（阶梯价）目前不可靠：实测 5 个商品中有 4 个只返回一个档位，等同于没有阶梯。需要准确阶梯价时请以商品详情页为准，这一点我们不隐瞒。
  • 🔴 按关键词搜索报价的通道会被 1688 临时限流，观测到的冷却约为 8 分半。工厂搜索、类目浏览和商品详情不受影响。
  • 中文关键词的结果明显优于英文，这是 1688 自身的检索行为。
  • 没有缓存：每次调用返回的都是当时的状态。