b2b商品详情及关键字API接口解析

1688 商品详情 API + 关键词搜索 API 完整解析
包含：接口名、入参、返回结构、关键字段说明、开发注意点。

一、1688 两个核心 API

1）商品详情接口：1688.item_get

作用：根据商品 ID（offer_id/num_iid）获取完整商品信息（SKU、价格、库存、详情图、属性、商家信息等）

2）关键词搜索接口：1688.item_search

作用：根据关键词搜索商品列表，支持分页、价格区间、发货地筛选等

二、1688.item_get 商品详情接口解析

1. 必传参数

• num_iid：商品 ID（1688 商品链接里的 id）

• key：你的 API 密钥

2. 标准返回示例结构

# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 请求示例 url 默认请求参数已经做URL编码
# 封装好API demo url=o0b.cn/ibrad， wechat id:  TaoxiJd-api 复制链接获取测试
url = "https://api-gw.cn/1688/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&imgid=http://g-search3.alicdn.com/img/bao/uploaded/i4/O1CN01IDpcD81zHbpHs1YgT_!!2200811456689.jpg"
headers = {
    "Accept-Encoding": "gzip",
    "Connection": "close"
}
if __name__ == "__main__":
    r = requests.get(url, headers=headers)
    json_obj = r.json()
    print(json_obj)

3. 关键字段解析（开发必存）

• num_iid：商品唯一 ID

• title：标题

• price：单价

• min_order：最小起订量（MOQ）

• unit：计价单位

• pic_url：主图

• item_imgs：图集

• skus.sku：SKU 规格、价格、库存

• props：商品属性（材质、风格、适用人群等）

• seller：商家信息、店铺类型、所在地

• desc：商品详情描述

三、1688.item_search 关键词搜索接口解析

1. 必传参数

• q：搜索关键词

• page：页码

• page_size：每页条数（默认 20~40）

2. 可选常用参数

• sort：排序（default /sale/price-asc /price-desc）

• start_price / end_price：价格区间

• is_supply：是否实力商家

• ship_location：发货地

4. 关键字段解析

• total_results：总商品数（用于分页）

• items：商品列表

• sales：销量

• min_order：起批量

• price：批发价

• location：发货地

四、两个接口如何配合使用（最常用业务逻辑）

1. 先用 item_search 关键词搜索 → 拿到一批 num_iid

2. 循环调用 item_get → 逐个获取SKU、库存、详情图、属性

3. 存入数据库 / 用于铺货、选品、比价、上架、亚马逊。

五、你如果需要，我可以直接给你：

1. 可直接运行的 Python/PHP 调用代码

2. Excel 字段映射表（给前端 / 产品看）

3. 统一返回格式封装（适配你自己系统）

4. 批量采集脚本