商品搜索 / 详情 / 订单 / 物流全量接口・官方标准版

---

一、接口总览

1688 跨境寻源通 API（跨境采购解决方案）为跨境卖家、ERP、铺货工具提供全链路货源 + 交易数据能力。

• 适用场景：选品、一键铺货、价格监控、订单同步、物流跟踪、跨境供应链管理
• 接入要求：企业开发者认证 + 订购跨境解决方案 + 权限审核
• 数据格式：JSON、HTTPS POST
• 签名：MD5 / HMAC-SHA256（按官方规范）

---

二、核心接口清单（全量）

1. 商品搜索类

• 跨境商品搜索（主）alibaba.cross.product.search

  • 关键词、类目、价格区间、起批量、是否跨境代发、是否现货
  • 返回：商品 ID、标题、主图、价格、库存、起批、供应商、跨境标签、HS 编码

• 按图搜同款（跨境）alibaba.cross.product.search.byimage

  • 传入图片 URL → 返回相似跨境商品列表

• 跨境热销货盘查询alibaba.cross.product.hot.list

  • 官方精选跨境爆款、类目榜单、热销品

2. 商品详情类

• 跨境商品详情（全字段）alibaba.cross.productInfo

  • offerId → 商品全信息：标题、SKU、价格、库存、详情图、视频、材质、重量 / 体积、HS 编码、多语言标题、认证（CE/FDA）、代发 / 物流 / 售后政策

• 商品 SKU & 库存查询alibaba.cross.product.sku

  • 规格、SKU 价格、可售库存、阶梯价

3. 订单类

• 创建跨境订单alibaba.cross.order.create

  • 商品、数量、收货信息、物流方式、跨境支付（跨境宝）阿里巴巴开放平台

• 订单列表 / 详情查询alibaba.cross.order.get / alibaba.cross.order.list

• 订单支付（跨境）alibaba.crossBorderPay.url.get阿里巴巴开放平台

  • 获取跨境宝支付链接

4. 物流 & 履约

• 物流跟踪（买家视角）alibaba.trade.getLogisticsInfos.buyerView

  • 运单号、物流公司、轨迹、签收状态、子单商品明细

• 物流单 & 发货信息查询alibaba.cross.logistics.get

  • 发货仓、物流商、时效、运费

5. 供应商 & 资质

• 跨境供应商详情alibaba.cross.supplier.get
  • 诚信通、实力商家、深度验厂、跨境服务能力、代发 / 贴标 / 海外仓

---

三、通用接入规范（必看）

1. 系统级参数（所有接口必传）

• app_key：应用 Key
• access_token：用户授权（24 小时）
• method：接口名（如 alibaba.cross.product.search）
• timestamp：13 位毫秒时间戳
• sign：签名（MD5 大写）
• format：json

2. 签名规则（极简版）

1. 排除sign、空值参数
2. 按ASCII 升序排序
3. 拼接：key1value1key2value2...
4. 首尾加AppSecret → MD5 → 32 位大写

3. 调用限制（重要）

• 默认：QPS 5~10、分钟 100 次、日限 1000 次
• 企业可提额至：QPS 20~50、分钟 1000 次
• 超限返回：429 / ACCESS_LIMIT_EXCEEDED

4. 常见错误码

• 1002：签名错误
• 403：权限不足 / 未订购跨境方案
• 429：限流
• 400_4：无可跨境宝支付订单阿里巴巴开放平台
• 500：平台异常（重试）

阿里巴巴中国站获得1688商品详情 API 返回值说明

item_get-获得1688商品详情 

1688.item_get

公共参数

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中）
secret	String	是	调用密钥
api_name	String	是	API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cache	String	否	[yes,no]默认yes，将调用缓存的数据，速度比较快
result_type	String	否	[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
lang	String	否	[cn,en,ru]翻译语言，默认cn简体中文
version	String	否	API版本

请求参数

请求参数：num_iid=610947572360

参数说明：num_iid:1688商品ID
sales_data:&sales_data=1 获取近30天成交数据
agent:&agent=1 获取1688分销代发价格数据

响应参数

Version: Date:

名称	类型	必须	示例值	描述
item	item[]	0		宝贝详情数据