问答
怎么把抖音搜索结果导出到 Excel?
简短回答
对每个关键词调 okdata 的抖音视频搜索,按游标翻到你需要的页数,去掉重复的作品 ID,再把结果写进 .xlsx,ID 一律存成文本。每页约 20 条,$0.02,1000 行大约 $1.00;之后要刷新选中作品的数据,每条 $0.002。
需求通常是这样来的:“周五前把抖音上所有讲露营装备和户外电源的视频整理成表格。”在 App 里手动复制,一两屏之后就撑不下去了;网上抓来的导出文件,用 Excel 一打开,作品 ID 变成了 7.42882E+18。这件事其实就三步:逐页搜索,清洗数据,写一个不会弄坏 ID 的表格。
具体步骤
- **搜索。**用
query和sort(relevance、latest或most_liked,区别见抖音搜索的几种排序)调抖音视频搜索。把page.next_cursor作为cursor传回去,直到page.has_more为 false,或者页数够了。 - **清洗。**几个关键词、几页之间会有重复,每个
id只留一行。把published_at(UTC)换成北京时间,hashtags合并成一个单元格,保留type,方便筛出图文作品。 - **写入。**存成 .xlsx,
id和author.id都按文本写,不按数字写。
之后客户挑了 30 条要跟踪,再用视频详情逐条刷新数据。
值得保留的列
| 列 | 字段 | 说明 |
|---|---|---|
| 作品 ID | id |
按文本写 |
| 链接 | url |
/video/ 或 /note/ |
| 类型 | type |
video 或 image |
| 文案 | text |
可能有换行和表情 |
| 发布时间(北京) | published_at |
由 UTC 转换 |
| 点赞、评论、分享、收藏 | metrics.likes、metrics.comments、metrics.shares、metrics.favorites |
抖音不公开播放量 |
| 作者、作者 ID | author.name、author.id |
author.id 就是 sec_uid |
| 话题 | hashtags |
用空格连起来 |
费用
| 导出 | 调用次数 | 费用 |
|---|---|---|
| 1 个关键词翻 5 页(约 100 行) | 5 | $0.10 |
| 3 个关键词各翻 10 页 | 30 | $0.60 |
| 再刷新选中的 50 条 | 50 | $0.10 |
示例
import os, requests
from datetime import datetime
from zoneinfo import ZoneInfo
from openpyxl import Workbook # pip install requests openpyxl
URL = "https://api.okdata.online/v1/douyin/videos/search"
H = {"Authorization": f"Bearer {os.environ['OKDATA_API_KEY']}"}
BJ = ZoneInfo("Asia/Shanghai")
rows = {}
for kw in ["露营装备", "户外电源"]:
cursor = None
for _ in range(5):
params = {"query": kw, "sort": "most_liked", **({"cursor": cursor} if cursor else {})}
body = requests.get(URL, headers=H, params=params, timeout=60).json()
if body["code"] != "ok":
raise RuntimeError(body["message"])
for p in body["data"]["items"]:
t = datetime.fromisoformat(p["published_at"].replace("Z", "+00:00")).astimezone(BJ)
m = p["metrics"]
rows.setdefault(p["id"], [kw, p["id"], p["url"], p["type"], p["text"], t.strftime("%Y-%m-%d %H:%M"),
m["likes"], m["comments"], m["shares"], m["favorites"],
p["author"]["name"], p["author"]["id"], " ".join(p["hashtags"] or [])])
if not body["page"]["has_more"]:
break
cursor = body["page"]["next_cursor"]
wb = Workbook()
ws = wb.active
ws.append(["关键词", "作品ID", "链接", "类型", "文案", "发布时间", "点赞", "评论",
"分享", "收藏", "作者", "作者ID", "话题"])
for r in rows.values():
ws.append(r) # ID 是 Python 字符串,Excel 会保留全部 19 位
wb.save("douyin_search.xlsx")
print(len(rows), "条不重复的作品")
Excel 里的坑
- **长 ID。**Excel 只保留 15 位有效数字。19 位的作品 ID 一旦以数字形式输入或导入,后四位就永久丢了。写 .xlsx 时按字符串写;如果是 CSV,Excel 打开时照样会转换,要通过“数据 > 从文本/CSV”导入,并把这一列设为文本。
- **CSV 编码。**写 CSV 的话,用带 BOM 的 UTF-8(Python 里
encoding="utf-8-sig"),否则 Windows 上的 Excel 打开后文案是乱码。 - 时区。
published_at是 UTC。不换算的话,晚上发的作品会落到错误的日期上。
限制
资料来源
这个问题出现过的地方(读取于 2026-11-17)
更新于