1688.com Listings API

Search 1688.com wholesale listings by keyword and fetch full offer detail — tiered prices, MOQ, attributes, images, seller info, and logistics — as structured JSON.

原始信息汇总

数据集概述：1688.com Listings API

该API用于从1688.com（阿里巴巴中国批发市场）搜索和获取商品列表详情，并返回结构化的JSON数据。

核心功能

• 关键词搜索：通过关键词搜索商品列表，获取单页结果。
• 单个商品详情：根据商品ID获取完整的商品详情数据。

主要用途

• 批发采购
• 跨境电商（Dropshipping）产品调研
• 价格与最小起订量（MOQ）对比
• 中国供应商发现

API 端点

方法	端点	描述
GET	/search	按关键词搜索商品列表，返回一页标准化结果。
GET	/detail	根据单个商品ID获取完整的商品详情对象。

关键参数

• /search:
  • q (必填): 搜索关键词，例如 nike 或 手机壳，中文关键词效果更佳。
  • page (可选): 页码（从1开始），1688限制总页数为100页，默认值为1。
• /detail:
  • id (必填): 1688.com的商品ID。

返回数据字段

• /search 返回字段:

  • offerId (string): 商品ID，可用于调用/detail端点。
  • keyword (string): 发现此商品所用的关键词。
  • title (string): 商品标题。
  • priceFrom (number): 批发起始价（人民币）。
  • soldCount (string): 成交笔数，例如 成交400+笔。
  • location (string): 卖家所在地。
  • repurchaseRate (string): 买家复购率，例如 31%。
  • sellerTenure (string): 卖家入驻年限（如有显示）。
  • image (string): 主图缩略图URL。
  • url (string): 商品标准链接。
  • scrapedAt (string): ISO 8601格式的抓取时间戳。

• /detail 额外返回字段: 包含/search的全部字段外，还有“批发价上限（priceTo）”、“单位（unit）”、“最小起订量（minOrderQuantity）”、“阶梯价格（tierPrices）”、“完整属性矩阵（attributes）”、“所有图片（images）”、“售后服务与政策（services 和 servicePolicy）”、“物流信息（logistics）”以及完整的卖家资料（公司名、登录ID、用户ID、会员ID、旺铺链接）。

其他特性

• 认证方式：通过RapidAPI进行认证，每次调用需携带RapidAPI密钥。
• 数据实时性：每次API调用都会实时抓取1688.com的当前数据。
• 定价：提供多个订阅计划，包括BASIC（免费）、PRO（$29.99/月）、ULTRA（$99.99/月）和MEGA（$299.99/月）。
• 错误处理：当参数缺失或无效时，返回HTTP 400错误及JSON格式的错误信息；上游请求失败或被封锁时，返回HTTP 502错误。