> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# 拿到抖音博主主页后，怎样继续取作品，不混用sec_uid、uid和抖音号？

> 从抖音主页提取 sec_uid 并作为 sec_user_id 传给资料与作品动作，按字符串保留 data.user.uid，并与自定义抖音号、昵称及星图达人编号严格区分。

查抖音博主的作品，取主页链接 `/user/` 后面的 `sec_uid`，请求里填作 `sec_user_id`。要核对数字账号 ID，从资料响应读 `data.user.uid`。抖音号只用于展示和人工核对。只有数字 UID 时，先用按 UID 查资料的动作，再核对返回的主页标识。

例如你收到一位家居博主的主页，想整理博主的收纳教程：先确认是目标账号，再用作品目录挑相关视频。昵称、用户自定义抖音号和平台数字 uid 分别保存，以后的观察才能对应到同一个账号。

## 哪个编号跟这次任务有关？

| 已有信息                     | 含义与下一步                                                                                            |
| ------------------------ | ------------------------------------------------------------------------------------------------- |
| 主页 `/user/` 后的 `sec_uid` | 作为 `sec_user_id` 传给 `douyin.web.handler_user_profile_v4` 与 `douyin.app.v3.fetch_user_post_videos` |
| 资料返回的 `data.user.uid`    | 账号数字标识，保留原始字符串，按后续动作合同使用                                                                          |
| `unique_id` / `short_id` | 自定义抖音号或短号，分别保存；`unique_id` 与 `short_id` 不是统一的 `uid`                                               |
| `nickname`               | 展示名称，可帮助人工核对，不能替代账号标识                                                                             |
| 星图达人编号                   | 另一个动作的对象，不因看起来像数字就与 `data.user.uid` 混用                                                            |

资料输出字段名是 `sec_uid`，动作输入名是 `sec_user_id`。保留 `sec_uid` 与 `sec_user_id` 两个原名，不要把所有标识都改成同一个 `id`，也不要从 `sec_uid` 自行推算 `uid`。

## 怎样从 sec_uid 查 uid，或从 uid 找账号？

已有 `sec_uid` 时，调用 `douyin.web.handler_user_profile_v4` 查询，核对响应中的 `data.user.sec_uid` 与目标账号一致后，读取 `data.user.uid`。只有确认过的数字 `uid` 时，用 `douyin.web.fetch_user_profile_by_uid` 查该账号资料，`uid` 以字符串传入。`douyin.web.fetch_user_profile_by_uid` 的固定输出还未核实：响应明确带有同一账号的 `sec_uid` 时，核对后原样保存；没有 `sec_uid` 时，先用已确认的主页或其他一手资料确定身份，再查作品。

## 什么时候需要资料查询？

已有正确的 `sec_uid`、而且只要作品列表时，直接用[博主作品目录](/zh/guides/douyin-creator-post-export)。需要核对同一账号的 `uid`、抖音号和展示资料时，再调用 `data:douyin.web.handler_user_profile_v4`，输入 `sec_user_id`。

资料对象在 `data.user`。先对照返回的 `data.user.sec_uid` 和原请求 `sec_user_id`，再保存 `uid`、`unique_id`、`short_id` 与 `nickname`。资料里没有抖音号时就留空；同名不是同一账号的证据。

把任务交给已接入 BeatAPI 工具的助手时，可以这样写：

> 根据这位博主的准确主页整理作品研究起点。只要列作品就复用sec_uid；需要身份资料时再查，并核对返回账号一致。保留原账号链接、标识和下一步，选出与收纳教程有关的作品再研究。

资料查询和作品查询各自计费，见[价格页](https://beatapi.io/zh/pricing)。下面的本地脚本 `douyin_identity.py` 不发起网络请求：`douyin_identity.py` 把已确认的主页链接转成请求文件，再用已保存的真实响应核对身份。

## 从主页到正确请求，再核对真实返回

`douyin_identity.py` 只做本地准备和校验。`prepare` 读取完整的 https 主页链接，不跟进短链接，不查找昵称；视频地址、伪域名和数字 uid 路径都会被拒绝。查询参数和片段不进入 API 输入。`prepare` 接受复制来的 /user/ 身份段，不能证明账号真实存在。

把脚本保存为 `douyin_identity.py`：

```python
import hashlib,json,pathlib,re,sys
from urllib.parse import urlparse,unquote
mode=sys.argv[1]
if mode=="prepare":
    link=sys.argv[2];target=pathlib.Path(sys.argv[3]);url=urlparse(link)
    if url.scheme!="https" or url.hostname not in ("douyin.com","www.douyin.com") or url.username or url.password or url.port not in (None,443):raise ValueError("Use a public HTTPS Douyin profile URL")
    parts=[unquote(p) for p in url.path.strip('/').split('/')]
    if len(parts)!=2 or parts[0]!="user" or not re.fullmatch(r"[A-Za-z0-9_-]+",parts[1]) or parts[1].isdigit():raise ValueError("Expected /user/<copied sec_uid>, not a video, handle or numeric uid")
    sec=parts[1]
    body={"action":"douyin.web.handler_user_profile_v4","params":{"sec_user_id":sec}}
    target.mkdir();(target/"request.json").write_text(json.dumps(body,ensure_ascii=False,indent=2),encoding="utf-8")
    (target/"input-audit.json").write_text(json.dumps({"profile_url":"https://www.douyin.com/user/"+sec,"query_or_fragment_discarded":bool(url.query or url.fragment),"executed":False},ensure_ascii=False,indent=2),encoding="utf-8")
elif mode=="verify":
    request_file,raw_file,target=map(pathlib.Path,sys.argv[2:5]);request=json.loads(request_file.read_text(encoding="utf-8"))
    if request.get("action")!="douyin.web.handler_user_profile_v4" or set(request.get("params",{}))!={"sec_user_id"}:raise ValueError("Use the saved profile request")
    sec=request["params"]["sec_user_id"]
    if not isinstance(sec,str) or not sec or not re.fullmatch(r"[A-Za-z0-9_-]+",sec) or sec.isdigit():raise ValueError("Invalid expected sec_user_id")
    raw=raw_file.read_bytes();response=json.loads(raw)
    if not isinstance(response,dict) or response.get("status")!="succeeded" or response.get("action")!=request["action"] or response.get("error") is not None:raise ValueError("Expected successful profile response")
    rid=response.get("request_id")
    if not isinstance(rid,str) or not rid.strip():raise ValueError("Missing request ID")
    data=response.get("data");user=data.get("user") if isinstance(data,dict) else None
    if not isinstance(user,dict) or user.get("sec_uid")!=sec:raise ValueError("Profile sec_uid does not match the requested identity")
    values={}
    for field in ("uid","unique_id","short_id","nickname"):
        value=user.get(field)
        if value is not None and not isinstance(value,str):raise ValueError("Keep original string identity: "+field)
        if field=="uid" and value is not None and (not value.isascii() or not value.isdigit() or not any(c!="0" for c in value)):raise ValueError("uid must be an original nonzero ASCII digit string")
        values[field]=value
    identity={"sec_uid":sec,**values,"uid_available":values["uid"] is not None,"request_id":rid,"source_sha256":hashlib.sha256(raw).hexdigest(),"source_file":str(raw_file.resolve()),"scope":"One saved matching profile response; not a permanent alias or bidirectional ID-conversion guarantee"}
    post_request={"action":"douyin.app.v3.fetch_user_post_videos","params":{"sec_user_id":sec,"max_cursor":0,"count":20,"sort_type":0,"channel":"normal"}}
    target.mkdir();(target/"raw-profile.json").write_bytes(raw)
    (target/"identity.json").write_text(json.dumps(identity,ensure_ascii=False,indent=2),encoding="utf-8")
    (target/"creator-posts-request.json").write_text(json.dumps(post_request,ensure_ascii=False,indent=2),encoding="utf-8")
else:raise ValueError("Use prepare or verify mode")
print(str(target))
```

先运行 `python3 douyin_identity.py prepare '真实HTTPS主页链接' profile-request`。新目录 `profile-request` 里有 `request.json` 和 `input-audit.json`，`executed` 为 false。检查编号后再批准资料请求；之后只把 `request.json` 作为 API 正文提交，把原响应保存为 `profile-call/response.json`，并记下 HTTP 状态。失败的响应不进入 `verify`，也不会自动换编号重试。

```bash
mkdir profile-call &&
curl --fail-with-body -sS https://api.beatapi.io/v1/social-data/call \
  -H "Authorization: Bearer $BEATAPI_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @profile-request/request.json \
  -D profile-call/headers.txt \
  -o profile-call/response.json
```

已有成功响应时，运行 `python3 douyin_identity.py verify profile-request/request.json profile-call/response.json identity-review`。新目录 `identity-review` 输出 `identity.json`、原字节的 `raw-profile.json` 和可单独批准的 `creator-posts-request.json`。`verify` 先核对 action、request_id，以及 data.user.sec_uid 与原请求完全一致，才记录 uid 等字段；数字 uid 必须保持非零 ASCII 字符串，缺失的 uid 保留 null，不拿 short_id 补上。

## identity.json 与 creator-posts-request.json 解决了什么？

`identity.json` 记录一次匹配资料响应中的 `sec_uid`、`uid`、`unique_id`、`short_id`、`nickname` 和 `source_sha256`。`uid` 可能超过 JavaScript 安全整数范围，必须按原字符串保存。只有 `uid` 时，需要 `sec_user_id` 的资料动作不能把 `uid` 反向转换回 `sec_uid`；不要自行推算，也不要把昵称搜索结果当成确定的账号对应关系。

`creator-posts-request.json` 是未执行的作品首页请求，参数使用已匹配的 `sec_uid`；`creator-posts-request.json` 本身不会触发作品或评论采集。已有已核对的 `sec_uid` 时，可以跳过资料查询流程，直接使用作品指南。资料里的自定义抖音号为空就记为空，不推断账号异常，也不换成其他编号。`source_sha256` 只核对本地文件字节，不保证账号永久不变，也不证明查询时间。

[作品导出与分页](/zh/guides/douyin-creator-post-export) · [作品编号与短链接](/zh/faq/douyin-video-id) · [交付作者核对](/zh/guides/douyin-share-snapshot)

## 认证、直播状态和带货能力怎样核对？

例如你要约一个品牌账号做直播，先确认目标主页，再读资料响应里返回的 `custom_verify` 和 `live_status`，保留原值和采集时间。`custom_verify` 的认证描述可以帮助认准账号，认证类型要结合实际资料核对。`live_status` 只代表本次观察时的状态。商品橱窗与带货权限需要单独证据证明：`douyin.web.handler_user_profile_v4` 目前没有商品橱窗或带货权限的已核实固定字段，核对前标为待核。