通过ItemID获取IFrame代码

我的收藏

该接口无需申请权限。

该接口用于通过视频 ItemID获取 IFrame 代码。视频 ItemID可以通过【查询授权账号视频列表】、【查询特定视频的视频数据】、【查询视频分享结果及数据】等能力获取。

该接口适用于抖音。

注意：

该接口以 https://open.douyin.com/ 开头

请求地址

GET /api/douyin/v1/video/get_iframe_by_item

请求参数

URL 请求

参数名称	参数描述	参数示例	是否必填
item_id	视频ItemID(请注意使用Base64URL编码)	QDcyTTBXQ3F0eHVZR2l3dGtWVVlGdkgxbnR1TTBSZlF3VkgrUmZUMzBXVVY4Q3RMUXJVOU1wSlNZRVZWNi8yaEsrTm8zQVBUYy84T1U3VkJiQkhJM3NnPT0=	是
client_key	应用标识	awexxxxxxx	是

请求样例

curl --location --request GET 'https://open.douyin.com/api/douyin/v1/video/get_iframe_by_item?item_id=QDcyTTBXQ3F0eHVZR2l3dGtWVVlGdkgxbnR1TTBSZlF3VkgrUmZUMzBXVVY4Q3RMUXJVOU1wSlNZRVZWNi8yaEsrTm8zQVBUYy84T1U3VkJiQkhJM3NnPT0=&client_key=awexxxxxxx'

响应参数

参数名称		参数类型	参数描述	参数示例
err_no		i32	错误码	0
err_msg		string	错误码描述	非公开视频
log_id		string	日志ID	20221025205044010225243125063FAD62
data		object
	iframe_code	string	返回IFrame代码片段，用于直接注入页面
	video_title	string	视频标题	天气不错
	video_width	i64	视频宽度	1280
	video_height	i64	视频高度	720

响应样例

{
  "data": {
    "iframe_code": "<iframe width=\"720\" height=\"1280\" frameborder=\"0\" src=\"https://open.douyin.com/player/video?vid=7146408143612******&autoplay=0\" referrerpolicy=\"unsafe-url\" allowfullscreen></iframe>",
    "video_height": 1280,
    "video_title": "#hashtag1#hashtag2#hashtag3#天气不错",
    "video_width": 720
  },
  "err_msg": "",
  "err_no": 0,
  "log_id": "20221025205044010225243125063FAD62"
}

响应错误样例

{
  "err_msg": "系统内部错误，请重试",
  "err_no": 28001005,
  "log_id": "20221025205044010225243125063FAD62"
}

错误码

HTTP 状态码	错误码	描述	排查建议
200	28001005	系统内部错误，请重试	请求重试，或反馈给抖音开放平台
200	28001007	参数不合法	检查参数是否正确
200	28003004	非公开视频	检查当前视频是否处于公开状态

上一篇：通过VideoID获取IFrame代码

下一篇：H5分享跳转链接获取