电商淘宝Tmall1688拼多多抖音API接口用ID测试,采集数据开发系列

165 阅读6分钟

item_get-获得ID详情

image.png

 公共参数

API测试工具

名称类型必须描述
keyString调用key(必须以GET方式拼接在URL中)
secretString调用密钥
api_nameStringAPI接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等]
cacheString[yes,no]默认yes,将调用缓存的数据,速度比较快
result_typeString[json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读
langString[cn,en,ru]翻译语言,默认cn简体中文
versionStringAPI版本

请求参数

请求参数:num_iid=679354643228&is_promotion=1

参数说明:num_iid:淘宝商品ID
is_promotion:是否获取取促销价

响应参数

Version: Date:2022-04-04

名称类型必须示例值描述
itemitem[]1宝贝详情数据
num_iidBigint1520813250866宝贝ID
titleString1三刃木折叠刀过安检创意迷你钥匙扣钥匙刀军刀随身多功能小刀包邮宝贝标题
desc_shortString0商品简介
promotion_priceInt0优惠价
priceFloat125.8价格
total_priceFloat00
suggestive_priceFloat00
orginal_priceString025.80原价
nickString0欢乐购客栈掌柜昵称
numInt03836库存
min_numInt00最小购买数
detail_urlString0item.taobao.com/item.htm?id…宝贝链接
pic_urlString1//gd2.alicdn.com/imgextra/i4/2596264565/TB2p30elFXXXXXQXpXXXXXXXXXX_!!2596264565.jpg宝贝图片
brandString0三刃木品牌名称
brandIdInt08879363品牌ID
rootCatIdInt050013886顶级分类ID
cidInt150014822
crumbsMix0[]导航菜单
created_timeString0
modified_timeString0
delist_timeString0
descString0商品详情
desc_imgMix0[]商品详情图片
item_imgsMix0item_imgs[]商品图片
item_weightString0
item_sizeString0
locationString0发货地
express_feeFloat00.00快递费用
ems_feeFloat0EMS费用
post_feeFloat0物流费用
shipping_toString0发货至
has_discountBoolean0false是否有优惠
videovideo[]0商品视频
is_virtualString0
sample_idString0商品风格标识ID
is_promotionBoolean0false是否促销
props_nameString01627207:1347647754:颜色分类:长方形带开瓶器+送工具刀卡+链子;1627207:1347647753:颜色分类:椭圆形带开瓶器+送工具刀卡+链子;商品属性名。格式为pid1:vid1:name1:value1;pid1:vid2:name2:value2。
prop_imgsprop_imgs[]0商品属性图片列表
property_aliasString020509:9974422:36;1627207:28326:红色;20509:9975710:38;1627207:28326:红色;20509:9981357:40;1627207:28326:红色销售属性值别名。格式为pid1:vid1:alias1;pid1:vid2:alia2。
propsMix0[{ "name": "产地","value": "中国" }]商品属性
total_soldInt0
skusskus[]0商品规格信息列表
seller_idInt02844096782卖家ID
salesInt0138销量
shop_idInt0151372205店铺ID
props_listMix0{20509:9974422: 尺码:36}商品属性
seller_infoseller_info[]1卖家信息
tmallBoolean0false是否天猫
errorString0错误信息
warningString0警告信息
url_logMix0[]
favcountInt00
fanscountInt00
methodString0item_tmall:pget_item
promo_typeString0
props_imgMix01627207:28326": "//img.alicdn.com/imgextra/i2/2844096782/O1CN01VrjpXt1zyCc9DvERE_!!2844096782.jpg属性图片
shop_itemMix0[]
relate_itemsMix0[]

请求示例Curl PHP PHPsdk JAVA C# Python

-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/taobao/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=520813250866&is_promotion=1"

响应示例

Request address:
api-gw.onebound.cn/taobao/item… &num_iid=679354643228&is_promotion=1&cache=no&&lang=zh-CN&secret=
---------------------------------------
Result Object:
---------------------------------------
{
"item": {
"num_iid": "679354643228",
"title": "日系复古细条纹衬衫男ins潮高级感cityboy长袖衬衣美式少年感外套",
"desc_short": "",
"price": "78.88",
"total_price": 0,
"suggestive_price": 0,
"orginal_price": "136.00",
"nick": "韩立臣旗舰店",
"num": "200",
"min_num": 0,
"detail_url": "item.taobao.com/item.htm?id…         "pic_url": "//img.alicdn.com/imgextra/i1/3839714124/O1CN01zrHz7p1gKq8z2pI7t_!!3839714124-0-lubanu-s.jpg",
"brand": "韩立臣",
"brandId": "1952339657",
"rootCatId": "30",
"cid": "50011123",
"crumbs": [],
"created_time": "",
"modified_time": "",
"delist_time": "",
"desc": "",
"desc_img": [],
"item_imgs": [
{
"url": "//img.alicdn.com/imgextra/i1/3839714124/O1CN01zrHz7p1gKq8z2pI7t_!!3839714124-0-lubanu-s.jpg"
},
{
"url": "//img.alicdn.com/imgextra/i2/3839714124/O1CN01yzkVal1gKq93vf7Gv_!!3839714124-0-lubanu-s.jpg"
},
{
"url": "//img.alicdn.com/imgextra/i2/3839714124/O1CN01ej4WsE1gKq8z2pI9e_!!3839714124-0-lubanu-s.jpg"
},
{
"url": "//img.alicdn.com/imgextra/i3/3839714124/O1CN018d9K4n1gKq8zt91lE_!!3839714124-0-lubanu-s.jpg"
},
{
"url": "//img.alicdn.com/imgextra/i1/3839714124/O1CN01vhMExu1gKq8wK5f6Q_!!3839714124-0-lubanu-s.jpg"
}
],
"item_weight": "",
"item_size": "",
"location": "浙江杭州",
"post_fee": 0,
"express_fee": null,
"ems_fee": "",
"shipping_to": "",
"has_discount": "true",
"video": [],
"is_virtual": "",
"sample_id": "",
"is_promotion": "true",
"props_name": "20509:28315:尺码:M;20509:28316:尺码:L;20509:28317:尺码:XL;1627207:28320:颜色:白色;1627207:28341:颜色:黑色;1627207:28338:颜色:蓝色",
"prop_imgs": {
"prop_img": [
{
"properties": "1627207:28320",
"url": "//img.alicdn.com/imgextra/i3/3839714124/O1CN01a6VhRL1gKq8zXkajq_!!3839714124.jpg"
},
{
"properties": "1627207:28341",
"url": "//img.alicdn.com/imgextra/i3/3839714124/O1CN01nwmdTQ1gKq8jQ2rjs_!!3839714124.jpg"
},
{
"properties": "1627207:28338",
"url": "//img.alicdn.com/imgextra/i3/3839714124/O1CN01kXKFoT1gKq90Jqhhm_!!3839714124.jpg"
}
]
},
"property_alias": "",
"props": [
{
"name": "品牌",
"value": "韩立臣"
},
{
"name": "尺码",
"value": "M L XL"
},
{
"name": "面料分类",
"value": "牛津布"
},
{
"name": "图案",
"value": "条纹"
},
{
"name": "领型",
"value": "古巴领"
},
{
"name": "颜色",
"value": "白色 黑色 蓝色"
},
{
"name": "货号",
"value": "HLC-CS160 7.15"
},
{
"name": "细分风格",
"value": "美式休闲"
},
{
"name": "基础风格",
"value": "青春流行"
},
{
"name": "适用季节",
"value": "夏季"
},
{
"name": "上市年份季节",
"value": "2022年秋季"
},
{
"name": "袖长",
"value": "长袖"
},
{
"name": "厚薄",
"value": "薄款"
},
{
"name": "适用场景",
"value": "其他休闲"
},
{
"name": "版型",
"value": "宽松型"
},
{
"name": "服装款式细节",
"value": "拼色 纽扣装饰"
},
{
"name": "服饰工艺",
"value": "水洗"
},
{
"name": "适用对象",
"value": "青少年"
},
{
"name": "面料功能",
"value": "柔和光泽"
},
{
"name": "销售渠道类型",
"value": "纯电商(只在线上销售)"
},
{
"name": "材质成分",
"value": "聚对苯二甲酸乙二酯(涤纶)100%"
}
],
"total_sold": "97",
"skus": {
"sku": [
{
"price": "78.88",
"total_price": 0,
"orginal_price": "78.88",
"properties": "20509:28315;1627207:28320",
"properties_name": "20509:28315:尺码:M;1627207:28320:颜色:白色",
"quantity": "200",
"sku_id": "4867954944397"
},
{
"price": "78.88",
"total_price": 0,
"orginal_price": "78.88",
"properties": "20509:28316;1627207:28320",
"properties_name": "20509:28316:尺码:L;1627207:28320:颜色:白色",
"quantity": "200",
"sku_id": "4867954944398"
},
{
"price": "78.88",
"total_price": 0,
"orginal_price": "78.88",
"properties": "20509:28317;1627207:28320",
"properties_name": "20509:28317:尺码:XL;1627207:28320:颜色:白色",
"quantity": "200",
"sku_id": "4867954944399"
},
{
"price": "78.88",
"total_price": 0,
"orginal_price": "78.88",
"properties": "20509:28315;1627207:28341",
"properties_name": "20509:28315:尺码:M;1627207:28341:颜色:黑色",
"quantity": "200",
"sku_id": "4867954944400"
},
{
"price": "78.88",
"total_price": 0,
"orginal_price": "78.88",
"properties": "20509:28316;1627207:28341",
"properties_name": "20509:28316:尺码:L;1627207:28341:颜色:黑色",
"quantity": "200",
"sku_id": "4867954944401"
},
{
"price": "78.88",
"total_price": 0,
"orginal_price": "78.88",
"properties": "20509:28317;1627207:28341",
"properties_name": "20509:28317:尺码:XL;1627207:28341:颜色:黑色",
"quantity": "200",
"sku_id": "4867954944402"
},
{
"price": "78.88",
"total_price": 0,
"orginal_price": "78.88",
"properties": "20509:28315;1627207:28338",
"properties_name": "20509:28315:尺码:M;1627207:28338:颜色:蓝色",
"quantity": "200",
"sku_id": "4867954944403"
},
{
"price": "78.88",
"total_price": 0,
"orginal_price": "78.88",
"properties": "20509:28316;1627207:28338",
"properties_name": "20509:28316:尺码:L;1627207:28338:颜色:蓝色",
"quantity": "200",
"sku_id": "4867954944404"
},
{
"price": "78.88",
"total_price": 0,
"orginal_price": "78.88",
"properties": "20509:28317;1627207:28338",
"properties_name": "20509:28317:尺码:XL;1627207:28338:颜色:蓝色",
"quantity": "200",
"sku_id": "4867954944405"
}
]
},
"seller_id": "3839714124",
"sales": 300,
"shop_id": "244563866",
"props_list": {
"20509:28315": "尺码:M",
"20509:28316": "尺码:L",
"20509:28317": "尺码:XL",
"1627207:28320": "颜色:白色",
"1627207:28341": "颜色:黑色",
"1627207:28338": "颜色:蓝色"
},
"seller_info": {
"nick": "韩立臣旗舰店",
"item_score": "4.7 ",
"score_p": "4.8 ",
"delivery_score": "4.8 ",
"shop_type": "B",
"user_num_id": "3839714124",
"sid": "244563866",
"title": "韩立臣旗舰店",
"zhuy": "shop244563866.taobao.com/",\             "shop_name": "韩立臣旗舰店"
},
"tmall": true,
"error": "",
"warning": "",
"url_log": [],
"fav_count": "742",
"fans_count": "23.5万",
"freight": "快递: 免运费",
"props_imgs": {
"prop_img": [
{
"properties": "1627207:28320",
"url": "//img.alicdn.com/imgextra/i3/3839714124/O1CN01a6VhRL1gKq8zXkajq_!!3839714124.jpg"
},
{
"properties": "1627207:28341",
"url": "//img.alicdn.com/imgextra/i3/3839714124/O1CN01nwmdTQ1gKq8jQ2rjs_!!3839714124.jpg"
},
{
"properties": "1627207:28338",
"url": "//img.alicdn.com/imgextra/i3/3839714124/O1CN01kXKFoT1gKq90Jqhhm_!!3839714124.jpg"
}
]
},
"ddf": "xdl",
"promo_type": null,
"props_img": {
"1627207:28320": "//img.alicdn.com/imgextra/i3/3839714124/O1CN01a6VhRL1gKq8zXkajq
!!3839714124.jpg",
"1627207:28341": "//img.alicdn.com/imgextra/i3/3839714124/O1CN01nwmdTQ1gKq8jQ2rjs_!!3839714124.jpg",
"1627207:28338": "//img.alicdn.com/imgextra/i3/3839714124/O1CN01kXKFoT1gKq90Jqhhm_!!3839714124.jpg"
},
"format_check": "ok",
"shop_item": [],
"relate_items": []
},
"error": "",
"secache": "ad55a3e9517ab6992530e602f1866718",
"secache_time": 1665193877,
"secache_date": "2022-10-08 09:51:17",
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"reason": "",
"error_code": "0000",
"cache": 0,
"api_info": "today:24 max:10000 all[60=24+13+23];expires:2030-12-31",
"execution_time": "1.972",
"server_time": "Beijing/2022-10-08 09:51:17",
"client_ip": "106.6.32.64",
"call_args": {
"num_iid": "679354643228",
"is_promotion": "1"
},
"api_type": "taobao",
"translate_language": "zh-CN",
"translate_engine": "google_new",
"server_memory": "5.97MB",
"request_id": "gw-1.6340d7933e9f9",
"last_id": "1268192070"
}