如何获取抖音抖音视频详情 API 返回值说明

本文介绍了如何通过DouyinAPI中的item_get_video方法获取抖音视频详情,包括请求参数、示例请求以及响应参数结构,有助于开发者调用该接口获取视频数据。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

item_get_video-获取抖音视频详情

douyin.item_get_video

公共参数

请求地址: https://api-gw-4.cn/douyin/item_get_video

名称类型必须描述
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版本

请求参数

请求参数: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)状态信息详细描述是否收费
0000success接口调用成功并返回相关数据
2000Search success but no result接口访问成功,但是搜索没有结果
4000Server internal error服务器内部错误
4001Network error网络错误
4002Target server error目标服务器错误
4003Param error用户输入参数错误忽略
4004Account not found用户帐号不存在忽略
4005Invalid authentication credentials授权失败忽略
4006API stopped您的当前API已停用忽略
4007Account stopped您的账户已停用忽略
4008API rate limit exceeded并发已达上限忽略
4009API maintenanceAPI维护中忽略
4010API not found with these valuesAPI不存在忽略
4012Please add api first请先添加api忽略
4013Number of calls exceeded调用次数超限忽略
4014Missing url param参数缺失忽略
4015Wrong pageToken参数pageToken有误忽略
4016Insufficient balance余额不足忽略
4017timeout error请求超时
5000unknown error未知错误

API 工具

当您调用一个根据ID获取商品详情的API时,通常返回值会包含一系列有关特定商品的详细信息。这些信息可能包括但不限于:

  1. 商品ID(Product ID):商品的唯一标识符。
  2. 商品名称(Product Name):商品的名称。
  3. 商品描述(Description):对商品的详细描述。
  4. 价格(Price):商品的售价。
  5. 库存数量(Stock Quantity):商品的库存量。
  6. 商品图片URL(Image URL):商品图片的网络地址。
  7. 类别/分类(Category):商品所属的类别或分类。
  8. 标签/属性(Tags/Attributes):与商品相关的标签或属性,如颜色、尺寸等。
  9. SKU(Stock Keeping Unit):商品的库存单位,用于具体识别商品的型号、配置等。
  10. 品牌(Brand):商品的品牌名称。
  11. 上架状态(Listing Status):商品的上架/下架状态。
  12. 评分/评价(Rating/Reviews):商品的用户评分和评价。
  13. 销售统计(Sales Statistics):商品的销售数量、浏览次数等统计数据。
  14. 创建时间(Creation Date):商品信息被添加到系统的日期。
  15. 更新时间(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的文档以了解确切的返回值内容和格式。

|

### 音视频发布流程详解 #### 准备工作 在开始之前,确保已经拥有一个账号。如果计划用于商业用途,则需注册并设置好商家账号[^2]。 #### 创建内容 制作符合目标受众喜好的短视频至关重要。这不仅限于简单记录片段;精心策划的内容能够更好地吸引观众注意。对于风景类视频而言,关注画面质量、乐搭配以及剪辑节奏尤为关键[^1]。 #### 发布前检查 - **确认版权**:确保所使用的素材(如背景乐、图片等)均合法合规。 - **优化标题与描述**:撰写有吸引力的文字说明,适当加入热门话题标签以便更多人发现该作品。 - **选择合适的时间段**:根据不同地区用户的活跃时间来决定最佳发布时间点。 #### 实际上传过程 登录至创作者平台或直接打开手机应用程序,在首页找到“创建”按钮,点击进入后可选择拍摄新视频或是从相册选取已有的文件进行编辑调整。完成后按照界面指示依次完成各项设定直至最终提交审核。 #### 审核阶段 提交后的视频会经过一定周期的人工审查以确保其符合社区准则及相关法律法规要求。期间可能收到反馈建议修改部分内容后再重新递交审批请求直到完全通过为止[^5]。 #### 推广分发 一旦获得批准上线播放,便可以通过多种方式扩大影响力范围: - 利用官方提供的广告投放选项精准触达特定群体; - 积极参与评论区交流互动提升粉丝粘性; - 借助其他社交媒体渠道分享链接吸引更多外部流量访问观看。 ```python # 示例代码并非真实API调用而是概念性的表示如何模拟这一系列动作 def publish_video_on_douyin(video_file_path, title, description): """ 模拟向平台上载视频的过程 参数: video_file_path (str): 视频文件路径 title (str): 视频标题 description (str): 描述文字 返回值: bool: 是否成功发布了视频 """ # 这里省略了具体的实现逻辑... return True # 成功标志位 ```
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值