1688官方跨境寻源通API接口调用实战
11月19日1688跨境“寻源通”产品发布会，当时的介绍是：1688跨境“寻源通”分别针对跨境ERP、跨境代采商、跨境超买和SaaS,为他们提供基于 AI 技术的搜索比价引擎,通过和官方合作把1688 的1亿+官方源头货铺盘出去。
这个模式有点类似大一号的跨境电商无货源模式，原先是针对单个电商的，现在呢是针对网站和服务商的，提供了无商品模式，直接接入1688货品就显得很丰满了，也和以前的广告商品导流模式类似，但放更大了。
- 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商品分类
公共参数
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| 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 | 宝贝详情数据 | |
num_iid | String | 0 | 610947572360 | 宝贝ID |
title | String | 0 | 厂家直销小米有品Qin2 Pro智能手机学生机老人机备用机小爱同学4G | 商品标题 |
desc_short | String | 0 | ||
price | Float | 1 | 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 | 宝贝图片 |
rootCatId | Int | 0 | 0 | 顶级分类ID |
cid | Int | 0 | 124264005 | |
desc | String | 0 | ||
item_imgs | Mix | 0 | item_imgs[] | 商品图片 |
item_weight | 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 |
