SocialDataX 抖音 Douyin MCP
REMOTE · MCP.52CHOUJIANG.COM · SCANNED AUG 3
Douyin hot search, work search/details, comments/replies, profiles, series, transcript.
Available components
+6 this week
70 70 Trust /100
Trust breakdown (6 categories)
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score →
Endpoint Security71
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation is enforced on tool calls, but the challenge carries no valid RFC 9728 metadata, so a client cannot discover where to get a token. See how to fix → View diagnostics → Fail
- HTTPS not yet verified: we couldn't determine whether a plaintext access path exists. View diagnostics → Unverified
- HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability62
- 50% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Partial
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 2738 tokens (~144/item across 19 items; 17 tools + 2 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
- Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Install
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
remote · mcp.52choujiang.com
# add to Claude Code
claude mcp add --transport http com-52choujiang-douyin-insights https://mcp.52choujiang.com/douyin/mcp
# ~/.codex/config.toml
[mcp_servers.com-52choujiang-douyin-insights] url = "https://mcp.52choujiang.com/douyin/mcp"
// opencode.json
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"com-52choujiang-douyin-insights": {
"type": "remote",
"url": "https://mcp.52choujiang.com/douyin/mcp",
"enabled": true
}
}
} # add to OpenClaw
openclaw mcp add com-52choujiang-douyin-insights --url https://mcp.52choujiang.com/douyin/mcp --transport streamable-http
# ~/.hermes/config.yaml
mcp_servers:
com-52choujiang-douyin-insights:
url: "https://mcp.52choujiang.com/douyin/mcp" // mcp.json
{
"mcpServers": {
"com-52choujiang-douyin-insights": {
"type": "http",
"url": "https://mcp.52choujiang.com/douyin/mcp"
}
}
} The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.
Changelog
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 3 Aug 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.
- 1 Aug 26 +7
- Schema quality: unverified → excellent ▲ functional
- 31 Jul 26 −4
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 30 Jul 26 +1
- Tool “douyin_submit_video_speech_text_by_aweme_id” rewrote its description, which is the text the model reads security
- Tool “douyin_submit_video_speech_text_by_video_url” rewrote its description, which is the text the model reads security
- 28 Jul 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.
- 27 Jul 26 +1
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 26 Jul 26 63
First indexed and scored.
Diagnostics
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Probed https://mcp.52choujiang.com/douyin/mcp
TLS valid
Negotiated TLS 1.2 with TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=mcp.52choujiang.com | CN=TrustAsia DV TLS RSA CA 2025,O=TrustAsia Technologies\, Inc.,C=CN | 20 Jun 2026 | 17 Sept 2026 | RSA 2048 | SHA256-RSA | 532ae96f05b6fbb35eb2296c034c190 |
| SANs: mcp.52choujiang.com | ||||||
| CN=TrustAsia DV TLS RSA CA 2025,O=TrustAsia Technologies\, Inc.,C=CN (CA) | CN=DigiCert Global Root G2,OU=www.digicert.com,O=DigiCert Inc,C=US | 8 Jan 2025 | 7 Jan 2035 | RSA 4096 | SHA256-RSA | 926323b4964e368461512def1a5d52c |
DNSSEC insecure
Validation of mcp.52choujiang.com. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| com. | present | 19718 | 13 | Verified |
| 52choujiang.com. | absent | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication Challenged, unverified
The endpoint asked for a token, but we could not retrieve and validate the RFC 9728 metadata that tells a client how to obtain one.
| Result | Challenged, unverified |
|---|---|
| Enforced | On tool calls |
| HTTP status | 200 |
WWW-Authenticate challenge Bearer error="missing_api_key", error_description="API Key required"
Bearer error="missing_api_key", error_description="API Key required"Protected resource metadata
| Retrieved | No |
|---|---|
| Problem | no_resource_metadata |
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://mcp.52choujiang.com/douyin/mcp | Verified | 200 | |
| http (plaintext) | http://mcp.52choujiang.com/douyin/mcp | Inconclusive | 405 |
MCP tools
— 17 exposed
· ~2,714 tokens
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
Tool
Tokens
douyin_get_hot_search_list ~26
获取抖音主热榜；当前不支持翻页。
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| hot_items | array | yes | 抖音主热榜条目 |
No examples provided.
douyin_get_user_info_by_profile_url ~73
根据抖音主页长链接、短链接或分享文案获取用户资料。
| Name | Type | Req | Description |
|---|---|---|---|
| profile_url | string | yes | 抖音用户主页链接、用户短链接或用户分享文案；不要传作品链接。已知 sec_user_id 时优先使用 ID 入口 |
| Name | Type | Req | Description |
|---|---|---|---|
| avatar_url | — | yes | 用户头像链接；当前不可用时为 null |
| bio | string | yes | 用户简介；当前不可用时为空字符串 |
| douyin_id | string | yes | 用户主页展示的抖音号；当前不可用时为空字符串 |
| follower_count | — | yes | 粉丝数；当前不可用时为 null |
| following_count | — | yes | 关注数；当前不可用时为 null |
| gender | string | yes | 性别：male 表示男，female 表示女，unknown 表示未知 |
| ip_location | string | yes | IP 属地；当前不可用时为空字符串 |
| live_info | — | yes | 用户直播状态摘要；用户当前未直播时为 null |
| name | string | yes | 用户昵称 |
| posted_content_count | — | yes | 用户已发布作品数量，包含视频、图文等作品；当前不可用时为 null |
| profile_url | — | yes | 用户主页链接；当前不可用时为 null |
| received_like_count | — | yes | 用户内容累计收到的点赞数；当前不可用时为 null |
| sec_user_id | string | yes | 用户 sec_user_id；用户主页和作品工具可直接复用 |
| user_id | string | yes | 用户 user_id；当前不可用时为空字符串 |
| verification_label | string | yes | 用户认证文案；当前不可用时为空字符串 |
| verified | boolean | yes | 用户是否为认证账号 |
No examples provided.
douyin_get_user_info_by_sec_user_id ~74
根据抖音用户 sec_user_id 获取用户资料；已知 sec_user_id 时优先使用此入口。
| Name | Type | Req | Description |
|---|---|---|---|
| sec_user_id | string | yes | 抖音用户 sec_user_id；可从 author.sec_user_id 或用户资料结果中的 sec_user_id 继续复用 |
| Name | Type | Req | Description |
|---|---|---|---|
| avatar_url | — | yes | 用户头像链接；当前不可用时为 null |
| bio | string | yes | 用户简介；当前不可用时为空字符串 |
| douyin_id | string | yes | 用户主页展示的抖音号；当前不可用时为空字符串 |
| follower_count | — | yes | 粉丝数；当前不可用时为 null |
| following_count | — | yes | 关注数；当前不可用时为 null |
| gender | string | yes | 性别：male 表示男，female 表示女，unknown 表示未知 |
| ip_location | string | yes | IP 属地；当前不可用时为空字符串 |
| live_info | — | yes | 用户直播状态摘要；用户当前未直播时为 null |
| name | string | yes | 用户昵称 |
| posted_content_count | — | yes | 用户已发布作品数量，包含视频、图文等作品；当前不可用时为 null |
| profile_url | — | yes | 用户主页链接；当前不可用时为 null |
| received_like_count | — | yes | 用户内容累计收到的点赞数；当前不可用时为 null |
| sec_user_id | string | yes | 用户 sec_user_id；用户主页和作品工具可直接复用 |
| user_id | string | yes | 用户 user_id；当前不可用时为空字符串 |
| verification_label | string | yes | 用户认证文案；当前不可用时为空字符串 |
| verified | boolean | yes | 用户是否为认证账号 |
No examples provided.
douyin_get_user_posted_videos_by_profile_url ~190
根据抖音主页长链接、短链接或分享文案获取用户发布的作品列表，支持 page_token 翻页。
| Name | Type | Req | Description |
|---|---|---|---|
| page_token | string | — | page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一用户作品分页链路的下一页，不能跨能力或用户复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| profile_url | string | yes | 抖音用户主页链接、用户短链接或用户分享文案；不要传作品链接。已知 sec_user_id 时优先使用 ID 入口 |
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 当前页作品列表 |
| next_page_token | string | yes | 下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
No examples provided.
douyin_get_user_posted_videos_by_sec_user_id ~180
根据抖音用户 sec_user_id 获取该用户发布的作品列表，支持 page_token 翻页。
| Name | Type | Req | Description |
|---|---|---|---|
| page_token | string | — | page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一用户作品分页链路的下一页，不能跨能力或用户复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| sec_user_id | string | yes | 抖音用户 sec_user_id；可从 author.sec_user_id 或用户资料结果中的 sec_user_id 继续复用 |
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 当前页作品列表 |
| next_page_token | string | yes | 下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
No examples provided.
douyin_get_user_series_by_profile_url ~188
根据抖音主页长链接、短链接或分享文案获取用户短剧列表，支持 page_token 翻页。
| Name | Type | Req | Description |
|---|---|---|---|
| page_token | string | — | page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一用户短剧列表分页链路的下一页，不能跨能力或用户复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| profile_url | string | yes | 抖音用户主页链接、用户短链接或用户分享文案；不要传作品链接。已知 sec_user_id 时优先使用 ID 入口 |
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 当前页短剧列表 |
| next_page_token | string | yes | 下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
No examples provided.
douyin_get_user_series_by_sec_user_id ~178
根据抖音用户 sec_user_id 获取该用户短剧列表，支持 page_token 翻页。
| Name | Type | Req | Description |
|---|---|---|---|
| page_token | string | — | page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一用户短剧列表分页链路的下一页，不能跨能力或用户复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| sec_user_id | string | yes | 抖音用户 sec_user_id；可从 author.sec_user_id 或用户资料结果中的 sec_user_id 继续复用 |
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 当前页短剧列表 |
| next_page_token | string | yes | 下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
No examples provided.
douyin_get_video_comment_replies_by_comment_id ~275
根据 aweme_id 和一级评论 comment_id 获取抖音评论回复；需同时传入 aweme_id 和 comment_id，支持 page_token 翻页。
| Name | Type | Req | Description |
|---|---|---|---|
| aweme_id | string | yes | 抖音作品的数字 aweme_id，通常可从搜索、详情或评论结果中的 aweme_id 字段复用；不要传作品链接、分享文案或带引号的字符串；调用评论回复工具时必填，需与 comment_id 同时传入 |
| comment_id | string | yes | 一级评论 ID comment_id；可从一级评论结果 items[*].comment_id 复用，用于获取该评论下的回复；调用评论回复工具时必须同时传入 aweme_id |
| page_token | string | — | page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一作品下同一一级评论的回复分页链路，不能跨能力、作品或评论复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| Name | Type | Req | Description |
|---|---|---|---|
| comment_count | — | yes | 该一级评论下的回复总量；当前不可用时为 null |
| items | array | yes | 当前页评论回复列表 |
| next_page_token | string | yes | 下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
No examples provided.
douyin_get_video_comments_by_aweme_id ~190
根据抖音作品 aweme_id 获取一级评论列表，支持 page_token 翻页。
| Name | Type | Req | Description |
|---|---|---|---|
| aweme_id | string | yes | 抖音作品的数字 aweme_id，通常可从搜索、详情或评论结果中的 aweme_id 字段复用；不要传作品链接、分享文案或带引号的字符串 |
| page_token | string | — | page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一作品评论分页链路的下一页，不能跨能力或作品复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| Name | Type | Req | Description |
|---|---|---|---|
| comment_count | — | yes | 作品评论总量；当前不可用时为 null |
| items | array | yes | 当前页一级评论列表 |
| next_page_token | string | yes | 下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
No examples provided.
douyin_get_video_comments_by_url ~205
根据抖音作品页面链接、作品短链接或包含作品链接的分享文案获取一级评论列表，支持 page_token 翻页。
| Name | Type | Req | Description |
|---|---|---|---|
| page_token | string | — | page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一作品评论分页链路的下一页，不能跨能力或作品复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| url | string | yes | 抖音作品页面链接、作品短链接或包含作品链接的完整分享文案；不要传 video.play_url 这类播放资源链接，也不要传用户主页链接；已知 aweme_id 时优先使用 ID 入口 |
| Name | Type | Req | Description |
|---|---|---|---|
| comment_count | — | yes | 作品评论总量；当前不可用时为 null |
| items | array | yes | 当前页一级评论列表 |
| next_page_token | string | yes | 下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
No examples provided.
douyin_get_video_detail_by_aweme_id ~90
根据抖音作品 aweme_id 获取作品详情；已知 aweme_id 时优先使用此入口。
| Name | Type | Req | Description |
|---|---|---|---|
| aweme_id | string | yes | 抖音作品的数字 aweme_id，通常可从搜索、详情或评论结果中的 aweme_id 字段复用；不要传作品链接、分享文案或带引号的字符串 |
| Name | Type | Req | Description |
|---|---|---|---|
| author | object | yes | 作品作者信息 |
| aweme_id | string | yes | 作品 aweme_id |
| collect_count | integer | yes | 作品收藏数 |
| comment_count | integer | yes | 作品评论数 |
| content_type | string | yes | 作品类型：video 表示视频，image 表示图文，unknown 表示未知 |
| cover_image_url | — | yes | 作品封面图链接；当前不可用时为 null |
| description | string | yes | 作品文案 |
| images | array | yes | 作品图片展示资源列表；图文作品按顺序返回所有图片，视频作品为空数组 |
| like_count | integer | yes | 作品点赞数 |
| mentioned_users | array | yes | 作品正文中 @ 到的用户列表；无 @ 时为空数组 |
| music | — | yes | 作品绑定音乐或原声资产；不表示视频播放时需要额外叠加播放；当前不可用时为 null |
| publish_time | integer | yes | 作品发布时间，秒级 Unix 时间戳 |
| share_count | integer | yes | 作品分享数 |
| share_url | — | yes | 作品页面/分享链接；可作为按 url 查询作品详情或评论时的输入；当前不可用时为 null |
| topic_tags | array | yes | 作品话题标签列表；无话题标签时为空数组 |
| video | — | yes | 抖音平台播放器资源；视频作品为视频播放资源，图文作品可能为音频播放资源；无法可靠识别时为 null |
No examples provided.
douyin_get_video_detail_by_url ~93
根据抖音作品页面链接、作品短链接或包含作品链接的分享文案获取作品详情。
| Name | Type | Req | Description |
|---|---|---|---|
| url | string | yes | 抖音作品页面链接、作品短链接或包含作品链接的完整分享文案；不要传 video.play_url 这类播放资源链接，也不要传用户主页链接；已知 aweme_id 时优先使用 ID 入口 |
| Name | Type | Req | Description |
|---|---|---|---|
| author | object | yes | 作品作者信息 |
| aweme_id | string | yes | 作品 aweme_id |
| collect_count | integer | yes | 作品收藏数 |
| comment_count | integer | yes | 作品评论数 |
| content_type | string | yes | 作品类型：video 表示视频，image 表示图文，unknown 表示未知 |
| cover_image_url | — | yes | 作品封面图链接；当前不可用时为 null |
| description | string | yes | 作品文案 |
| images | array | yes | 作品图片展示资源列表；图文作品按顺序返回所有图片，视频作品为空数组 |
| like_count | integer | yes | 作品点赞数 |
| mentioned_users | array | yes | 作品正文中 @ 到的用户列表；无 @ 时为空数组 |
| music | — | yes | 作品绑定音乐或原声资产；不表示视频播放时需要额外叠加播放；当前不可用时为 null |
| publish_time | integer | yes | 作品发布时间，秒级 Unix 时间戳 |
| share_count | integer | yes | 作品分享数 |
| share_url | — | yes | 作品页面/分享链接；可作为按 url 查询作品详情或评论时的输入；当前不可用时为 null |
| topic_tags | array | yes | 作品话题标签列表；无话题标签时为空数组 |
| video | — | yes | 抖音平台播放器资源；视频作品为视频播放资源，图文作品可能为音频播放资源；无法可靠识别时为 null |
No examples provided.
douyin_get_video_speech_text_job ~54
查询抖音视频口播转文字任务状态；每次最多等待 240 秒，不触发重处理。
| Name | Type | Req | Description |
|---|---|---|---|
| job_id | string | yes | 口播转文字任务 ID。 |
| Name | Type | Req | Description |
|---|---|---|---|
| content_id | string | yes | 平台内容 ID。 |
| content_meta | object | yes | 作品上下文信息，便于结合转写内容做口播分析。 |
| content_type | string | yes | 内容类型。 |
| error | — | yes | 失败或过期时的稳定错误结构；非终态或成功时为 null。 |
| is_terminal | boolean | yes | 是否已终态。 |
| job_id | string | yes | 任务 ID。 |
| message | string | yes | 面向用户/AI 的状态说明。 |
| next_action | — | yes | 非终态时建议的下一步查询动作。 |
| next_poll_after_seconds | — | yes | 建议下次查询前等待的秒数；非终态时可用。 |
| platform | string | yes | 任务所属平台。 |
| source_id | string | yes | 任务来源 ID。 |
| status | string | yes | 任务状态。 |
| transcript | — | yes | 成功时的口播转文字结果；非终态或失败时为 null。 |
No examples provided.
douyin_search_users ~339
按昵称、抖音号、账号名或达人名称搜索抖音用户、账号、博主、创作者或达人，支持粉丝数量和用户类型筛选；不用于搜索作品。
| Name | Type | Req | Description |
|---|---|---|---|
| follower_count_range | string | — | 用户粉丝数量筛选，可选：all（不限，默认）、under_1k（1000 以下）、1k_to_10k（1000-1 万）、10k_to_100k（1 万-10 万）、100k_to_1m（10 万-100 万）、over_1m（100 万以上）。如无明确筛选需求，保持 all。 |
| keyword | string | yes | 抖音用户、账号、博主、创作者或达人搜索关键词；可传昵称、抖音号、账号名或达人名称；不用于搜索作品。 |
| page_token | string | — | page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一搜索链路，不能跨能力、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| user_type | string | — | 用户类型筛选，可选：all（不限，默认）、regular_user（普通用户）、enterprise_verified（企业认证）、individual_verified（个人认证）。如无明确筛选需求，保持 all。 |
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 当前页用户搜索结果列表 |
| next_page_token | string | yes | 下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
No examples provided.
douyin_search_videos ~344
按关键词搜索抖音作品；作品通常为视频，也可能包含图文内容。
| Name | Type | Req | Description |
|---|---|---|---|
| content_type | string | — | 内容形式筛选，可选：all（不限，默认）、video（视频）、image（图文）。如无明确筛选需求，保持 all。 |
| duration_range | string | — | 视频时长筛选，可选：all（不限，默认）、under_1_minute（1 分钟以下）、one_to_five_minutes（1-5 分钟）、over_5_minutes（5 分钟以上）。如无明确筛选需求，保持 all。 |
| keyword | string | yes | 抖音搜索关键词 |
| page_token | string | — | page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一搜索链路，不能跨能力、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| publish_time_range | string | — | 发布时间范围筛选，可选：all（不限，默认）、day（一天内）、week（一周内）、half_year（半年内）。如无明确筛选需求，保持 all。 |
| sort_type | string | — | 搜索排序方式，可选：general（综合，默认）、time_descending（最新发布优先）、like_count_descending（最多点赞优先）。如无明确排序需求，保持 general。 |
| Name | Type | Req | Description |
|---|---|---|---|
| items | array | yes | 当前页搜索结果中的作品列表 |
| next_page_token | string | yes | 下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
No examples provided.
douyin_submit_video_speech_text_by_aweme_id ~106
根据抖音 aweme_id 提交视频口播转文字任务；提交完成后最多短等 240 秒，未完成时返回 job_id 和下一步查询动作。
| Name | Type | Req | Description |
|---|---|---|---|
| aweme_id | string | yes | 抖音作品的数字 aweme_id，通常可从搜索、详情或评论结果中的 aweme_id 字段复用；不要传作品链接、分享文案或带引号的字符串 |
| Name | Type | Req | Description |
|---|---|---|---|
| content_id | string | yes | 平台内容 ID。 |
| content_meta | object | yes | 作品上下文信息，便于结合转写内容做口播分析。 |
| content_type | string | yes | 内容类型。 |
| error | — | yes | 失败或过期时的稳定错误结构；非终态或成功时为 null。 |
| is_terminal | boolean | yes | 是否已终态。 |
| job_id | string | yes | 任务 ID。 |
| message | string | yes | 面向用户/AI 的状态说明。 |
| next_action | — | yes | 非终态时建议的下一步查询动作。 |
| next_poll_after_seconds | — | yes | 建议下次查询前等待的秒数；非终态时可用。 |
| platform | string | yes | 任务所属平台。 |
| source_id | string | yes | 任务来源 ID。 |
| status | string | yes | 任务状态。 |
| transcript | — | yes | 成功时的口播转文字结果；非终态或失败时为 null。 |
No examples provided.
douyin_submit_video_speech_text_by_video_url ~109
提交抖音作品视频口播转文字任务；提交完成后最多短等 240 秒，未完成时返回 job_id 和下一步查询动作。
| Name | Type | Req | Description |
|---|---|---|---|
| video_url | string | yes | 抖音作品页面链接、作品短链接或包含作品链接的完整分享文案；不要传 video.play_url 这类播放资源链接，也不要传用户主页链接；已知 aweme_id 时优先使用 ID 入口 |
| Name | Type | Req | Description |
|---|---|---|---|
| content_id | string | yes | 平台内容 ID。 |
| content_meta | object | yes | 作品上下文信息，便于结合转写内容做口播分析。 |
| content_type | string | yes | 内容类型。 |
| error | — | yes | 失败或过期时的稳定错误结构；非终态或成功时为 null。 |
| is_terminal | boolean | yes | 是否已终态。 |
| job_id | string | yes | 任务 ID。 |
| message | string | yes | 面向用户/AI 的状态说明。 |
| next_action | — | yes | 非终态时建议的下一步查询动作。 |
| next_poll_after_seconds | — | yes | 建议下次查询前等待的秒数；非终态时可用。 |
| platform | string | yes | 任务所属平台。 |
| source_id | string | yes | 任务来源 ID。 |
| status | string | yes | 任务状态。 |
| transcript | — | yes | 成功时的口播转文字结果；非终态或失败时为 null。 |
No examples provided.