1688 API 与数据工具

常见问题

这两个 1688 工具能做什么？

一共两个工具。「按关键词搜索 1688 批发商品」只有一个必填参数 keyword，返回匹配的批发商品列表；「按商品 ID 获取 1688 商品详情」只有一个必填参数 itemId，返回该商品公开的详情。按目录里记录的调用反馈（2026 年 9–10 月），搜索结果里有人民币单价和成交数量，详情结果里有 SKU 名称、阶梯价和起订量。

怎么调用？

两个工具用同一个 Toolswitch Key：可以通过 HTTP 调用，也可以把 Toolswitch 作为 MCP 服务器接入 Agent。两个工具都是 GET 请求：搜索传 keyword，详情传 itemId。

怎么计费？

按次计费。两个工具都按成功调用计价，供应商的价目说明里写明失败的调用不收费。费用是供应商价格，加上 Toolswitch 的服务费（如有）；页面会显示实时价格。

和 1688 官方开放平台有什么区别？

Toolswitch 是第三方接入：这两个工具由第三方数据供应商提供，你用自己的 Toolswitch Key 调用，不需要自己去申请 1688 开放平台的接入。如果需要只有官方平台才提供的功能，请以 1688 官方文档为准。