item_get_video-获取抖音视频详情
douyin.item_get_video
公共参数
请求地址: https://api-gw-4.cn/douyin/item_get_video
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| 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版本 |
请求参数
请求参数:item_id=7092264344980868359
参数说明:item_id:视频id,
响应参数
Version: Date:
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| item | item[] | 0 | 视频详情数据 |
请求示例

-- 请求示例 url 默认请求参数已经URL编码处理 curl -i "https://api-gw-4.cn/douyin/item_get_video/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&item_id=7092264344980868359"
响应示例
{
"item": {
"num_iid": "7092264344980868359",
"detail_url": "https://www.iesdouyin.com/share/video/7092264344980868359/?region=&mid=7090863251021515533&u_code=0&did=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&iid=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&with_sec_did=1&titleType=title",
"title": "修以美好,与君相遇#就算无人欣赏也要独自芬芳",
"type": "video",
"nick": "花草日记 🪴 麦麦",
"signature": "🐌不谈悲喜、只闻花香\n\n🐌手机随拍、装点生活",
"uid": "5698411035",
"short_id": "969898359",
"video": {
"url": "https://aweme.snssdk.com/aweme/v1/playwm/?video_id=v0200fg10000c9mcherc77ufa73socn0&ratio=720p&line=0",
"url_raw": "https://aweme.snssdk.com/aweme/v1/play/?video_id=v0200fg10000c9mcherc77ufa73socn0&ratio=720p&line=0",
"pic_url": "https://p6-sign.douyinpic.com/tos-cn-p-0015/871cb3034d9b4073bd2aa8960bff93fd~c5_300x400.jpeg?x-expires=1657267200&x-signature=B51pWtm1i1Mljef8gNaulIXDdgk%3D&from=4257465056_large&s=PackSourceEnum_DOUYIN_REFLOW&se=false&sc=cover&l=202206241654240102080650503702D0F0"
},
"music": {
"title": "@若然若创作的原声一若然若",
"nick": "若然若",
"url": "https://sf6-cdn-tos.douyinstatic.com/obj/ies-music/7090863247943109407.mp3",
"pic_url": "https://p3.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-avt-0015_1e7c8177679e3c9b4743da4968714762.jpeg?from=116350172"
},
"item_imgs": []
},
"error": "",
"reason": "",
"error_code": "0000",
"cache": 0,
"api_info": "today:60 max:10100 all[110=60+19+31];expires:2030-12-31",
"execution_time": "0.237",
"server_time": "Beijing/2022-06-24 16:54:24",
"client_ip": "106.6.39.153",
"call_args": [],
"api_type": "douyin",
"translate_language": "zh-CN",
"translate_engine": "google_new",
"server_memory": "3.04MB",
"request_id": "1.62b57bc005cc9",
"last_id": "1038207645"
}
异常示例
{
"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 | 未知错误 | 否 |
API 工具
当您调用一个根据ID获取商品详情的API时,通常返回值会包含一系列有关特定商品的详细信息。这些信息可能包括但不限于:
- 商品ID(Product ID):商品的唯一标识符。
- 商品名称(Product Name):商品的名称。
- 商品描述(Description):对商品的详细描述。
- 价格(Price):商品的售价。
- 库存数量(Stock Quantity):商品的库存量。
- 商品图片URL(Image URL):商品图片的网络地址。
- 类别/分类(Category):商品所属的类别或分类。
- 标签/属性(Tags/Attributes):与商品相关的标签或属性,如颜色、尺寸等。
- SKU(Stock Keeping Unit):商品的库存单位,用于具体识别商品的型号、配置等。
- 品牌(Brand):商品的品牌名称。
- 上架状态(Listing Status):商品的上架/下架状态。
- 评分/评价(Rating/Reviews):商品的用户评分和评价。
- 销售统计(Sales Statistics):商品的销售数量、浏览次数等统计数据。
- 创建时间(Creation Date):商品信息被添加到系统的日期。
- 更新时间(Last Updated):商品信息最后更新的时间。
一个典型的API响应可能会是这样的JSON格式:
json复制代码运行
{ "product_id": "12345", "name": "Example Product", "description": "This is an example product description.", "price": 99.99, "stock_quantity": 50, "image_url": "https://example.com/product-image.jpg", "category": "Electronics", "tags": ["electronics", "home"], "sku": "EXAMPLE123", "brand": "Example Brand", "listing_status": "active", "rating": 4.5, "reviews": [ { "user_id": "1", "comment": "Great product!", "rating": 5 }, // ... more reviews ... ], "sales_statistics": { "units_sold": 1000, "views": 5000 }, "creation_date": "2023-01-01T00:00:00Z", "last_updated": "2023-04-15T12:00:00Z" }
总之,具体的返回值会根据不同API的设计和需求有所不同。一些API可能还会包括额外的元数据或者链接到关联资源的信息。务必查阅相关API的文档以了解确切的返回值内容和格式。
|
本文介绍了如何通过DouyinAPI中的item_get_video方法获取抖音视频详情,包括请求参数、示例请求以及响应参数结构,有助于开发者调用该接口获取视频数据。



8999

被折叠的 条评论
为什么被折叠?



