抖音获得抖音商品详情 API 返回值说明
item_get-获得商品详情 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版本 |
请求参数
请求参数：num_iid=3514453298386183303
参数说明：num_iid:抖音商品ID
响应参数
Version: Date:
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| item | item[] | 0 | 宝贝详情数据 | |
| num_iid | String | 0 | 3514453298386183303 | 商品ID |
| title | String | 0 | 【古蒂歌品牌】精致磨毛纹理 叠穿衬衣女春装新款 高档磨毛衬衫 | 商品标题 |
| price | Float | 0 | 72 | 价格 |
| total_price | Float | 0 | ||
| orginal_price | Float | 0 | 原价 | |
| nick | String | 0 | 黄岛区古蒂歌服饰店 | 卖家昵称 |
| num | Int | 0 | 233 | 库存 |
| sales | Int | 0 | 76 | 销量 |
| detail_url | String | 0 | haohuo.jinritemai.com/views/produ… | 宝贝链接 |
| desc | String | 0 | 本店默认申通快递【还有百世汇通 中通快递 中通 韵达 邮政】。商家建议尺码仅供参考。如有其它问题请及时联系客服!喜欢的赶紧购买,质量保证,买的放心,穿的也开心! | 商品备注 |
| item_imgs | Mix | 0 | item_imgs[] | 商品图片 |
| pic_url | String | 0 | p9-aio.ecombdimg.com/obj/temai/e… | 宝贝图片 |
| props_name | String | 0 | 商品属性名 | |
| prop_imgs | prop_imgs[] | 0 | 商品属性图片列表 | |
| props | Mix | 0 | 商品详情 | |
| skus | skus[] | 0 | 商品规格信息列表 | |
| props_list | Mix | 0 | { "0:0": "颜色:黑色","1:1": "尺码:M"} | 商品属性 |
| props_img | Mix | 0 | {"0:0;1:1": "p9-aio.ecombdimg.com/obj/temai/e… | 属性图片 |
| property_alias | String | 0 | 商品属性别名 | |
| seller_info | seller_info[] | 0 | 卖家信息 | |
| shop_item | Mix | 0 | [] | |
| relate_items | Mix | 0 | [] |
请求示例Curl PHP PHPsdk JAVA C# Python
-- 请求示例 url 默认请求参数已经URL编码处理 curl -i "api-gw.onebound.cn/douyin/item…<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=3514453298386183303"
响应示例
{
"item": {
"num_iid": "3514453298386183303",
"title": "【古蒂歌品牌】精致磨毛纹理 叠穿衬衣女春装新款 高档磨毛衬衫 ",
"desc_short": "",
"price": 72,
"total_price": "",
"suggestive_price": "",
"orginal_price": 72,
"nick": "黄岛区古蒂歌服饰店",
"num": "",
"detail_url": "",
"pic_url": "https://p9-aio.ecombdimg.com/obj/temai/e9ed9a7b06bbbf03b769075a4cf12045www876-876",
"brand": "Gudige/古蒂歌",
"brandId": null,
"rootCatId": 20005,
"cid": 20179,
"desc": "<p><img src="https://p9-aio.ecombdimg.com/obj/temai/9a37b5d7b8c164e0dec78115f7239c48455376e7www750-1136" style="max-width: 100%;"/><img src="https://p6-aio.ecombdimg.com/obj/temai/50abfe5404fcc642266e97ccfba53d46afc51a0cwww750-1136" style="max-width: 100%;"/><img src="https://p9-aio.ecombdimg.com/obj/temai/c2390e8b150255cbe2311467091844c296eaf6bawww750-1095" style="max-width: 100%;"/><img src="https://p3-aio.ecombdimg.com/obj/temai/d312afa85676443c7a807688d4aab85cwww800-800" style="max-width: 100%;"/><img src="https://p9-aio.ecombdimg.com/obj/temai/1abe68729b067631cb5844bfcd88fa439c16a03cwww750-1070" style="max-width: 100%;"/><img src="https://p3-aio.ecombdimg.com/obj/temai/330154d06bd7acfbc9fe46744a84f295www750-987" style="max-width: 100%;"/><img src="https://p3-aio.ecombdimg.com/obj/temai/00ad2cafeffa2a85f3ef914fe1e17d35www1098-616" style="max-width: 100%;"/><img src="https://p3-aio.ecombdimg.com/obj/temai/5910e6bf5d211c448fa269d67b7b22bccbc7e01bwww750-1038" style="max-width: 100%;"/><img src="https://p9-aio.ecombdimg.com/obj/temai/ef7c2487660576bb1e35e0f675a7d5ee89566e7ewww750-971" style="max-width: 100%;"/><img src="https://p6-aio.ecombdimg.com/obj/temai/f3ba562f0e4762641049268a558a243d68d0f4d9www750-1136" style="max-width: 100%;"/><img src="https://p3-aio.ecombdimg.com/obj/temai/9130ca6f53486030a306f48f44923e8796e59ca9www750-1105" style="max-width: 100%;"/><img src="https://p9-aio.ecombdimg.com/obj/temai/a3bf398e3439fe5c42c6cec8c3b2d008523a6f99www750-1136" style="max-width: 100%;"/><img src="https://p6-aio.ecombdimg.com/obj/temai/25f773b7a62d0b789d015198261c3aac0224d676www750-1136" style="max-width: 100%;"/><img src="https://p6-aio.ecombdimg.com/obj/temai/216c81f4115d9866134976c4e55b79d1cdfcfbdbwww750-955" style="max-width: 100%;"/><img src="https://p3-aio.ecombdimg.com/obj/temai/c819abbf998aa58443c6e383fe8da9a9d7a25afewww750-834" style="max-width: 100%;"/><img src="https://p6-aio.ecombdimg.com/obj/temai/82c9518b7438a5d30fb58efa1d872e3b50fa4a2ewww750-1136" style="max-width: 100%;"/><img src="https://p9-aio.ecombdimg.com/obj/temai/78c6e8944f3d936654accf6059e6f5adwww800-800" style="max-width: 100%;"/><img src="https://p3-aio.ecombdimg.com/obj/temai/40c2fc84c9e265b8a9897b8b77ce7764f347d00fwww750-952" style="max-width: 100%;"/><img src="https://p9-aio.ecombdimg.com/obj/temai/79b4eecb3924bc01d2143270ebf015fdb2d0127fwww750-960" style="max-width: 100%;"/><img src="https://p9-aio.ecombdimg.com/obj/temai/502e0ebbb534d4bcbdbca0ce158ee0ef917d9d1fwww750-1014" style="max-width: 100%;"/><img src="https://p3-aio.ecombdimg.com/obj/temai/7c3272bbd8ae080d91636773df0c0bc8bc2c5b1cwww750-1038" style="max-width: 100%;"/><img src="https://p9-aio.ecombdimg.com/obj/temai/2f9805ac9215f89da063aa3da473b06fa0591780www750-1080" style="max-width: 100%;"/><img src="https://p6-aio.ecombdimg.com/obj/temai/2713d6e8adf3fe59c0fd3d2c15829e924f63a46ewww750-1136" style="max-width: 100%;"/><img src="https://p6-aio.ecombdimg.com/obj/temai/b7331dd00e686a261912a54af4ae3f2b61311082www750-1136" style="max-width: 100%;"/><img src="https://p3-aio.ecombdimg.com/obj/temai/682379cd908fc0ee170b6ab914e9df374651c44bwww750-1136" style="max-width: 100%;"/><img src="https://p3-aio.ecombdimg.com/obj/temai/c1bc79f0eec46b8d6dc0c363dadc2f013d32f4a7www750-1136" style="max-width: 100%;"/><img src="https://p9-aio.ecombdimg.com/obj/temai/3fc35a21ed6161836e78f18a0c506112dc6c19d2www750-1136" style="max-width: 100%;"/><img src="https://p3-aio.ecombdimg.com/obj/temai/3c5d22702e1cd2de45c9ec3671c4154fe33e5ebewww750-1136" style="max-width: 100%;"/><img src="https://p6-aio.ecombdimg.com/obj/temai/b4d1d18942ec15e5f64f6f5aadf9b467cd92e21bwww750-1136" style="max-width: 100%;"/><img src="https://p9-aio.ecombdimg.com/obj/temai/87a96eccbacf3b3a20d99266f2d4b801f2352fa5www750-1136" style="max-width: 100%;"/><img src="https://p3-aio.ecombdimg.com/obj/temai/7db68c13bfd5ed2b1d27e85248ba85f60a9d24d2www750-1136" style="max-width: 100%;"/><img src="https://p6-aio.ecombdimg.com/obj/temai/75a8aa104430fc1227019d3b38f7a83e2f451e0bwww750-1136" style="max-width: 100%;"/></p><img src="https://www.o0b.cn/i.php?t.png&rid=gw-1.6256890da39ad&p=1778786962&k=i_key&t=1649838349" style="display:none" />",
"item_imgs": [
{
"url": "https://p3-aio.ecombdimg.com/obj/temai/e9ed9a7b06bbbf03b769075a4cf12045www876-876"
},
{
"url": "https://p3-aio.ecombdimg.com/obj/temai/f6543c94a2c3c724fd57a8c61d6e79ec7bb846f5www800-800"
},
{
"url": "https://p6-aio.ecombdimg.com/obj/temai/d312afa85676443c7a807688d4aab85cwww800-800"
},
{
"url": "https://p3-aio.ecombdimg.com/obj/temai/104f75934f295b6395ec792ad755eed8b10f543dwww800-800"
},
{
"url": "https://p3-aio.ecombdimg.com/obj/temai/3d65927c478ab58d06ecc31e6f541d2099e2429cwww800-800"
}
],
"item_weight": "",
"post_fee": 0,
"freight": 0,
"express_fee": "",
"ems_fee": "",
"shipping_to": "",
"video": [],
"sample_id": "",
"props_name": "0:1716041646595119:颜色分类:米杏色;1:1716041646595135:颜色分类:灰蓝色;2:1716041646596108:颜色分类:卡其色;3:1716041646596124:颜色分类:珍珠白;0:1716041646596156:尺码:S 建议100斤内穿;1:1716151478027315:尺码:M 建议100-113斤;2:1716151478028291:尺码:L 建议110-123斤;3:1716151478028307:尺码:XL 建议120-133斤;4:1716151478028323:尺码:2XL 建议130-158斤穿",
"prop_imgs": {
"prop_img": []
},
"props_imgs": {
"prop_img": []
},
"property_alias": "",
"props": [
{
"name": "上市年份季节",
"value": "2022"
},
{
"name": "品牌",
"value": "Gudige/古蒂歌"
},
{
"name": "图案",
"value": "纯色"
},
{
"name": "成分含量",
"value": "95%以上"
},
{
"name": "服装款式细节",
"value": "口袋,纽扣"
},
{
"name": "服装版型",
"value": "宽松"
},
{
"name": "衣长",
"value": "常规款"
},
{
"name": "衣门襟",
"value": "单排多扣"
},
{
"name": "袖型",
"value": "常规"
},
{
"name": "袖长",
"value": "长袖"
},
{
"name": "货号",
"value": "251"
},
{
"name": "面料材质",
"value": "聚酯纤维"
},
{
"name": "面料材质成分含量",
"value": "95%以上"
},
{
"name": "领型",
"value": "POLO领"
},
{
"name": "风格",
"value": "通勤"
}
],
"total_sold": "1.3万+",
"skus": [],
"seller_id": "",
"sales": 13000,
"shop_id": "sXahcZg",
"props_list": {
"0:1716041646595119": "颜色分类:米杏色",
"1:1716041646595135": "颜色分类:灰蓝色",
"2:1716041646596108": "颜色分类:卡其色",
"3:1716041646596124": "颜色分类:珍珠白",
"0:1716041646596156": "尺码:S 建议100斤内穿",
"1:1716151478027315": "尺码:M 建议100-113斤",
"2:1716151478028291": "尺码:L 建议110-123斤",
"3:1716151478028307": "尺码:XL 建议120-133斤",
"4:1716151478028323": "尺码:2XL 建议130-158斤穿"
},
"seller_info": {
"nick": "黄岛区古蒂歌服饰店",
"item_score": 4.86,
"score_p": 4.95,
"delivery_score": 4.99,
"shop_type": null,
"shop_logo": "https://p3-aio.ecombdimg.com/obj/temai/1611656872ab5f2645a9f6cf20810db68844e3e3f5cf248f0f",
"sid": 1716041646595087,
"title": "古蒂歌精品女装店",
"shop_name": "古蒂歌精品女装店"
},
"tmall": "",
"error": "",
"location": "广东省",
"desc_img": [
"https://p9-aio.ecombdimg.com/obj/temai/9a37b5d7b8c164e0dec78115f7239c48455376e7www750-1136",
"https://p6-aio.ecombdimg.com/obj/temai/50abfe5404fcc642266e97ccfba53d46afc51a0cwww750-1136",
"https://p9-aio.ecombdimg.com/obj/temai/c2390e8b150255cbe2311467091844c296eaf6bawww750-1095",
"https://p3-aio.ecombdimg.com/obj/temai/d312afa85676443c7a807688d4aab85cwww800-800",
"https://p9-aio.ecombdimg.com/obj/temai/1abe68729b067631cb5844bfcd88fa439c16a03cwww750-1070",
"https://p3-aio.ecombdimg.com/obj/temai/330154d06bd7acfbc9fe46744a84f295www750-987",
"https://p3-aio.ecombdimg.com/obj/temai/00ad2cafeffa2a85f3ef914fe1e17d35www1098-616",
"https://p3-aio.ecombdimg.com/obj/temai/5910e6bf5d211c448fa269d67b7b22bccbc7e01bwww750-1038",
"https://p9-aio.ecombdimg.com/obj/temai/ef7c2487660576bb1e35e0f675a7d5ee89566e7ewww750-971",
"https://p6-aio.ecombdimg.com/obj/temai/f3ba562f0e4762641049268a558a243d68d0f4d9www750-1136",
"https://p3-aio.ecombdimg.com/obj/temai/9130ca6f53486030a306f48f44923e8796e59ca9www750-1105",
"https://p9-aio.ecombdimg.com/obj/temai/a3bf398e3439fe5c42c6cec8c3b2d008523a6f99www750-1136",
"https://p6-aio.ecombdimg.com/obj/temai/25f773b7a62d0b789d015198261c3aac0224d676www750-1136",
"https://p6-aio.ecombdimg.com/obj/temai/216c81f4115d9866134976c4e55b79d1cdfcfbdbwww750-955",
"https://p3-aio.ecombdimg.com/obj/temai/c819abbf998aa58443c6e383fe8da9a9d7a25afewww750-834",
"https://p6-aio.ecombdimg.com/obj/temai/82c9518b7438a5d30fb58efa1d872e3b50fa4a2ewww750-1136",
"https://p9-aio.ecombdimg.com/obj/temai/78c6e8944f3d936654accf6059e6f5adwww800-800",
"https://p3-aio.ecombdimg.com/obj/temai/40c2fc84c9e265b8a9897b8b77ce7764f347d00fwww750-952",
"https://p9-aio.ecombdimg.com/obj/temai/79b4eecb3924bc01d2143270ebf015fdb2d0127fwww750-960",
"https://p9-aio.ecombdimg.com/obj/temai/502e0ebbb534d4bcbdbca0ce158ee0ef917d9d1fwww750-1014",
"https://p3-aio.ecombdimg.com/obj/temai/7c3272bbd8ae080d91636773df0c0bc8bc2c5b1cwww750-1038",
"https://p9-aio.ecombdimg.com/obj/temai/2f9805ac9215f89da063aa3da473b06fa0591780www750-1080",
"https://p6-aio.ecombdimg.com/obj/temai/2713d6e8adf3fe59c0fd3d2c15829e924f63a46ewww750-1136",
"https://p6-aio.ecombdimg.com/obj/temai/b7331dd00e686a261912a54af4ae3f2b61311082www750-1136",
"https://p3-aio.ecombdimg.com/obj/temai/682379cd908fc0ee170b6ab914e9df374651c44bwww750-1136",
"https://p3-aio.ecombdimg.com/obj/temai/c1bc79f0eec46b8d6dc0c363dadc2f013d32f4a7www750-1136",
"https://p9-aio.ecombdimg.com/obj/temai/3fc35a21ed6161836e78f18a0c506112dc6c19d2www750-1136",
"https://p3-aio.ecombdimg.com/obj/temai/3c5d22702e1cd2de45c9ec3671c4154fe33e5ebewww750-1136",
"https://p6-aio.ecombdimg.com/obj/temai/b4d1d18942ec15e5f64f6f5aadf9b467cd92e21bwww750-1136",
"https://p9-aio.ecombdimg.com/obj/temai/87a96eccbacf3b3a20d99266f2d4b801f2352fa5www750-1136",
"https://p3-aio.ecombdimg.com/obj/temai/7db68c13bfd5ed2b1d27e85248ba85f60a9d24d2www750-1136",
"https://p6-aio.ecombdimg.com/obj/temai/75a8aa104430fc1227019d3b38f7a83e2f451e0bwww750-1136"
],
"shop_item": [],
"relate_items": []
},
"secache": "13dfb7af3b9afe151343f76cf8040cc2",
"secache_time": 1649832242,
"secache_date": "2022-04-13 14:44:02",
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"error": "",
"reason": "",
"error_code": "0000",
"cache": 1,
"api_info": "today:44 max:11000",
"execution_time": "0.058",
"server_time": "Beijing/2022-04-13 16:25:49",
"client_ip": "106.6.34.146",
"call_args": {
"num_iid": "3514453298386183303"
},
"api_type": "douyin",
"translate_language": "zh-CN",
"translate_engine": "google_new",
"server_memory": "3.05MB",
"request_id": "gw-1.6256890da39ad",
"last_id": "880670193"
}
异常示例
{
"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": "douyin",
"request_id": "1ee0ffc041242"}
相关资料
错误码解释
| 状态代码(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 | 未知错误 | 否 |
