当前位置:网站首页>获得抖音商品详情 API
获得抖音商品详情 API
2022-07-30 16:40:00 【分享干货的猫】
一、参数
公共参数
请求地址:
https://api-gw.onebound.cn/douyin/item_get
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| 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 | https://haohuo.jinritemai.com/views/product/item2?id=3514453298386183303 | 宝贝链接 |
desc | String | 0 | 本店默认申通快递【还有百世汇通 中通快递 中通 韵达 邮政】。商家建议尺码仅供参考。如有其它问题请及时联系客服!喜欢的赶紧购买,质量保证,买的放心,穿的也开心! | 商品备注 |
item_imgs | Mix | 0 | item_imgs[] | 商品图片 |
url | string | 0 | https://p6-aio.ecombdimg.com/obj/temai/e9ed9a7b06bbbf03b769075a4cf12045www876-876 | |
pic_url | String | 0 | https://p9-aio.ecombdimg.com/obj/temai/e9ed9a7b06bbbf03b769075a4cf12045www876-876 | 宝贝图片 |
props_name | String | 0 | 商品属性名 | |
prop_imgs | prop_imgs[] | 0 | 商品属性图片列表 | |
prop_img | prop_img[] | 0 | ||
props | Mix | 0 | 商品详情 | |
skus | skus[] | 0 | 商品规格信息列表 | |
sku | sku[] | 0 | ||
props_list | Mix | 0 | { "0:0": "颜色:黑色","1:1": "尺码:M"} | 商品属性 |
props_img | Mix | 0 | {"0:0;1:1": "https://p9-aio.ecombdimg.com/obj/temai/e9ed9a7b06bbbf03b769075a4cf12045www876-876"} | 属性图片 |
property_alias | String | 0 | 商品属性别名 | |
seller_info | seller_info[] | 0 | 卖家信息 | |
nick | string | 0 | 黄岛区古蒂歌服饰店 | |
user_num_id | Bigint | 0 | 2206619673102 | |
sid | Bigint | 0 | 1716041646595087 | |
zhuy | string | 0 | ||
shop_name | string | 0 | 黄岛区古蒂歌服饰店 | |
shop_item | Mix | 0 | [] | |
relate_items | Mix | 0 | [] |
二、示例
请求示例
-- 请求示例 url 默认请求参数已经URL编码处理 curl -i "https://api-gw.onebound.cn/douyin/item_get/?key=<您自己的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 | 未知错误 | 否 |
边栏推荐
猜你喜欢

Login Module Debugging - Getting Started with Software Debugging

Discuz杂志/新闻报道模板(jeavi_line)UTF8-GBK模板

【SOC】Classic output hello world

武汉星起航跨境电商有前景吗?亚马逊的未来趋势如何发展?

How to implement timing tasks for distributed applications in Golang

Rounding out the most practical way of several DLL injection

Leetcode 118. Yanghui Triangle

华为云数据治理生产线DataArts,让“数据‘慧’说话”

Is it reliable to work full-time in self-media?

rhce笔记2
随机推荐
【SOC】Classic output hello world
PHP留言反馈管理系统源码
How to remove last character from string in php
Discuz magazine/news report template (jeavi_line) UTF8-GBK template
23. 请你谈谈关于IO同步、异步、阻塞、非阻塞的区别
Scheduling_Channel_Access_Based_on_Target_Wake_Time_Mechanism_in_802.11ax_WLANs
详解最实用的几种dll注入方式
Horizontal Pod Autoscaler(HPA)
MySQL详细学习教程(建议收藏)
基于STM32F407使用ADC采集电压实验
【SOC FPGA】Peripheral KEY LED
Login Module Debugging - Getting Started with Software Debugging
初识二叉搜索树
牛客网刷题——运算符问题
Qt 动态库与静态库
Explore CSAPP Experiment 2-bomb lab-Section 1
[NCTF2019]Fake XML cookbook-1|XXE漏洞|XXE信息介绍
SwiftUI SQLite教程之带有历史的搜索栏List App (教程含完整代码)
如何在 UE4 中用代码去控制角色移动
报错500,“message“: “nested exception is org.apache.ibatis.binding.BindingException: 解决记录