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

> 按关键词逐页调抖音视频搜索，按作品 ID 去重，写成 .xlsx：ID 保持文本、时间换成北京时间。代码、每千行的费用，以及 Excel 里的几个坑。

网页版：https://okdata.online/zh/answers/douyin-search-export-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`，区别见[抖音搜索的几种排序](/zh/answers/douyin-search-sort-params/)）调[抖音视频搜索](/zh/apis/douyin/videos/search/)。把 `page.next_cursor` 作为 `cursor` 传回去，直到 `page.has_more` 为 false，或者页数够了。
2. **清洗。**几个关键词、几页之间会有重复，每个 `id` 只留一行。把 `published_at`（UTC）换成北京时间，`hashtags` 合并成一个单元格，保留 `type`，方便筛出图文作品。
3. **写入。**存成 .xlsx，`id` 和 `author.id` 都按文本写，不按数字写。

之后客户挑了 30 条要跟踪，再用[视频详情](/zh/apis/douyin/videos/get/)逐条刷新数据。

## 值得保留的列

| 列 | 字段 | 说明 |
|---|---|---|
| 作品 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 |

## 示例

```python
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。不换算的话，晚上发的作品会落到错误的日期上。

## 限制

- 一个关键词能搜多深由抖音决定，页数会用完。大话题拆成几个窄一点的关键词。
- 搜索结果不带粉丝数。表格需要的话，用[抖音账号信息](/zh/apis/douyin/users/get/)补上，每个作者 $0.002。
- 要导出的是评论而不是视频，见[导出抖音评论](/zh/answers/douyin-export-comments-sentiment/)。

## 用到的接口

- [抖音视频搜索](https://okdata.online/zh/apis/douyin/videos/search/) `douyin.videos.search`：$0.02/次 · 每页约 20 条视频
- [抖音视频详情](https://okdata.online/zh/apis/douyin/videos/get/) `douyin.videos.get`：$0.002/次

## 更多抖音内容

- [抖音 API](https://okdata.online/zh/apis/douyin/)
- [抖音 API Python 教程：搜索、视频、账号和评论（2026）](https://okdata.online/zh/guides/douyin-api-python/)
- [怎么批量导出抖音视频评论](https://okdata.online/zh/guides/douyin-video-comments/)
- [怎么在抖音星图按条件找达人并拿到报价单](https://okdata.online/zh/guides/douyin-xingtu-creator-rates/)
- [千问里怎么拿到抖音、小红书、公众号的数据？](https://okdata.online/zh/answers/qwen-douyin-xiaohongshu-data/)
- [海外公司怎么拿到抖音数据，还要英文的？](https://okdata.online/zh/answers/douyin-data-outside-china-english/)
- [腾讯元宝能读抖音、小红书的数据吗？](https://okdata.online/zh/answers/yuanbao-douyin-xiaohongshu-data/)
- [抖音的 a_bogus 参数是什么？要拿抖音数据一定得自己生成吗？](https://okdata.online/zh/answers/douyin-a-bogus-signature/)
- [抖音链接里的 aweme_id 和 modal_id 是什么？](https://okdata.online/zh/answers/douyin-aweme-id-modal-id/)
- [怎么导出抖音视频评论做情感分析？](https://okdata.online/zh/answers/douyin-export-comments-sentiment/)
- [抖音评论采集用什么？官方接口、第三方 API、开源爬虫、采集工具 4 类方案怎么选（2026）](https://okdata.online/zh/compare/douyin-comment-scraping/)
- [抖音数据接口有哪些？官方开放平台、第三方 API、开源爬虫 4 类方案怎么选（2026）](https://okdata.online/zh/compare/douyin-data-apis/)
- [平台官方 API 和第三方数据接口怎么选（2026）](https://okdata.online/zh/compare/official-apis-vs-data-apis/)
- [自己爬还是按次调用数据接口：成本、维护和风险](https://okdata.online/zh/compare/scraping-vs-data-api/)

## 资料来源

- [Excel specifications and limits: number precision of 15 digits](https://support.microsoft.com/en-us/office/excel-specifications-and-limits-1672b34d-7043-467e-8e27-269d656771c3) (读取于 2026-11-12)
- [openpyxl documentation](https://openpyxl.readthedocs.io/en/stable/) (读取于 2026-11-12)

这个问题出现过的地方（读取于 2026-11-17）：

- https://juejin.cn/post/7514983928378228774
- https://learn.microsoft.com/en-us/troubleshoot/microsoft-365-apps/excel/last-digits-changed-to-zeros

更新于 2026-11-12
