公共参数:https://o0b.cn/iinoah
名称 |
类型 |
必须 |
描述 |
key |
String |
是 |
调用key(前往获取key和secret) |
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=264070136/5637247041&country=.com.my
参数说明:num_iid:商品ID-country:网站后缀(.com.my;.vn;.ph)
响应参数
Version: Date:
名称 |
类型 |
必须 |
示例值 |
描述 |
num_iid |
Bigint |
0 |
宝贝ID |
|
title |
String |
0 |
宝贝标题 |
|
price |
Float |
0 |
价格 |
|
orginal_price |
String |
0 |
原价 |
|
num |
Int |
0 |
库存 |
|
detail_url |
String |
0 |
宝贝链接 |
|
pic_url |
String |
0 |
宝贝图片 |
|
brand |
String |
0 |
品牌名称 |
|
favcount |
Int |
0 |
||
desc |
String |
0 |
||
skus |
Mix |
0 |
商品规格信息列表 |
|
has_discount |
String |
0 |
||
item_size |
String |
0 |
||
cid |
Int |
0 |
||
currency |
String |
0 |
||
size_chart |
String |
0 |
||
sales |
Int |
0 |
销量 |
|
item_imgs |
Mix |
0 |
商品图片 |
|
discount |
String |
0 |
||
location |
String |
0 |
发货地 |
|
shop_id |
Int |
0 |
店铺ID |
|
seller_info |
Mix |
0 |
卖家信息 |
|
prop_imgs |
Mix |
0 |
属性图片 |
|
props_list |
Mix |
0 |
商品属性 |
|
props_name |
String |
0 |
商品属性名 |
|
props |
Mix |
0 |
商品详情 |
|
current_lang |
String |
0 |
||
currency_code |
String |
0 |
||
props_img |
Mix |
0 |
属性图片 |
|
shop_item |
Mix |
0 |
||
relate_items |
Mix |
0 |
||
tmall |
Boolean |
0 |
是否天猫 |
|
error |
String |
0 |
错误信息 |
|
warning |
String |
0 |
警告信息 |
|
url_log |
Mix |
0 |
||
method |
String |
0 |
||
promo_type |
String |
0 |
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/shopee/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=264070136/5637247041&country=.com.my"
响应示例
{
"item": {
"num_iid": 5637247041,
"title": "Fashionable plus size women's dress 2020 new spring and summer dress was thin and thin and fat sister dress two-piece suit",
"detail_url": "https://shopee.com.my/Fashionable plus size women's dress 2020 new spring and summer dress was thin and thin and fat sister dress two-piece suit-i.264070136.5637247041?",
"pic_url": "https://cf.shopee.com.my/file/f8bc1116ea922e5ed87a492390b1cc1a",
"price": 31.68,
"orginal_price": 31.68,
"cid": 100017,
"desc": "Brand: Other/Other\nStyle: Sweet and Fresh/College\nPopular elements: buttons, gauze, stitching\nStyle: skirt suit\nsleeve length: short sleeve\nFabric/Material: Other/Polyester (Polyester Fiber)\nIngredient content: 71% (inclusive)-80% (inclusive)\nWhether to add cashmere: no cashmere\nTime to market: Spring 2020\nDelivery time:\nShipped on the same day before subscripting at 18:00 every day,\nIt is estimated that it will take 4-10 days for normal goods to arrive at your hands\n\nMasa penghantaran\nDihantar pada hari yang sama sebelum pukul 18:00 setiap hari\nDihantar keesokan harinya selepas jam 18:00.\nDianggarkan memerlukan masa 4-10 hari untuk barang biasa sampai tangan anda\n\nPakaian wanita bersaiz plus bergaya.Pakaian musim bunga dan musim panas dalam 2020 yang baru\nkurus dan gemuk itu berpakaian yg dua keping
",
"item_imgs": [
{
"url": "https://cf.shopee.com.my/file/f8bc1116ea922e5ed87a492390b1cc1a"
},
{
"url": "https://cf.shopee.com.my/file/c0d49dfae84b81468269a17714742adb"
},
{
"url": "https://cf.shopee.com.my/file/f4dd56edbe0ccc13ca2cba0d6ba5167a"
},
{
"url": "https://cf.shopee.com.my/file/35f35de0d5826c4969a42483b34d8bea"
},
{
"url": "https://cf.shopee.com.my/file/14b7804a2a87c70fa763c518ce6ec583"
},
{
"url": "https://cf.shopee.com.my/file/e1bc3fe36abc09c00ead17243b9825f0"
},
{
"url": "https://cf.shopee.com.my/file/ab490d68394575366c36cee16ad0f86e"
},
{
"url": "https://cf.shopee.com.my/file/a6148259a00b460f5e30ba04a327f9a3"
},
{
"url": "https://cf.shopee.com.my/file/e1bc5d2bb3c010af4f688e6f22a63eca"
}
],
"props": [
{
"name": "Plus Size",
"value": "Yes"
},
{
"name": "Dress/Skirt Length",
"value": "Midi"
}
],
"props_list": {
"17518:17571": "颜色分类:T-shirt+skirt",
"17518:17818": "颜色分类:T-shirt",
"17518:17889": "颜色分类:skirt",
"17936:17942": "尺码:M 建议【42.5-50KG】",
"17936:17998": "尺码:L 建议 【50-57.5kg】",
"17936:18033": "尺码:XL 【建议57.5-65kg】",
"17936:18085": "尺码:2XL 【建议65-72.5kg】",
"17936:18132": "尺码:3XL 【建议72.5-82.5kg】",
"17936:18167": "尺码:4XL【建议82.5-90kg】"
},
"prop_imgs": {
"prop_img": [
{
"properties": "17518:17571",
"url": "https://cf.shopee.com.my/file/81bea46afa4113012b7330cc3c846428"
},
{
"properties": "17518:17818",
"url": "https://cf.shopee.com.my/file/c0d49dfae84b81468269a17714742adb"
},
{
"properties": "17518:17889",
"url": "https://cf.shopee.com.my/file/f4dd56edbe0ccc13ca2cba0d6ba5167a"
}
]
},
"props_imgs": {
"prop_img": [
{
"properties": "17518:17571",
"url": "https://cf.shopee.com.my/file/81bea46afa4113012b7330cc3c846428"
},
{
"properties": "17518:17818",
"url": "https://cf.shopee.com.my/file/c0d49dfae84b81468269a17714742adb"
},
{
"properties": "17518:17889",
"url": "https://cf.shopee.com.my/file/f4dd56edbe0ccc13ca2cba0d6ba5167a"
}
]
},
"props_name": "17518:17571:颜色分类:T-shirt+skirt;17518:17571:颜色分类:T-shirt+skirt;17518:17571:颜色分类:T-shirt+skirt;17518:17571:颜色分类:T-shirt+skirt;17518:17571:颜色分类:T-shirt+skirt;17518:17571:颜色分类:T-shirt+skirt;17518:17818:颜色分类:T-shirt;17518:17818:颜色分类:T-shirt;17518:17818:颜色分类:T-shirt;17518:17818:颜色分类:T-shirt;17518:17818:颜色分类:T-shirt;17518:17818:颜色分类:T-shirt;17518:17889:颜色分类:skirt;17518:17889:颜色分类:skirt;17518:17889:颜色分类:skirt;17518:17889:颜色分类:skirt;17518:17889:颜色分类:skirt;17518:17889:颜色分类:skirt;17936:17942:尺码:M 建议【42.5-50KG】;17936:17998:尺码:L 建议 【50-57.5kg】;17936:18033:尺码:XL 【建议57.5-65kg】;17936:18085:尺码:2XL 【建议65-72.5kg】;17936:18132:尺码:3XL 【建议72.5-82.5kg】;17936:18167:尺码:4XL【建议82.5-90kg】;17936:17942:尺码:M 建议【42.5-50KG】;17936:17998:尺码:L 建议 【50-57.5kg】;17936:18033:尺码:XL 【建议57.5-65kg】;17936:18085:尺码:2XL 【建议65-72.5kg】;17936:18132:尺码:3XL 【建议72.5-82.5kg】;17936:18167:尺码:4XL【建议82.5-90kg】;17936:17942:尺码:M 建议【42.5-50KG】;17936:17998:尺码:L 建议 【50-57.5kg】;17936:18033:尺码:XL 【建议57.5-65kg】;17936:18085:尺码:2XL 【建议65-72.5kg】;17936:18132:尺码:3XL 【建议72.5-82.5kg】;17936:18167:尺码:4XL【建议82.5-90kg】",
"desc_img": [],
"location": null,
"post_fee": "",
"skus": {
"sku": [
{
"price": 63.36,
"total_price": 0,
"orginal_price": 63.36,
"properties": "17518:17571;17936:17942",
"properties_name": "17518:17571:颜色分类:T-shirt+skirt;17936:17942:尺码:M 建议【42.5-50KG】",
"quantity": 982,
"sku_id": null
},
{
"price": 63.36,
"total_price": 0,
"orginal_price": 63.36,
"properties": "17518:17571;17936:17998",
"properties_name": "17518:17571:颜色分类:T-shirt+skirt;17936:17998:尺码:L 建议 【50-57.5kg】",
"quantity": 983,
"sku_id": null
},
{
"price": 63.36,
"total_price": 0,
"orginal_price": 63.36,
"properties": "17518:17571;17936:18033",
"properties_name": "17518:17571:颜色分类:T-shirt+skirt;17936:18033:尺码:XL 【建议57.5-65kg】",
"quantity": 992,
"sku_id": null
},
{
"price": 63.36,
"total_price": 0,
"orginal_price": 63.36,
"properties": "17518:17571;17936:18085",
"properties_name": "17518:17571:颜色分类:T-shirt+skirt;17936:18085:尺码:2XL 【建议65-72.5kg】",
"quantity": 989,
"sku_id": null
},
{
"price": 63.36,
"total_price": 0,
"orginal_price": 63.36,
"properties": "17518:17571;17936:18132",
"properties_name": "17518:17571:颜色分类:T-shirt+skirt;17936:18132:尺码:3XL 【建议72.5-82.5kg】",
"quantity": 992,
"sku_id": null
},
{
"price": 63.36,
"total_price": 0,
"orginal_price": 63.36,
"properties": "17518:17571;17936:18167",
"properties_name": "17518:17571:颜色分类:T-shirt+skirt;17936:18167:尺码:4XL【建议82.5-90kg】",
"quantity": 985,
"sku_id": null
},
{
"price": 38.08,
"total_price": 0,
"orginal_price": 38.08,
"properties": "17518:17818;17936:17942",
"properties_name": "17518:17818:颜色分类:T-shirt;17936:17942:尺码:M 建议【42.5-50KG】",
"quantity": 998,
"sku_id": null
},
{
"price": 38.08,
"total_price": 0,
"orginal_price": 38.08,
"properties": "17518:17818;17936:17998",
"properties_name": "17518:17818:颜色分类:T-shirt;17936:17998:尺码:L 建议 【50-57.5kg】",
"quantity": 999,
"sku_id": null
},
{
"price": 38.08,
"total_price": 0,
"orginal_price": 38.08,
"properties": "17518:17818;17936:18033",
"properties_name": "17518:17818:颜色分类:T-shirt;17936:18033:尺码:XL 【建议57.5-65kg】",
"quantity": 1000,
"sku_id": null
},
{
"price": 38.08,
"total_price": 0,
"orginal_price": 38.08,
"properties": "17518:17818;17936:18085",
"properties_name": "17518:17818:颜色分类:T-shirt;17936:18085:尺码:2XL 【建议65-72.5kg】",
"quantity": 999,
"sku_id": null
},
{
"price": 38.08,
"total_price": 0,
"orginal_price": 38.08,
"properties": "17518:17818;17936:18132",
"properties_name": "17518:17818:颜色分类:T-shirt;17936:18132:尺码:3XL 【建议72.5-82.5kg】",
"quantity": 999,
"sku_id": null
},
{
"price": 38.08,
"total_price": 0,
"orginal_price": 38.08,
"properties": "17518:17818;17936:18167",
"properties_name": "17518:17818:颜色分类:T-shirt;17936:18167:尺码:4XL【建议82.5-90kg】",
"quantity": 998,
"sku_id": null
},
{
"price": 31.68,
"total_price": 0,
"orginal_price": 31.68,
"properties": "17518:17889;17936:17942",
"properties_name": "17518:17889:颜色分类:skirt;17936:17942:尺码:M 建议【42.5-50KG】",
"quantity": 1000,
"sku_id": null
},
{
"price": 31.68,
"total_price": 0,
"orginal_price": 31.68,
"properties": "17518:17889;17936:17998",
"properties_name": "17518:17889:颜色分类:skirt;17936:17998:尺码:L 建议 【50-57.5kg】",
"quantity": 1000,
"sku_id": null
},
{
"price": 31.68,
"total_price": 0,
"orginal_price": 31.68,
"properties": "17518:17889;17936:18033",
"properties_name": "17518:17889:颜色分类:skirt;17936:18033:尺码:XL 【建议57.5-65kg】",
"quantity": 997,
"sku_id": null
},
{
"price": 31.68,
"total_price": 0,
"orginal_price": 31.68,
"properties": "17518:17889;17936:18085",
"properties_name": "17518:17889:颜色分类:skirt;17936:18085:尺码:2XL 【建议65-72.5kg】",
"quantity": 998,
"sku_id": null
},
{
"price": 31.68,
"total_price": 0,
"orginal_price": 31.68,
"properties": "17518:17889;17936:18132",
"properties_name": "17518:17889:颜色分类:skirt;17936:18132:尺码:3XL 【建议72.5-82.5kg】",
"quantity": 999,
"sku_id": null
},
{
"price": 31.68,
"total_price": 0,
"orginal_price": 31.68,
"properties": "17518:17889;17936:18167",
"properties_name": "17518:17889:颜色分类:skirt;17936:18167:尺码:4XL【建议82.5-90kg】",
"quantity": 997,
"sku_id": null
}
]
},
"num": 17907,
"seller_id": null,
"shop_id": "",
"nick": null,
"sales": 0,
"total_sold": "-1",
"seller_info": {
"nick": null,
"item_score": null,
"score_p": null,
"delivery_score": null,
"shop_type": "",
"user_num_id": null,
"sid": "",
"title": "",
"zhuy": "https://my.xiapibuy.com/qzq1274334183.my",
"cert": null,
"open_time": "",
"credit_score": null,
"shop_name": "Big size women's fashion "
},
"data_from": "Ha",
"props_img": {
"17518:17571": "https://cf.shopee.com.my/file/81bea46afa4113012b7330cc3c846428",
"17518:17818": "https://cf.shopee.com.my/file/c0d49dfae84b81468269a17714742adb",
"17518:17889": "https://cf.shopee.com.my/file/f4dd56edbe0ccc13ca2cba0d6ba5167a"
},
"format_check": "ok",
"shop_item": [],
"relate_items": []
},
"error": "",
"secache": "da67365cb819d7c288d8451ffd8c3692",
"secache_time": 1679553490,
"secache_date": "2023-03-23 14:38:10",
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"reason": "",
"error_code": "0000",
异常示例
{
"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 |
未知错误 |
否 |