跳到导航

拿到抖音博主主页后,怎样继续取作品,不混用sec_uid、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、而且只要作品列表时,直接用博主作品目录。需要核对同一账号的 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;需要身份资料时再查,并核对返回账号一致。保留原账号链接、标识和下一步,选出与收纳教程有关的作品再研究。

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

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

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

把脚本保存为 douyin_identity.py:

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,也不会自动换编号重试。

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 只核对本地文件字节,不保证账号永久不变,也不证明查询时间。

作品导出与分页 · 作品编号与短链接 · 交付作者核对

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

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