hot search、suggestions、video/user/product search、comments/replies、users/works/series、transcript
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer API Key from SocialDataX / 社媒数据助手
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
获取抖音主热榜；当前不支持翻页。
This tool takes no arguments.
获取抖音主热榜；当前不支持翻页。
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}根据 product_id 读取抖音商品详情；已有完整商品 ID（包括用户直接提供）时直接使用，无需先搜索；否则可从 douyin_search_products 获取。只有商品链接或分享文案时使用 douyin_get_product_detail_by_url。
| Argument | Type | Description |
|---|---|---|
| product_id* | string | 抖音商品 ID；用户已提供完整 ID 时原样使用，无需先搜索；否则可从 douyin_search_products 返回的 items[*].product_id 原样复制；不要传 sku_id、商品链接或搜索词。 |
{
"type": "object",
"required": [
"product_id"
],
"properties": {
"product_id": {
"type": "string",
"description": "抖音商品 ID；用户已提供完整 ID 时原样使用，无需先搜索；否则可从 douyin_search_products 返回的 items[*].product_id 原样复制；不要传 sku_id、商品链接或搜索词。"
}
},
"additionalProperties": false
}根据抖音商品链接或分享文案读取商品详情；只有链接类输入时使用此入口。
| Argument | Type | Description |
|---|---|---|
| url* | string | 抖音商品短链接、商品页面链接或包含商品链接的分享文案；不要传 product_id、sku_id 或搜索词。 |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "抖音商品短链接、商品页面链接或包含商品链接的分享文案；不要传 product_id、sku_id 或搜索词。"
}
},
"additionalProperties": false
}根据用户主页展示的抖音号 douyin_id 获取用户资料。
| Argument | Type | Description |
|---|---|---|
| douyin_id* | string | 用户主页展示的公开抖音号 douyin_id；不要传昵称、搜索关键词、sec_user_id、用户主页链接或作品链接 |
{
"type": "object",
"required": [
"douyin_id"
],
"properties": {
"douyin_id": {
"type": "string",
"description": "用户主页展示的公开抖音号 douyin_id；不要传昵称、搜索关键词、sec_user_id、用户主页链接或作品链接"
}
},
"additionalProperties": false
}根据抖音主页长链接、短链接或分享文案获取用户资料。
| Argument | Type | Description |
|---|---|---|
| profile_url* | string | 抖音用户主页链接、用户短链接或用户分享文案；不要传作品链接。已知 sec_user_id 时优先使用 ID 入口 |
{
"type": "object",
"required": [
"profile_url"
],
"properties": {
"profile_url": {
"type": "string",
"description": "抖音用户主页链接、用户短链接或用户分享文案；不要传作品链接。已知 sec_user_id 时优先使用 ID 入口"
}
},
"additionalProperties": false
}根据抖音用户 sec_user_id 获取用户资料；已知 sec_user_id 时优先使用此入口。
| Argument | Type | Description |
|---|---|---|
| sec_user_id* | string | 抖音用户 sec_user_id，不透明标识；请传实际字段值，可从结果中的 sec_user_id 或 author.sec_user_id 复用；不要传公开抖音号 douyin_id、字段名或占位文本；只有主页链接时使用 profile_url 入口 |
{
"type": "object",
"required": [
"sec_user_id"
],
"properties": {
"sec_user_id": {
"type": "string",
"description": "抖音用户 sec_user_id，不透明标识；请传实际字段值，可从结果中的 sec_user_id 或 author.sec_user_id 复用；不要传公开抖音号 douyin_id、字段名或占位文本；只有主页链接时使用 profile_url 入口"
}
},
"additionalProperties": false
}根据抖音主页长链接、短链接或分享文案获取用户发布的作品列表，支持 page_token 翻页。
| Argument | Type | Description |
|---|---|---|
| page_token | string | page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一用户作品分页链路的下一页，不能跨能力或用户复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| profile_url* | string | 抖音用户主页链接、用户短链接或用户分享文案；不要传作品链接。已知 sec_user_id 时优先使用 ID 入口 |
{
"type": "object",
"required": [
"profile_url"
],
"properties": {
"page_token": {
"type": "string",
"default": "",
"description": "page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一用户作品分页链路的下一页，不能跨能力或用户复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"
},
"profile_url": {
"type": "string",
"description": "抖音用户主页链接、用户短链接或用户分享文案；不要传作品链接。已知 sec_user_id 时优先使用 ID 入口"
}
},
"additionalProperties": false
}根据抖音用户 sec_user_id 获取该用户发布的作品列表，支持 page_token 翻页。
| Argument | Type | Description |
|---|---|---|
| page_token | string | page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一用户作品分页链路的下一页，不能跨能力或用户复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| sec_user_id* | string | 抖音用户 sec_user_id，不透明标识；请传实际字段值，可从结果中的 sec_user_id 或 author.sec_user_id 复用；不要传公开抖音号 douyin_id、字段名或占位文本；只有主页链接时使用 profile_url 入口 |
{
"type": "object",
"required": [
"sec_user_id"
],
"properties": {
"page_token": {
"type": "string",
"default": "",
"description": "page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一用户作品分页链路的下一页，不能跨能力或用户复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"
},
"sec_user_id": {
"type": "string",
"description": "抖音用户 sec_user_id，不透明标识；请传实际字段值，可从结果中的 sec_user_id 或 author.sec_user_id 复用；不要传公开抖音号 douyin_id、字段名或占位文本；只有主页链接时使用 profile_url 入口"
}
},
"additionalProperties": false
}根据抖音主页长链接、短链接或分享文案获取用户短剧列表，支持 page_token 翻页。
| Argument | Type | Description |
|---|---|---|
| page_token | string | page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一用户短剧列表分页链路的下一页，不能跨能力或用户复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| profile_url* | string | 抖音用户主页链接、用户短链接或用户分享文案；不要传作品链接。已知 sec_user_id 时优先使用 ID 入口 |
{
"type": "object",
"required": [
"profile_url"
],
"properties": {
"page_token": {
"type": "string",
"default": "",
"description": "page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一用户短剧列表分页链路的下一页，不能跨能力或用户复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"
},
"profile_url": {
"type": "string",
"description": "抖音用户主页链接、用户短链接或用户分享文案；不要传作品链接。已知 sec_user_id 时优先使用 ID 入口"
}
},
"additionalProperties": false
}根据抖音用户 sec_user_id 获取该用户短剧列表，支持 page_token 翻页。
| Argument | Type | Description |
|---|---|---|
| page_token | string | page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一用户短剧列表分页链路的下一页，不能跨能力或用户复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| sec_user_id* | string | 抖音用户 sec_user_id，不透明标识；请传实际字段值，可从结果中的 sec_user_id 或 author.sec_user_id 复用；不要传公开抖音号 douyin_id、字段名或占位文本；只有主页链接时使用 profile_url 入口 |
{
"type": "object",
"required": [
"sec_user_id"
],
"properties": {
"page_token": {
"type": "string",
"default": "",
"description": "page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一用户短剧列表分页链路的下一页，不能跨能力或用户复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"
},
"sec_user_id": {
"type": "string",
"description": "抖音用户 sec_user_id，不透明标识；请传实际字段值，可从结果中的 sec_user_id 或 author.sec_user_id 复用；不要传公开抖音号 douyin_id、字段名或占位文本；只有主页链接时使用 profile_url 入口"
}
},
"additionalProperties": false
}根据 aweme_id 和一级评论 comment_id 获取抖音评论回复；需同时传入 aweme_id 和 comment_id。用户已提供完整合法组合时直接使用；已有 aweme_id、作品链接或分享文案但缺少必需 ID 时，调用对应一级评论工具补全；缺少作品定位信息时向用户索取；不要传回复项自身的 comment_id；支持 page_token 翻页。
| Argument | Type | Description |
|---|---|---|
| aweme_id* | string | 抖音作品的数字 aweme_id，通常可从搜索、详情或评论结果中的 aweme_id 字段复用；不要传作品链接、分享文案或带引号的字符串；用户已提供时直接使用；调用评论回复工具时必填，需与 comment_id 同时传入，且两者须属于同一作品 |
| comment_id* | string | 一级评论 ID comment_id；用户已提供时直接使用，否则可从一级评论结果 items[*].comment_id 复用；调用评论回复工具时必须同时传入同一作品的 aweme_id；不要传评论回复结果里的 items[*].comment_id |
| page_token | string | page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一作品下同一一级评论的回复分页链路，不能跨能力、作品或评论复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
{
"type": "object",
"required": [
"aweme_id",
"comment_id"
],
"properties": {
"aweme_id": {
"type": "string",
"description": "抖音作品的数字 aweme_id，通常可从搜索、详情或评论结果中的 aweme_id 字段复用；不要传作品链接、分享文案或带引号的字符串；用户已提供时直接使用；调用评论回复工具时必填，需与 comment_id 同时传入，且两者须属于同一作品"
},
"comment_id": {
"type": "string",
"description": "一级评论 ID comment_id；用户已提供时直接使用，否则可从一级评论结果 items[*].comment_id 复用；调用评论回复工具时必须同时传入同一作品的 aweme_id；不要传评论回复结果里的 items[*].comment_id"
},
"page_token": {
"type": "string",
"default": "",
"description": "page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一作品下同一一级评论的回复分页链路，不能跨能力、作品或评论复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"
}
},
"additionalProperties": false
}根据抖音作品 aweme_id 获取一级评论列表，支持 page_token 翻页。
| Argument | Type | Description |
|---|---|---|
| aweme_id* | string | 抖音作品的数字 aweme_id，通常可从搜索、详情或评论结果中的 aweme_id 字段复用；不要传作品链接、分享文案或带引号的字符串 |
| page_token | string | page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一作品评论分页链路的下一页，不能跨能力或作品复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
{
"type": "object",
"required": [
"aweme_id"
],
"properties": {
"aweme_id": {
"type": "string",
"description": "抖音作品的数字 aweme_id，通常可从搜索、详情或评论结果中的 aweme_id 字段复用；不要传作品链接、分享文案或带引号的字符串"
},
"page_token": {
"type": "string",
"default": "",
"description": "page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一作品评论分页链路的下一页，不能跨能力或作品复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"
}
},
"additionalProperties": false
}根据抖音作品页面链接、作品短链接或包含作品链接的分享文案获取一级评论列表，支持 page_token 翻页。
| Argument | Type | Description |
|---|---|---|
| url* | string | 抖音作品页面链接、作品短链接或包含作品链接的完整分享文案；不要传 video.play_url 这类播放资源链接，也不要传用户主页链接；已知 aweme_id 时优先使用 ID 入口 |
| page_token | string | page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一作品评论分页链路的下一页，不能跨能力或作品复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "抖音作品页面链接、作品短链接或包含作品链接的完整分享文案；不要传 video.play_url 这类播放资源链接，也不要传用户主页链接；已知 aweme_id 时优先使用 ID 入口"
},
"page_token": {
"type": "string",
"default": "",
"description": "page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一作品评论分页链路的下一页，不能跨能力或作品复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"
}
},
"additionalProperties": false
}根据抖音作品 aweme_id 获取视频或图文作品详情；已知 aweme_id 时优先使用此入口。
| Argument | Type | Description |
|---|---|---|
| aweme_id* | string | 抖音作品的数字 aweme_id，通常可从搜索、详情或评论结果中的 aweme_id 字段复用；不要传作品链接、分享文案或带引号的字符串 |
{
"type": "object",
"required": [
"aweme_id"
],
"properties": {
"aweme_id": {
"type": "string",
"description": "抖音作品的数字 aweme_id，通常可从搜索、详情或评论结果中的 aweme_id 字段复用；不要传作品链接、分享文案或带引号的字符串"
}
},
"additionalProperties": false
}根据抖音作品页面链接、作品短链接或包含作品链接的分享文案获取视频或图文作品详情。
| Argument | Type | Description |
|---|---|---|
| url* | string | 抖音作品页面链接、作品短链接或包含作品链接的完整分享文案；不要传 video.play_url 这类播放资源链接，也不要传用户主页链接；已知 aweme_id 时优先使用 ID 入口 |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "抖音作品页面链接、作品短链接或包含作品链接的完整分享文案；不要传 video.play_url 这类播放资源链接，也不要传用户主页链接；已知 aweme_id 时优先使用 ID 入口"
}
},
"additionalProperties": false
}根据作品 aweme_id 生成抖音分享短链接和可复制的完整分享文案；用户已提供 aweme_id 时直接使用，无需先搜索或读取详情。读取作品内容请使用详情工具。
| Argument | Type | Description |
|---|---|---|
| aweme_id* | string | 抖音作品的数字 aweme_id，通常可从搜索、详情或评论结果中的 aweme_id 字段复用；不要传作品链接、分享文案或带引号的字符串 |
{
"type": "object",
"required": [
"aweme_id"
],
"properties": {
"aweme_id": {
"type": "string",
"description": "抖音作品的数字 aweme_id，通常可从搜索、详情或评论结果中的 aweme_id 字段复用；不要传作品链接、分享文案或带引号的字符串"
}
},
"additionalProperties": false
}根据作品页面链接、短链接或包含作品链接的分享文案生成抖音分享短链接和完整分享文案；已知 aweme_id 时使用 ID 入口。读取作品内容请使用详情工具。
| Argument | Type | Description |
|---|---|---|
| url* | string | 抖音作品页面链接、作品短链接或包含作品链接的完整分享文案；不要传 video.play_url 这类播放资源链接，也不要传用户主页链接；已知 aweme_id 时优先使用 ID 入口 |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "抖音作品页面链接、作品短链接或包含作品链接的完整分享文案；不要传 video.play_url 这类播放资源链接，也不要传用户主页链接；已知 aweme_id 时优先使用 ID 入口"
}
},
"additionalProperties": false
}根据用户提供的有效 job_id，或 submit 工具返回的 job_id 查询抖音视频口播转文字任务状态；用于继续未完成任务，每次最多等待 240 秒，不触发重处理，也不要重复提交任务。
| Argument | Type | Description |
|---|---|---|
| job_id* | string | 口播转文字任务 ID；用户已提供时直接使用，否则使用 submit 工具返回的 job_id；不要传 aweme_id、作品链接或其他 ID。 |
{
"type": "object",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"description": "口播转文字任务 ID；用户已提供时直接使用，否则使用 submit 工具返回的 job_id；不要传 aweme_id、作品链接或其他 ID。"
}
},
"additionalProperties": false
}用户需要按关键词查找抖音全局搜索中的商品时使用；支持排序、价格、服务和卖点筛选，返回归一化商品列表与不透明分页令牌。当前服务提供详情工具时：已有 product_id 时直接使用 douyin_get_product_detail_by_product_id；已有商品链接或分享文案时使用 douyin_get_product_detail_by_url。不用于搜索作品或用户，也不表示商城频道内完整搜索链路。
| Argument | Type | Description |
|---|---|---|
| keyword* | string | 抖音商品搜索词，必填，去除首尾空白后不能为空；可传关键词或短语，例如“iPhone 16”或“露营桌”；keyword 只传搜索词，不要传商品链接、抖音平台对象 ID（如 sku_id、promotion_id、aweme_id、sec_user_id）或 page_token；不要把价格、排序或服务条件拼进 keyword，请使用对应筛选参数。 |
| max_price | any | 最高价格，正整数，单位：元；必须大于 0，不传表示不限；与 min_price 同时传入时不得小于 min_price。 |
| min_price | any | 最低价格，正整数，单位：元；必须大于 0，不传表示不限；与 max_price 同时传入时不得大于 max_price。 |
| only_live | boolean | true 时仅返回当前正在直播的商品（抖音原生筛选“直播中”）；false 表示不限（默认）。 |
| sort_type | string | 商品排序：general（综合，默认）、sales_descending（销量降序）、price_ascending（价格升序）、price_descending（价格降序）。 |
| page_token | string | page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一抖音商品搜索链路、关键词、排序和筛选条件，不能跨能力复用；翻页时 keyword、sort_type、min_price、max_price 及全部筛选参数必须与上一页保持一致；需要修改任一条件时，清空 page_token 后从第一页重新搜索；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| selling_point | string |
获取抖音普通搜索输入框联想词；不用于搜索作品、用户或商品，也不要传 page_token。
| Argument | Type | Description |
|---|---|---|
| keyword* | string | 搜索词，用于获取抖音普通搜索输入框中的联想词；不要传作品链接、用户主页链接、aweme_id、sec_user_id 或 page_token。 |
{
"type": "object",
"required": [
"keyword"
],
"properties": {
"keyword": {
"type": "string",
"description": "搜索词，用于获取抖音普通搜索输入框中的联想词；不要传作品链接、用户主页链接、aweme_id、sec_user_id 或 page_token。"
}
},
"additionalProperties": false
}搜索抖音用户、账号、博主、创作者或达人，支持 page_token 翻页。用户需要按搜索词查找用户时使用；已有 sec_user_id 或用户主页链接时使用相应用户资料或列表工具；不用于搜索作品。
| Argument | Type | Description |
|---|---|---|
| keyword* | string | 搜索词，可传昵称、抖音号、账号名、达人名称或创作者/博主名称；不用于搜索作品；不要传作品链接、用户主页链接、sec_user_id 或 page_token。 |
| user_type | string | 用户类型筛选，可选：all（不限，默认）、regular_user（普通用户）、enterprise_verified（企业认证）、individual_verified（个人认证）。如无明确筛选需求，保持 all。 |
| page_token | string | page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一搜索链路，不能跨能力、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| 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。 |
{
"type": "object",
"required": [
"keyword"
],
"properties": {
"keyword": {
"type": "string",
"description": "搜索词，可传昵称、抖音号、账号名、达人名称或创作者/博主名称；不用于搜索作品；不要传作品链接、用户主页链接、sec_user_id 或 page_token。"
},
"user_type": {
"enum": [
"all",
"regular_user",
"enterprise_verified",
"individual_verified"
],
"type": "string",
"default": "all",
"description": "用户类型筛选，可选：all（不限，默认）、regular_user（普通用户）、enterprise_verified（企业认证）、individual_verified（个人认证）。如无明确筛选需求，保持 all。"
},
"page_token": {
"type": "string",
"default": "",
"description": "page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一搜索链路，不能跨能力、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"
},
"follower_count_range": {
"enum": [
"all",
"under_1k",
"1k_to_10k",
"10k_to_100k",
"100k_to_1m",
"over_1m"
],
"type": "string",
"default": "all",
"description": "用户粉丝数量筛选，可选：all（不限，默认）、under_1k（1000 以下）、1k_to_10k（1000-1 万）、10k_to_100k（1 万-10 万）、100k_to_1m（10 万-100 万）、over_1m（100 万以上）。如无明确筛选需求，保持 all。"
}
},
"additionalProperties": false
}搜索抖音视频和图文作品。用户需要按搜索词查找作品时使用；已有作品链接或 aweme_id 且需要单篇信息时使用相应详情、评论或口播转文字工具；作品通常为视频，也可能包含图文内容；支持 page_token 翻页。
| Argument | Type | Description |
|---|---|---|
| keyword* | string | 搜索词，可传关键词或短语，例如品牌名、话题、人物名或产品名；不要传作品链接、用户主页链接、aweme_id、sec_user_id 或 page_token。 |
| sort_type | string | 搜索排序方式，可选：general（综合，默认）、time_descending（最新发布优先）、like_count_descending（最多点赞优先）。综合或默认排序请传 general，最新发布请传 time_descending，最多点赞请传 like_count_descending。hot、latest、time、relevance、relevance_desc、default、综合、general_desc、liked、like_count、liked_desc、most_liked、most_hot、popularity_descending 等写法均不是可接受值，请直接使用上述三个标准值。 |
| page_token | string | page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一搜索链路，不能跨能力、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |
| 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。 |
| publish_time_range | string | 发布时间范围筛选，可选：all（不限，默认）、day（一天内）、week（一周内）、half_year（半年内）。如无明确筛选需求，保持 all。 |
根据抖音 aweme_id 提交视频口播转文字任务；提交后最多等待 240 秒，未完成时返回 job_id 和下一步查询动作。
| Argument | Type | Description |
|---|---|---|
| aweme_id* | string | 抖音作品的数字 aweme_id，通常可从搜索、详情或评论结果中的 aweme_id 字段复用；不要传作品链接、分享文案或带引号的字符串 |
{
"type": "object",
"required": [
"aweme_id"
],
"properties": {
"aweme_id": {
"type": "string",
"description": "抖音作品的数字 aweme_id，通常可从搜索、详情或评论结果中的 aweme_id 字段复用；不要传作品链接、分享文案或带引号的字符串"
}
},
"additionalProperties": false
}提交抖音作品视频口播转文字任务；提交后最多等待 240 秒，未完成时返回 job_id 和下一步查询动作。
| Argument | Type | Description |
|---|---|---|
| video_url* | string | 抖音作品页面链接、作品短链接或包含作品链接的完整分享文案；不要传 video.play_url 这类播放资源链接，也不要传用户主页链接；已知 aweme_id 时优先使用 ID 入口 |
{
"type": "object",
"required": [
"video_url"
],
"properties": {
"video_url": {
"type": "string",
"description": "抖音作品页面链接、作品短链接或包含作品链接的完整分享文案；不要传 video.play_url 这类播放资源链接，也不要传用户主页链接；已知 aweme_id 时优先使用 ID 入口"
}
},
"additionalProperties": false
}查询当前 API Key 账户的 SocialDataX 积分余额、剩余积分或点数 / remaining points balance。需要充值时请访问 https://socialdatax.com/dashboard/billing。
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}| 卖点筛选：all（不限，默认）、high_sales（月销过万）、high_rating（好评多）。 |
| official_store | boolean | true 时仅返回带“抖音旗舰”标识的商品；false 表示不限（默认）。 |
| seven_day_return | boolean | true 时仅返回支持 7 天无理由退货的商品；false 表示不限（默认）。 |
| shipping_insurance | boolean | true 时仅返回支持运费险的商品；false 表示不限（默认）。 |
| dispatch_within_24h | boolean | true 时仅返回支持 24 小时内发货的商品；false 表示不限（默认）。 |
{
"type": "object",
"required": [
"keyword"
],
"properties": {
"keyword": {
"type": "string",
"description": "抖音商品搜索词，必填，去除首尾空白后不能为空；可传关键词或短语，例如“iPhone 16”或“露营桌”；keyword 只传搜索词，不要传商品链接、抖音平台对象 ID（如 sku_id、promotion_id、aweme_id、sec_user_id）或 page_token；不要把价格、排序或服务条件拼进 keyword，请使用对应筛选参数。"
},
"max_price": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"default": null,
"description": "最高价格，正整数，单位：元；必须大于 0，不传表示不限；与 min_price 同时传入时不得小于 min_price。"
},
"min_price": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"default": null,
"description": "最低价格，正整数，单位：元；必须大于 0，不传表示不限；与 max_price 同时传入时不得大于 max_price。"
},
"only_live": {
"type": "boolean",
"default": false,
"description": "true 时仅返回当前正在直播的商品（抖音原生筛选“直播中”）；false 表示不限（默认）。"
},
"sort_type": {
"enum": [
"general",
"sales_descending",
"price_ascending",
"price_descending"
],
"type": "string",
"default": "general",
"description": "商品排序：general（综合，默认）、sales_descending（销量降序）、price_ascending（价格升序）、price_descending（价格降序）。"
},
"page_token": {
"type": "string",
"default": "",
"description": "page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一抖音商品搜索链路、关键词、排序和筛选条件，不能跨能力复用；翻页时 keyword、sort_type、min_price、max_price 及全部筛选参数必须与上一页保持一致；需要修改任一条件时，清空 page_token 后从第一页重新搜索；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"
},
"selling_point": {
"enum": [
"all",
"high_sales",
"high_rating"
],
"type": "string",
"default": "all",
"description": "卖点筛选：all（不限，默认）、high_sales（月销过万）、high_rating（好评多）。"
},
"official_store": {
"type": "boolean",
"default": false,
"description": "true 时仅返回带“抖音旗舰”标识的商品；false 表示不限（默认）。"
},
"seven_day_return": {
"type": "boolean",
"default": false,
"description": "true 时仅返回支持 7 天无理由退货的商品；false 表示不限（默认）。"
},
"shipping_insurance": {
"type": "boolean",
"default": false,
"description": "true 时仅返回支持运费险的商品；false 表示不限（默认）。"
},
"dispatch_within_24h": {
"type": "boolean",
"default": false,
"description": "true 时仅返回支持 24 小时内发货的商品；false 表示不限（默认）。"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"keyword"
],
"properties": {
"keyword": {
"type": "string",
"description": "搜索词，可传关键词或短语，例如品牌名、话题、人物名或产品名；不要传作品链接、用户主页链接、aweme_id、sec_user_id 或 page_token。"
},
"sort_type": {
"enum": [
"general",
"time_descending",
"like_count_descending"
],
"type": "string",
"default": "general",
"description": "搜索排序方式，可选：general（综合，默认）、time_descending（最新发布优先）、like_count_descending（最多点赞优先）。综合或默认排序请传 general，最新发布请传 time_descending，最多点赞请传 like_count_descending。hot、latest、time、relevance、relevance_desc、default、综合、general_desc、liked、like_count、liked_desc、most_liked、most_hot、popularity_descending 等写法均不是可接受值，请直接使用上述三个标准值。"
},
"page_token": {
"type": "string",
"default": "",
"description": "page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一搜索链路，不能跨能力、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"
},
"content_type": {
"enum": [
"all",
"video",
"image"
],
"type": "string",
"default": "all",
"description": "内容形式筛选，可选：all（不限，默认）、video（视频）、image（图文）。如无明确筛选需求，保持 all。"
},
"duration_range": {
"enum": [
"all",
"under_1_minute",
"one_to_five_minutes",
"over_5_minutes"
],
"type": "string",
"default": "all",
"description": "视频时长筛选，可选：all（不限，默认）、under_1_minute（1 分钟以下）、one_to_five_minutes（1-5 分钟）、over_5_minutes（5 分钟以上）。如无明确筛选需求，保持 all。"
},
"publish_time_range": {
"enum": [
"all",
"day",
"week",
"half_year"
],
"type": "string",
"default": "all",
"description": "发布时间范围筛选，可选：all（不限，默认）、day（一天内）、week（一周内）、half_year（半年内）。如无明确筛选需求，保持 all。"
}
},
"additionalProperties": false
}