给 AI

问答

怎么把抖音搜索结果导出到 Excel?

简短回答

对每个关键词调 okdata 的抖音视频搜索,按游标翻到你需要的页数,去掉重复的作品 ID,再把结果写进 .xlsx,ID 一律存成文本。每页约 20 条,$0.02,1000 行大约 $1.00;之后要刷新选中作品的数据,每条 $0.002。

需求通常是这样来的:“周五前把抖音上所有讲露营装备和户外电源的视频整理成表格。”在 App 里手动复制,一两屏之后就撑不下去了;网上抓来的导出文件,用 Excel 一打开,作品 ID 变成了 7.42882E+18。这件事其实就三步:逐页搜索,清洗数据,写一个不会弄坏 ID 的表格。

具体步骤

  1. **搜索。**用 query 和 sort(relevance、latest 或 most_liked,区别见抖音搜索的几种排序)调抖音视频搜索。把 page.next_cursor 作为 cursor 传回去,直到 page.has_more 为 false,或者页数够了。
  2. **清洗。**几个关键词、几页之间会有重复,每个 id 只留一行。把 published_at(UTC)换成北京时间,hashtags 合并成一个单元格,保留 type,方便筛出图文作品。
  3. **写入。**存成 .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。不换算的话,晚上发的作品会落到错误的日期上。

限制

  • 一个关键词能搜多深由抖音决定,页数会用完。大话题拆成几个窄一点的关键词。
  • 搜索结果不带粉丝数。表格需要的话,用抖音账号信息补上,每个作者 $0.002。
  • 要导出的是评论而不是视频,见导出抖音评论。

资料来源

  1. Excel specifications and limits: number precision of 15 digitssupport.microsoft.com · 读取于
  2. openpyxl documentationopenpyxl.readthedocs.io · 读取于

这个问题出现过的地方(读取于 2026-11-17)

更新于

接上一次,以后直接问 AI。

新 key 自带 $0.10 试用额度。贴一句话,就能接进你的智能体。

免费开始
一句话接进你的 AI

把这句话发给你的智能体

读一下 https://okdata.online/zh/agents.md,帮我把 okdata 配好;我的 key 在环境变量 OKDATA_API_KEY 里。

Claude Code、Cursor、Codex 等能打开网址的智能体,读完会自己配好。

MCP 地址https://api.okdata.online/mcp