众所周知，阿里巴巴(1688.com)是全球企业间(B2B)电子商务的著名品牌,为数千万网商提供海量商机信息和便捷安全的在线交易市场,也是商人们以商会友、真实互动的社区平台。工厂货源的优势让它成为很多跨境卖家外贸从业者的首选货源平台。如何实现1688商品自动对接到自己的跨境电商平台，实现一键上货呢？通过电商数据API能够轻松高效的实现。
电商数据API是什么？
API 即应用程序接口（API：Application Program Interface），应用程序接口是一组定义、程序及协议的集合，通过 API 接口实现计算机软件之间的相互通信。
电商数据API则是用于获取电商平台数据的API，一般用于获取商品数据、订单数据、卖家数据、物流信息等。
1688商品采集API
- item_get 获得1688商品详情
- item_search 按关键字搜索商品
- item_search_img 按图搜索1688商品（拍立淘）
- item_search_suggest 获得搜索词推荐
- item_fee 获得商品快递费用
- seller_info 获得店铺详情
- item_search_shop 获得店铺的所有商品
- item_password 获得淘口令真实url
- upload_img 上传图片到1688
- item_search_seller 搜索店铺列表
- img2text 图片识别商品接口
- item_get_app 获取1688app上原数据
- buyer_order_list 获取购买到的商品订单列表
- cat_get 获得1688商品分类
如何获取此API测试？
API调用说明
公共参数
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| 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版本 |
每个API的请求参数不一样，具体可见API文档！
商品详情页可返回数据表
Version: Date:
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| item | item[] | 0 | 宝贝详情数据 | |
| num_iid | String | 0 | 610947572360 | 宝贝ID |
| title | String | 0 | 厂家直销小米有品Qin2 Pro智能手机学生机老人机备用机小爱同学4G | 商品标题 |
| desc_short | String | 0 | 商品简介 | |
| price | Float | 0 | 799.00 | 价格 |
| total_price | Float | 0 | 0 | |
| suggestive_price | Float | 0 | 0 | |
| orginal_price | Float | 0 | 799.00 | 原价 |
| nick | String | 0 | qin多亲科技(_sopid@BBBSvyqimnYtLnmm90B_59dsg) | 卖家昵称(以上2种参数都有可能输出，凡是_sopid@开头的即为加密openid) |
| num | Int | 0 | 2191 | |
| min_num | Int | 0 | 2 | 最小起批量 |
| detail_url | String | 0 | https://detail.1688.com/offer/610947572360.html | 宝贝链接 |
| pic_url | String | 0 | https://cbu01.alicdn.com/img/ibank/2020/063/830/13235038360_979836901.jpg | 宝贝图片 |
| brand | String | 0 | MAJE | 品牌 |
| brandId | Int | 0 | 8879363 | 品牌id |
| rootCatId | Int | 0 | 0 | 顶级分类ID |
| cid | Int | 0 | 124264005 | |
| desc | String | 0 | ||
| item_imgs | Mix | 0 | item_imgs[] | 商品图片 |
| item_weight | String | 0 | ||
| post_fee | Float | 0 | 9.00 | 邮费 |
| express_fee | Float | 0 | 9.00 | EMS费用 |
| ems_fee | Float | 0 | 9.00 | 物流费用 |
| shipping_to | String | 0 | 广东广州白云区 | 发货至 |
| video | video[] | 0 | 商品视频 | |
| sample_id | String | 0 | ||
| props_name | String | 0 | 0:0:机身内存:64GB;1:0:颜色:铁灰色;1:1:颜色:瓷白色 | 商品属性名 |
| prop_imgs | prop_imgs[] | 0 | 商品属性图片列表 | |
| property_alias | String | 0 | 0:0:64GB;1:0:铁灰色;1:1:瓷白色 | 属性别名 |
| props | Mix | 0 | [{"name": "品牌", "value": "other"}] | 商品详情 |
| total_sold | Int | 0 | 1 | |
| scale | Int | 0 | ||
| sellUnit | Int | 0 | ||
| skus | skus[] | 0 | 商品规格信息列表 | |
| seller_id | Int | 0 | 2206619673102 | 卖家ID |
| sales | Int | 0 | 100 | 销售额 |
| shop_id | Int | 0 | 151372205 | 店铺ID |
| props_list | Mix | 0 | {"0:0": "机身内存:64GB"} | 商品属性 |
| tmall | Boolean | 0 | false | 是否天猫 |
| data_from | String | 0 | 1688app | 错误信息 |
| error | String | 0 | 错误信息 | |
| unit | String | 0 | 部; | 单位 |
| is_support_mix | Boolean | 0 | true | |
| mix_amount | Int | 0 | 30 | |
| mix_Begin | Int | 0 | ||
| mix_number | Int | 0 | ||
| sales_data | Date | 0 | ||
| location | String | 0 | 广东省 深圳市 | 发货地 |
| props_img | Mix | 0 | 属性图片 | |
| sales_info | Mix | 0 | ||
| desc_img | Mix | 0 | [{"https://cbu01.alicdn.com/img/ibank/2020/560/807/14112708065_979836901.jpg"}] | 详情图片列表 |
| shop_item | Mix | 0 | ||
| relate_items | Mix | 0 |
