TikTok 的item_get_video接口是获取单条视频精细化详情的核心工具，输入视频 ID / 分享链接即可返回基础信息、互动数据、创作者信息、商品标签、版权标识等全量内容，广泛用于跨境内容聚合、社媒数据分析、带货效果评估、品牌舆情监测等场景。该接口存在官方与第三方两条合规接入路径，官方采用 OAuth2.0 授权，第三方多为 key-secret 签名校验，本攻略覆盖全流程实操与生产级优化，兼顾入门与稳定性需求。
一、接口核心认知：功能与适配场景
1. 接口定位与核心价值
2. 核心参数与返回字段
（1）请求参数（官方与第三方通用规范）
（2）返回核心字段（按业务场景分类）
3. 接口限制与注意事项
二、对接前准备：权限与环境搭建
1. 获取接口权限（两条合规路径）
2. 技术环境准备
（1）支持语言与协议
（2）必备工具与依赖
三、实操步骤：接口对接全流程（Python 示例）
步骤 1：理解 TikTok 接口认证与签名规则
（1）官方接口 OAuth2.0 授权流程
（2）第三方接口签名规则（MD5 加密）
步骤 2：完整代码实现（第三方签名 + 官方 OAuth2.0 双示例）
（1）依赖安装
（2）第三方签名方式代码（快速接入）
import requests
import hashlib
import time
import json
import pandas as pd
import logging
from urllib.parse import urlencode
# 封装好API供应商demo url=https://console.open.onebound.cn/console/?i=Lex
# 日志配置
logging.basicConfig(
level=logging.INFO,
format="%(asctime)s - %(levelname)s - %(message)s",
handlers=[logging.FileHandler("tiktok_item_get_video.log"), logging.StreamHandler()]
)
# 接口配置（替换为自身的key、secret、接口地址）
CONFIG = {
"key": "你的第三方key",
"secret": "你的第三方secret",
"api_url": "https://api.example.com/tiktok/item_get_video",
"save_path": "TikTok视频详情.xlsx"
}
def generate_sign(params: dict, secret: str) -> str:
"""生成第三方接口签名（MD5 32位大写）"""
params.pop("sign", None)
sorted_params = sorted(params.items(), key=lambda x: x[0])
param_str = urlencode(sorted_params, encoding="utf-8") + f"&secret={secret}"
md5 = hashlib.md5()
md5.update(param_str.encode("utf-8"))
return md5.hexdigest().upper()
def standardize_video_data(raw_video: dict) -> dict:
"""标准化视频数据，统一输出格式"""
create_time = raw_video.get("create_time", 0)
create_time_str = time.strftime("%Y-%m-%d %H:%M:%S", time.localtime(create_time)) if create_time else ""
duration = raw_video.get("duration", 0)
duration_str = f"{duration//60}:{duration%60:02d}"
return {
"视频ID": raw_video.get("video_id", ""),
"视频标题": raw_video.get("title", ""),
"视频描述": raw_video.get("description", ""),
"封面链接": raw_video.get("cover_url", ""),
"视频时长": duration_str,
"发布时间": create_time_str,
"播放量": raw_video.get("play_count", 0),
"点赞数": raw_video.get("like_count", 0),
"评论数": raw_video.get("comment_count", 0),
"分享数": raw_video.get("share_count", 0),
"收藏数": raw_video.get("favorite_count", 0),
"创作者ID": raw_video.get("author_id", ""),
"创作者昵称": raw_video.get("author_name", ""),
"创作者头像": raw_video.get("author_avatar", ""),
"认证状态": "认证" if raw_video.get("author_verified", 0) else "未认证",
"话题标签": ",".join(raw_video.get("hashtags", [])),
"商品数量": len(raw_video.get("products", [])) if raw_video.get("products") else 0,
"版权类型": raw_video.get("copyright_type", "未知"),
"视频状态": "正常" if raw_video.get("status", 0) == 0 else "已下架/违规",
"请求时间": time.strftime("%Y-%m-%d %H:%M:%S", time.localtime())
}
def tiktok_item_get_video(
video_id: str,
need_product: int = 0,
need_music: int = 0
) -> dict:
"""调用TikTok item_get_video接口（第三方签名方式）"""
params = {
"key": CONFIG["key"],
"video_id": video_id,
"need_product": need_product,
"need_music": need_music,
"timestamp": int(time.time() * 1000)
}
params["sign"] = generate_sign(params, CONFIG["secret"])
try:
response = requests.post(
url=CONFIG["api_url"],
data=json.dumps(params),
headers={"Content-Type": "application/json"},
timeout=20,
verify=True
)
response.raise_for_status()
result = response.json()
if result.get("code") == 0 or result.get("status") == "success":
raw_video = result.get("data", {})
if not raw_video:
logging.warning(f"无视频数据返回（视频ID：{video_id}）")
return {"success": False, "error_msg": "无视频数据"}
return {
"success": True,
"data": standardize_video_data(raw_video),
"error_msg": ""
}
else:
error_msg = result.get("msg", result.get("message", "接口调用失败"))
logging.error(f"接口返回错误（视频ID：{video_id}）：{error_msg}（code={result.get('code')}）")
return {"success": False, "error_msg": error_msg}
except requests.exceptions.RequestException as e:
logging.error(f"网络请求异常（视频ID：{video_id}）：{str(e)}")
return {"success": False, "error_msg": f"网络异常：{str(e)}"}
except Exception as e:
logging.error(f"数据解析异常（视频ID：{video_id}）：{str(e)}")
return {"success": False, "error_msg": f"解析异常：{str(e)}"}
# 封装好API供应商demo url=https://console.open.onebound.cn/console/?i=Lex
# 调用示例
if __name__ == "__main__":
# 单视频获取示例
video_id = "7298345678901234567"
result = tiktok_item_get_video(video_id=video_id, need_product=1)
if result["success"]:
print("TikTok视频详情：")
for k, v in result["data"].items():
print(f"{k}：{v}")
else:
print(f"获取失败：{result['error_msg']}")（3）官方接口 OAuth2.0 调用示例（核心片段）
from jose import jwt
import requests
def get_access_token(client_id, client_secret, code, redirect_uri):
"""通过授权码获取access_token"""
url = "https://open-api.tiktok.com/oauth/access_token/"
data = {
"client_id": client_id,
"client_secret": client_secret,
"code": code,
"grant_type": "authorization_code",
"redirect_uri": redirect_uri
}
response = requests.post(url, data=data)
return response.json().get("access_token")
def tiktok_official_item_get(access_token, video_id):
"""调用TikTok官方视频详情接口"""
url = "https://open-api.tiktok.com/video/detail/"
headers = {"Authorization": f"Bearer {access_token}"}
params = {
"video_id": video_id,
"fields": "id,title,description,duration,cover_image_url,stats,author,products"
}
response = requests.get(url, headers=headers, params=params)
return response.json()