1688提供了获取1688app上原数据的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目前支持以下基本接口:
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商品分类
请求参数
请求参数:num_iid=533816674053
参数说明:num_iid:1688商品ID
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
item | item[] | 0 | 获取1688app上原数据 |
响应示例
{ "item": { "detailModel": { "detailUrl": "https://g.alicdn.com/takla-group/app-detail/detail/p/index.html?url=http://img02.taobaocdn.com/tfscom/TB1.w1pApT7gK0jSZFpXXaTkpXa", "h5DataModel": { "picPrivateNoAuth": "false" }, "offerId": "610947572360" }, "filterModel": null, "industryOfferDetailModel": null, "layoutProtocol": { "cacheTime": "60", "components": [ { "arrangement": "full_column", "componentData": "{\"componentType\":\"detail_image_banner\",\"trackInfo\":{\"expoData\":\"bizScene@offerDetail^offerId@610947572360^videoId@254600009298^fromSource@offerDetail\",\"uiTrackInfo\":{\"videoPlay\":{\"args\":{\"bizScene\":\"offerDetail\",\"offerId\":\"610947572360\",\"videoId\":\"254600009298\",\"fromSource\":\"offerDetail\",\"expoData\":\"bizScene@offerDetail^offerId@610947572360^videoId@254600009298^fromSource@offerDetail\"}}}},\"data\":{\"isPrivacy\":false,\"offerImgList\":[\"https://cbu01.alicdn.com/img/ibank/2020/063/830/13235038360_979836901.jpg\",\"https://cbu01.alicdn.com/img/ibank/2020/445/748/13819847544_979836901.jpg\",\"https://cbu01.alicdn.com/img/ibank/2020/487/543/13234345784_979836901.jpg\",\"https://cbu01.alicdn.com/img/ibank/2020/296/695/13418596692_979836901.jpg\",\"https://cbu01.alicdn.com/img/ibank/2020/167/778/13462877761_979836901.jpg\"],\"videoUrl\":\"https://cloud.video.taobao.com/play/u/2206619673102/p/2/e/6/t/1/254600009298.mp4\",\"videoId\":254600009298,\"offerInfoModel\":{\"offerId\":610947572360,\"price\":\"799.00\",\"title\":\"厂家直销小米有品Qin2 Pro智能手机学生机老人机备用机小爱同学4G\",\"isFav\":false},\"liveInfoModel\":{},\"offerId\":\"610947572360\",\"trackInfo\":{\"expoData\":\"bizScene@offerDetail^offerId@610947572360^videoId@254600009298^fromSource@offerDetail\",\"uiTrackInfo\":{\"videoPlay\":{\"args\":{\"bizScene\":\"offerDetail\",\"offerId\":\"610947572360\",\"videoId\":\"254600009298\",\"fromSource\":\"offerDetail\",\"expoData\":\"bizScene@offerDetail^offerId@610947572360^videoId@254600009298^fromSource@offerDetail\"}}}}}}", "componentType": "detail_image_banner", "dataBinding": { "apiType": "local", "loadingMethods": "synchro", "needEcode": "false", "needLogin": "false" }, "extraInfo": { "androidDinamicCdnUrl": "https://dinamicx.alibabausercontent.com/pub/detail_image_banner/1599567242431/detail_image_banner.zip", "dinamicTemplateVerion": "11", "iosDinamicCdnUrl": "https://dinamicx.alibabausercontent.com/pub/detail_image_banner/1599567242431/detail_image_banner.zip" }, "id": "591899102037", "renderType": "dinamic", "spmc": "a262eq.8239380.591899102037.0", "styleBinding": { "layoutType": "default", "paddingBottom": "9" }, "templateUrl": "https://dinamicx.alibabausercontent.com/pub/detail_image_banner/1599567242431/detail_image_banner.zip", "type": "view", "version": "11" }, { "arrangement": "full_column", "componentData": "{\"componentType\":\"detail_od_scene_tab\",\"data\":{\"sceneList\":[{\"sceneKey\":\"order\",\"sceneName\":\"现货\"},{\"sceneKey\":\"distribution\",\"sceneName\":\"分销\"}],\"selectedScene\":{\"sceneKey\":\"order\",\"sceneName\":\"现货\"},\"coord\":{\"atmosphere\":\"normal\",\"useCase\":\"1688detail\",\"role\":\"defaultBuyer\",\"business\":\"slsj\",\"channel\":\"dsc\",\"scene\":\"default\"}}}", "componentType": "detail_od_scene_tab", "dataBinding": { "apiType": "local", "loadingMethods": "synchro", "needEcode": "false", "needLogin": "false" }, "id": "591899102121", "renderType": "native", "spmc": "a262eq.8239380.591899102121.0", "type": "view", "version": "0.0.1" }, { "arrangement": "full_column", "componentData": "{\"componentType\":\"detail_od_b_price_title\",\"trackInfo\":{}}", "componentType": "detail_od_b_price_title", "dataBinding": { "apiType": "local", "loadingMethods": "synchro", "needEcode": "false", "needLogin": "false" }, "extraInfo": { "androidDinamicCdnUrl": "https://dinamicx.alibabausercontent.com/pub/detail_od_b_price_title/1605517698992/detail_od_b_price_title.zip", "dinamicTemplateVerion": "5", "iosDinamicCdnUrl": "https://dinamicx.alibabausercontent.com/pub/detail_od_b_price_title/1605517698992/detail_od_b_price_title.zip" }, "id": "591899102038", "renderType": "dinamic", "spmc": "a262eq.8239380.591899102038.0", "templateUrl": "https://dinamicx.alibabausercontent.com/pub/detail_od_b_price_title/1605517698992/detail_od_b_price_title.zip", "type": "view", "version": "5" }, { "arrangement": "full_column", "componentData": "{\"componentType\":\"detail_od_price_default_two\",\"trackInfo\":{},\"data\":{\"needRadius\":true,\"offerId\":610947572360,\"priceBegin\":\"799.00\",\"condition\":\"2部起批\"}}", "componentType": "detail_od_price_default_two", "dataBinding": { "apiType": "local", "loadingMethods": "synchro", "needEcode": "false", "needLogin": "false" }, "extraInfo": { "androidDinamicCdnUrl": "https://dinamicx.alibabausercontent.com/pub/detail_od_price_default_two/1605539744780/detail_od_price_default_two.zip", "dinamicTemplateVerion": "21", "iosDinamicCdnUrl": "https://dinamicx.alibabausercontent.com/pub/detail_od_price_default_two/1605539744780/detail_od_price_default_two.zip" }, "id": "591899102036", "renderType": "dinamic", "spmc": "a262eq.8239380.591899102036.0", "templateUrl": "https://dinamicx.alibabausercontent.com/pub/detail_od_price_default_two/1605539744780/detail_od_price_default_two.zip", "type": "view", "version": "21" }, { "arrangement": "full_column", "componentData": "{\"componentType\":\"detail_od_product_discounts\"}", "componentType": "detail_od_product_discounts", "dataBinding": { "apiType": "local", "loadingMethods": "synchro", "needEcode": "false", "needLogin": "false" }, "extraInfo": { "androidDinamicCdnUrl": "https://dinamicx.alibabausercontent.com/pub/detail_od_product_discounts/1605879993039/detail_od_product_discounts.zip", "dinamicTemplateVerion": "18", "iosDinamicCdnUrl": "https://dinamicx.alibabausercontent.com/pub/detail_od_product_discounts/1605879993039/detail_od_product_discounts.zip" }, "id": "591899102999", "renderType": "dinamic", "spmc": "a262eq.8239380.591899102999.0", "templateUrl": "https://dinamicx.alibabausercontent.com/pub/detail_od_product_discounts/1605879993039/detail_od_product_discounts.zip", "type": "view", "version": "18" }, { "arrangement": "full_column", "componentData": "{}", "componentType": "detail_od_open_vip_tips", "dataBinding": { "apiName": "mtop.taobao.widgetService.getJsonComponent", "apiType": "mtop", "apiVersion": "1.0", "loadingMethods": "synchro", "needEcode": "false", "needLogin": "false", "param": { "cid": "LaunchZhuKeServiceForCard:LaunchZhuKeServiceForCard", "methodName": "execute", "params": { "offerId": "${offerId}", "sceneFlag": "offerDetail", "sellerMemberId": "${sellerMemberId}", "sellerUserId": "${sellerUserId}", "type": "app1688" } } }, "extraInfo": { "androidDinamicCdnUrl": "https://dinamicx.alibabausercontent.com/pub/detail_od_open_vip_tips/1606357022994/detail_od_open_vip_tips.zip", "dinamicTemplateVerion": "4", "iosDinamicCdnUrl": "https://dinamicx.alibabausercontent.com/pub/detail_od_open_vip_tips/1606357022994/detail_od_open_vip_tips.zip" }, "id": "591899102997", "renderType": "dinamic", "spmc": "a262eq.8239380.591899102997.0", "templateUrl": "https://dinamicx.alibabausercontent.com/pub/detail_od_open_vip_tips/1606357022994/detail_od_open_vip_tips.zip", "type": "view", "version": "4" }, { "arrangement": "full_column", "componentData": "{\"componentType\":\"detail_od_company_feature\",\"data\":{\"detail\":\"闪电发货 无忧包换 品质保障\",\"iconUrl\":\"https://gw.alicdn.com/tfs/TB1ouBL1UY1gK0jSZFCXXcwqXXa-236-60.png\",\"iconWidth\":\"59\",\"bgColor\":\"#F3F3F3\",\"textColor\":\"#666666\"}}", "componentType": "detail_od_company_feature", "dataBinding": { "apiType": "local", "loadingMethods": "synchro", "needEcode": "false", "needLogin": "false" }, "extraInfo": { "androidDinamicCdnUrl": "https://dinamicx.alibabausercontent.com/pub/detail_od_company_feature/1605872665159/detail_od_company_feature.zip", "dinamicTemplateVerion": "8", "iosDinamicCdnUrl": "https://dinamicx.alibabausercontent.com/pub/detail_od_company_feature/1605872665159/detail_od_company_feature.zip" }, "id": "591899102998", "renderType": "dinamic", "spmc": "a262eq.8239380.591899102998.0", "templateUrl": "https://dinamicx.alibabausercontent.com/pub/detail_od_company_feature/1605872665159/detail_od_company_feature.zip", "type": "view", "version": "8" }, { "arrangement": "full_column", "componentData": "{\"componentType\":\"detail_od_title\",\"data\":{\"tagList\":[],\"title\":\"厂家直销小米有品Qin2 Pro智能手机学生机老人机备用机小爱同学4G\",\"scrollList\":[{\"prefix\":\"已售\",\"text\":\"30+\",\"textColor\":\"#999999\",\"icon\":\"https://gw.alicdn.com/tfs/TB1i14AeQcx_u4jSZFlXXXnUFXa-33-42.png\",\"suffix\":\"部\",\"highLightTextColor\":\"#FF2900\"},{\"prefix\":\"\",\"text\":\"251\",\"suffix\":\"人想买\",\"textColor\":\"#999999\",\"icon\":\"https://gw.alicdn.com/tfs/TB1i14AeQcx_u4jSZFlXXXnUFXa-33-42.png\",\"highLightTextColor\":\"#FF2900\"}],\"selledNumber\":\"30\",\"wantBuy\":\"251\",\"offerId\":610947572360}}", "componentType": "detail_od_title", "dataBinding": { "apiType": "local", "loadingMethods": "synchro", "needEcode": "false", "needLogin": "false" }, "extraInfo": { "androidDinamicCdnUrl": "https://dinamicx.alibabausercontent.com/pub/detail_od_title/1597926128008/detail_od_title.zip", "dinamicTemplateVerion": "25", "dxAndroidPath": "https://dinamicx.alibabausercontent.com/pub/detail_od_title/1597241497401/detail_od_title.zip", "dxH5Path": "https://dinamicx.alibabausercontent.com/pub/detail_od_title/1597241497401/detail_od_title_h5.js", "dxIosPath": "https://dinamicx.alibabausercontent.com/pub/detail_od_title/1597241497401/detail_od_title.zip", "iosDinamicCdnUrl": "https://dinamicx.alibabausercontent.com/pub/detail_od_title/1597926128008/detail_od_title.zip" }, "id": "591899102996", "renderType": "dinamic", "spmc": "a262eq.8239380.591899102996.0", "templateUrl": "https://dinamicx.alibabausercontent.com/pub/detail_od_title/1597926128008/detail_od_title.zip", "type": "view", "version": "25" }, { "arrangement": "full_column", "componentData": "{}", "componentType": "detail_od_product_feature", "dataBinding": { "apiName": "mtop.taobao.widgetService.getJsonComponent", "apiType": "mtop",
异常示例
{ "error": "item-not-found", "reason": "商品没找到", "error_code": "2000", "success": 0, "cache": 0, "api_info": "today:0 max:10000", "execution_time": 0.081, "server_time": "Beijing/2020-06-10 23:44:00", "call_args": [], "api_type": "taobao", "request_id": "15ee0ffc041242"}
相关资料
错误码解释
状态代码(error_code) | 状态信息 | 详细描述 | 是否收费 |
---|---|---|---|
0000 | success | 接口调用成功并返回相关数据 | 是 |
2000 | Search success but no result | 接口访问成功,但是搜索没有结果 | 是 |
4000 | Server internal error | 服务器内部错误 | 否 |
4001 | Network error | 网络错误 | 否 |
4002 | Target server error | 目标服务器错误 | 否 |
4003 | Param error | 用户输入参数错误 | 忽略 |
4004 | Account not found | 用户帐号不存在 | 忽略 |
4005 | Invalid authentication credentials | 授权失败 | 忽略 |
4006 | API stopped | 您的当前API已停用 | 忽略 |
4007 | Account stopped | 您的账户已停用 | 忽略 |
4008 | API rate limit exceeded | 并发已达上限 | 忽略 |
4009 | API maintenance | API维护中 | 忽略 |
4010 | API not found with these values | API不存在 | 忽略 |
4012 | Please add api first | 请先添加api | 忽略 |
4013 | Number of calls exceeded | 调用次数超限 | 忽略 |
4014 | Missing url param | 参数缺失 | 忽略 |
4015 | Wrong pageToken | 参数pageToken有误 | 忽略 |
4016 | Insufficient balance | 余额不足 | 忽略 |
4017 | timeout error | 请求超时 | 否 |
5000 | unknown error | 未知错误 | 否 |