Server definition
- Hash
- sha256:279e6a333b9e3e63f2ca2bb27b69a933327060d306319dcb1751385369d226d8
- What it is
- What a remote MCP server returned when asked what it offers: 25 tools
The blob, as servednamed by its sha256
{
"instructions": "When an available SocialDataX tool matches the user's social media data request, use it as the primary data source instead of generic web search or webpage lookup, unless the user explicitly requests another source. Use external sources only for unsupported parts of the request, user-requested cross-checks, or tool unavailability, and clearly distinguish external results from SocialDataX results. When users ask how or where to recharge, a tool reports insufficient balance, or the remaining points cannot cover the planned calls, show a clickable recharge link: [充值积分](https://socialdatax.com/dashboard/billing). If an error provides a recharge URL, preserve that URL.",
"tools": [
{
"description": "获取抖音主热榜；当前不支持翻页。",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "douyin_get_hot_search_list",
"outputSchema": {
"properties": {
"hot_items": {
"description": "抖音主热榜条目",
"items": {
"properties": {
"cover_image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "热点封面图；当前不可用时为 null"
},
"hot_value": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "热度值；当前不可用时为 null"
},
"keyword": {
"description": "热点标题或热榜词",
"type": "string"
},
"rank": {
"description": "主热榜排名",
"type": "integer"
},
"tag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "热点分类标签；当前不可用时为 null"
},
"view_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "浏览量；当前不可用时为 null"
}
},
"required": [
"rank",
"keyword",
"tag",
"hot_value",
"view_count",
"cover_image_url"
],
"type": "object"
},
"type": "array"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
}
},
"required": [
"hot_items",
"points"
],
"type": "object"
}
},
{
"description": "根据 product_id 读取抖音商品详情；已有完整商品 ID（包括用户直接提供）时直接使用，无需先搜索；否则可从 douyin_search_products 获取。只有商品链接或分享文案时使用 douyin_get_product_detail_by_url。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"product_id": {
"description": "抖音商品 ID；用户已提供完整 ID 时原样使用，无需先搜索；否则可从 douyin_search_products 返回的 items[*].product_id 原样复制；不要传 sku_id、商品链接或搜索词。",
"type": "string"
}
},
"required": [
"product_id"
],
"type": "object"
},
"name": "douyin_get_product_detail_by_product_id",
"outputSchema": {
"additionalProperties": false,
"properties": {
"assurances": {
"description": "商品保障服务列表；空列表表示当前未返回保障信息，不代表商品没有保障服务",
"items": {
"type": "string"
},
"type": "array"
},
"detail_images": {
"description": "商品详情图列表；空列表表示当前未返回对应图片",
"items": {
"additionalProperties": false,
"properties": {
"height": {
"description": "平台返回的图片高度",
"type": "number"
},
"image_url": {
"description": "商品图片链接",
"type": "string"
},
"width": {
"description": "平台返回的图片宽度",
"type": "number"
}
},
"required": [
"image_url",
"width",
"height"
],
"type": "object"
},
"type": "array"
},
"discount_price": {
"description": "优惠后起售价，单位：元；不限定为券后价，也不保证是最终实付价；没有单独优惠价时与 price 相同",
"type": "number"
},
"main_images": {
"description": "商品顶部主图/轮播图列表；空列表表示当前未返回对应图片",
"items": {
"additionalProperties": false,
"properties": {
"height": {
"description": "平台返回的图片高度",
"type": "number"
},
"image_url": {
"description": "商品图片链接",
"type": "string"
},
"width": {
"description": "平台返回的图片宽度",
"type": "number"
}
},
"required": [
"image_url",
"width",
"height"
],
"type": "object"
},
"type": "array"
},
"on_sale": {
"description": "商品当前是否在售；不等同于指定 SKU 有库存或当前用户可购买",
"type": "boolean"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
},
"price": {
"description": "商品起售价，单位：元；不是指定 SKU 的价格，也不保证是最终实付价",
"type": "number"
},
"product_id": {
"description": "商品 ID；可直接使用商品搜索结果中的 product_id",
"type": "string"
},
"sales_text": {
"description": "平台展示的商品销量文本；没有时为空字符串；带“+”的数量表示下限，不是精确销量",
"type": "string"
},
"shipping": {
"additionalProperties": false,
"description": "发货信息；不包含发货地",
"properties": {
"fee": {
"description": "运费展示文本；没有运费信息时为空字符串",
"type": "string"
},
"text": {
"description": "发货说明；没有发货说明时为空字符串",
"type": "string"
}
},
"required": [
"fee",
"text"
],
"type": "object"
},
"shop_avatar_url": {
"description": "店铺头像链接",
"type": "string"
},
"shop_id": {
"description": "店铺 ID",
"type": "string"
},
"shop_name": {
"description": "店铺名称",
"type": "string"
},
"sold_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "从销量文本解析的已售数量；不带“+”的万级展示数量换算为整数（如已售 1.5万返回 15000），不代表精确销量，须结合 sales_text 解读；缺失或无法解析时为 null，不代表零销量；0 表示明确已售 0"
},
"title": {
"description": "商品标题",
"type": "string"
},
"variant_groups": {
"description": "可选商品规格组（name/options），不是商品属性参数或已选 SKU；空列表表示当前未返回规格信息，不代表商品只有一种规格",
"items": {
"additionalProperties": false,
"properties": {
"name": {
"description": "规格组名称",
"type": "string"
},
"options": {
"description": "规格选项列表",
"items": {
"additionalProperties": false,
"properties": {
"name": {
"description": "规格选项名称",
"type": "string"
},
"spec_id": {
"description": "规格选项 ID，不是 SKU ID，不能用作商品详情查询的 product_id",
"type": "string"
}
},
"required": [
"spec_id",
"name"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"name",
"options"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"product_id",
"title",
"price",
"discount_price",
"sales_text",
"sold_count",
"shop_id",
"shop_name",
"shop_avatar_url",
"main_images",
"detail_images",
"assurances",
"shipping",
"variant_groups",
"on_sale",
"points"
],
"type": "object"
}
},
{
"description": "根据抖音商品链接或分享文案读取商品详情；只有链接类输入时使用此入口。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"url": {
"description": "抖音商品短链接、商品页面链接或包含商品链接的分享文案；不要传 product_id、sku_id 或搜索词。",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "douyin_get_product_detail_by_url",
"outputSchema": {
"additionalProperties": false,
"properties": {
"assurances": {
"description": "商品保障服务列表；空列表表示当前未返回保障信息，不代表商品没有保障服务",
"items": {
"type": "string"
},
"type": "array"
},
"detail_images": {
"description": "商品详情图列表；空列表表示当前未返回对应图片",
"items": {
"additionalProperties": false,
"properties": {
"height": {
"description": "平台返回的图片高度",
"type": "number"
},
"image_url": {
"description": "商品图片链接",
"type": "string"
},
"width": {
"description": "平台返回的图片宽度",
"type": "number"
}
},
"required": [
"image_url",
"width",
"height"
],
"type": "object"
},
"type": "array"
},
"discount_price": {
"description": "优惠后起售价，单位：元；不限定为券后价，也不保证是最终实付价；没有单独优惠价时与 price 相同",
"type": "number"
},
"main_images": {
"description": "商品顶部主图/轮播图列表；空列表表示当前未返回对应图片",
"items": {
"additionalProperties": false,
"properties": {
"height": {
"description": "平台返回的图片高度",
"type": "number"
},
"image_url": {
"description": "商品图片链接",
"type": "string"
},
"width": {
"description": "平台返回的图片宽度",
"type": "number"
}
},
"required": [
"image_url",
"width",
"height"
],
"type": "object"
},
"type": "array"
},
"on_sale": {
"description": "商品当前是否在售；不等同于指定 SKU 有库存或当前用户可购买",
"type": "boolean"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
},
"price": {
"description": "商品起售价，单位：元；不是指定 SKU 的价格，也不保证是最终实付价",
"type": "number"
},
"product_id": {
"description": "商品 ID；可直接使用商品搜索结果中的 product_id",
"type": "string"
},
"sales_text": {
"description": "平台展示的商品销量文本；没有时为空字符串；带“+”的数量表示下限，不是精确销量",
"type": "string"
},
"shipping": {
"additionalProperties": false,
"description": "发货信息；不包含发货地",
"properties": {
"fee": {
"description": "运费展示文本；没有运费信息时为空字符串",
"type": "string"
},
"text": {
"description": "发货说明；没有发货说明时为空字符串",
"type": "string"
}
},
"required": [
"fee",
"text"
],
"type": "object"
},
"shop_avatar_url": {
"description": "店铺头像链接",
"type": "string"
},
"shop_id": {
"description": "店铺 ID",
"type": "string"
},
"shop_name": {
"description": "店铺名称",
"type": "string"
},
"sold_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "从销量文本解析的已售数量；不带“+”的万级展示数量换算为整数（如已售 1.5万返回 15000），不代表精确销量，须结合 sales_text 解读；缺失或无法解析时为 null，不代表零销量；0 表示明确已售 0"
},
"title": {
"description": "商品标题",
"type": "string"
},
"variant_groups": {
"description": "可选商品规格组（name/options），不是商品属性参数或已选 SKU；空列表表示当前未返回规格信息，不代表商品只有一种规格",
"items": {
"additionalProperties": false,
"properties": {
"name": {
"description": "规格组名称",
"type": "string"
},
"options": {
"description": "规格选项列表",
"items": {
"additionalProperties": false,
"properties": {
"name": {
"description": "规格选项名称",
"type": "string"
},
"spec_id": {
"description": "规格选项 ID，不是 SKU ID，不能用作商品详情查询的 product_id",
"type": "string"
}
},
"required": [
"spec_id",
"name"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"name",
"options"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"product_id",
"title",
"price",
"discount_price",
"sales_text",
"sold_count",
"shop_id",
"shop_name",
"shop_avatar_url",
"main_images",
"detail_images",
"assurances",
"shipping",
"variant_groups",
"on_sale",
"points"
],
"type": "object"
}
},
{
"description": "根据用户主页展示的抖音号 douyin_id 获取用户资料。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"douyin_id": {
"description": "用户主页展示的公开抖音号 douyin_id；不要传昵称、搜索关键词、sec_user_id、用户主页链接或作品链接",
"type": "string"
}
},
"required": [
"douyin_id"
],
"type": "object"
},
"name": "douyin_get_user_info_by_douyin_id",
"outputSchema": {
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户头像链接；当前不可用时为 null"
},
"bio": {
"description": "用户简介；当前不可用时为空字符串",
"type": "string"
},
"cross_platform_follower_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "关联平台合计粉丝数；当前不可用时为 null"
},
"douyin_follower_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "抖音单端粉丝数；当前不可用时为 null"
},
"douyin_id": {
"description": "用户主页展示的抖音号；当前不可用时为空字符串",
"type": "string"
},
"follower_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台展示的粉丝数；当前不可用时为 null"
},
"following_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "关注数；当前不可用时为 null"
},
"gender": {
"description": "性别：male 表示男，female 表示女，unknown 表示未知",
"enum": [
"male",
"female",
"unknown"
],
"type": "string"
},
"ip_location": {
"description": "IP 属地；当前不可用时为空字符串",
"type": "string"
},
"live_info": {
"anyOf": [
{
"properties": {
"is_live": {
"description": "用户当前是否正在直播",
"type": "boolean"
},
"live_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "直播间页面链接；当前不可用时为 null"
},
"online_user_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "请求时直播间在线人数快照；当前不可用时为 null"
},
"room_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "直播间 ID；当前不可用时为 null"
}
},
"required": [
"is_live",
"room_id",
"live_url",
"online_user_count"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "用户直播状态摘要；用户当前未直播时为 null"
},
"name": {
"description": "用户昵称",
"type": "string"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
},
"posted_content_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "用户已发布作品数量，包含视频、图文等作品；当前不可用时为 null"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户主页链接；当前不可用时为 null"
},
"received_like_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "用户内容累计收到的点赞数；当前不可用时为 null"
},
"sec_user_id": {
"description": "用户 sec_user_id；当前不可用时为空字符串",
"type": "string"
},
"user_id": {
"description": "用户 user_id；当前不可用时为空字符串",
"type": "string"
},
"verification_label": {
"description": "用户认证文案；当前不可用时为空字符串",
"type": "string"
},
"verified": {
"description": "用户是否为认证账号",
"type": "boolean"
}
},
"required": [
"user_id",
"sec_user_id",
"name",
"avatar_url",
"profile_url",
"bio",
"verification_label",
"verified",
"follower_count",
"following_count",
"received_like_count",
"douyin_id",
"ip_location",
"gender",
"posted_content_count",
"live_info",
"points"
],
"type": "object"
}
},
{
"description": "根据抖音主页长链接、短链接或分享文案获取用户资料。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"profile_url": {
"description": "抖音用户主页链接、用户短链接或用户分享文案；不要传作品链接。已知 sec_user_id 时优先使用 ID 入口",
"type": "string"
}
},
"required": [
"profile_url"
],
"type": "object"
},
"name": "douyin_get_user_info_by_profile_url",
"outputSchema": {
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户头像链接；当前不可用时为 null"
},
"bio": {
"description": "用户简介；当前不可用时为空字符串",
"type": "string"
},
"cross_platform_follower_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "关联平台合计粉丝数；当前不可用时为 null"
},
"douyin_follower_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "抖音单端粉丝数；当前不可用时为 null"
},
"douyin_id": {
"description": "用户主页展示的抖音号；当前不可用时为空字符串",
"type": "string"
},
"follower_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台展示的粉丝数；当前不可用时为 null"
},
"following_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "关注数；当前不可用时为 null"
},
"gender": {
"description": "性别：male 表示男，female 表示女，unknown 表示未知",
"enum": [
"male",
"female",
"unknown"
],
"type": "string"
},
"ip_location": {
"description": "IP 属地；当前不可用时为空字符串",
"type": "string"
},
"live_info": {
"anyOf": [
{
"properties": {
"is_live": {
"description": "用户当前是否正在直播",
"type": "boolean"
},
"live_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "直播间页面链接；当前不可用时为 null"
},
"online_user_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "请求时直播间在线人数快照；当前不可用时为 null"
},
"room_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "直播间 ID；当前不可用时为 null"
}
},
"required": [
"is_live",
"room_id",
"live_url",
"online_user_count"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "用户直播状态摘要；用户当前未直播时为 null"
},
"name": {
"description": "用户昵称",
"type": "string"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
},
"posted_content_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "用户已发布作品数量，包含视频、图文等作品；当前不可用时为 null"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户主页链接；当前不可用时为 null"
},
"received_like_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "用户内容累计收到的点赞数；当前不可用时为 null"
},
"sec_user_id": {
"description": "用户 sec_user_id；当前不可用时为空字符串",
"type": "string"
},
"user_id": {
"description": "用户 user_id；当前不可用时为空字符串",
"type": "string"
},
"verification_label": {
"description": "用户认证文案；当前不可用时为空字符串",
"type": "string"
},
"verified": {
"description": "用户是否为认证账号",
"type": "boolean"
}
},
"required": [
"user_id",
"sec_user_id",
"name",
"avatar_url",
"profile_url",
"bio",
"verification_label",
"verified",
"follower_count",
"following_count",
"received_like_count",
"douyin_id",
"ip_location",
"gender",
"posted_content_count",
"live_info",
"points"
],
"type": "object"
}
},
{
"description": "根据抖音用户 sec_user_id 获取用户资料；已知 sec_user_id 时优先使用此入口。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"sec_user_id": {
"description": "抖音用户 sec_user_id，不透明标识；请传实际字段值，可从结果中的 sec_user_id 或 author.sec_user_id 复用；不要传公开抖音号 douyin_id、字段名或占位文本；只有主页链接时使用 profile_url 入口",
"type": "string"
}
},
"required": [
"sec_user_id"
],
"type": "object"
},
"name": "douyin_get_user_info_by_sec_user_id",
"outputSchema": {
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户头像链接；当前不可用时为 null"
},
"bio": {
"description": "用户简介；当前不可用时为空字符串",
"type": "string"
},
"cross_platform_follower_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "关联平台合计粉丝数；当前不可用时为 null"
},
"douyin_follower_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "抖音单端粉丝数；当前不可用时为 null"
},
"douyin_id": {
"description": "用户主页展示的抖音号；当前不可用时为空字符串",
"type": "string"
},
"follower_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台展示的粉丝数；当前不可用时为 null"
},
"following_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "关注数；当前不可用时为 null"
},
"gender": {
"description": "性别：male 表示男，female 表示女，unknown 表示未知",
"enum": [
"male",
"female",
"unknown"
],
"type": "string"
},
"ip_location": {
"description": "IP 属地；当前不可用时为空字符串",
"type": "string"
},
"live_info": {
"anyOf": [
{
"properties": {
"is_live": {
"description": "用户当前是否正在直播",
"type": "boolean"
},
"live_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "直播间页面链接；当前不可用时为 null"
},
"online_user_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "请求时直播间在线人数快照；当前不可用时为 null"
},
"room_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "直播间 ID；当前不可用时为 null"
}
},
"required": [
"is_live",
"room_id",
"live_url",
"online_user_count"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "用户直播状态摘要；用户当前未直播时为 null"
},
"name": {
"description": "用户昵称",
"type": "string"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
},
"posted_content_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "用户已发布作品数量，包含视频、图文等作品；当前不可用时为 null"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户主页链接；当前不可用时为 null"
},
"received_like_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "用户内容累计收到的点赞数；当前不可用时为 null"
},
"sec_user_id": {
"description": "用户 sec_user_id；当前不可用时为空字符串",
"type": "string"
},
"user_id": {
"description": "用户 user_id；当前不可用时为空字符串",
"type": "string"
},
"verification_label": {
"description": "用户认证文案；当前不可用时为空字符串",
"type": "string"
},
"verified": {
"description": "用户是否为认证账号",
"type": "boolean"
}
},
"required": [
"user_id",
"sec_user_id",
"name",
"avatar_url",
"profile_url",
"bio",
"verification_label",
"verified",
"follower_count",
"following_count",
"received_like_count",
"douyin_id",
"ip_location",
"gender",
"posted_content_count",
"live_info",
"points"
],
"type": "object"
}
},
{
"description": "根据抖音主页长链接、短链接或分享文案获取用户发布的作品列表，支持 page_token 翻页。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"page_token": {
"default": "",
"description": "page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一用户作品分页链路的下一页，不能跨能力或用户复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"profile_url": {
"description": "抖音用户主页链接、用户短链接或用户分享文案；不要传作品链接。已知 sec_user_id 时优先使用 ID 入口",
"type": "string"
}
},
"required": [
"profile_url"
],
"type": "object"
},
"name": "douyin_get_user_posted_videos_by_profile_url",
"outputSchema": {
"properties": {
"items": {
"description": "当前页作品列表",
"items": {
"properties": {
"author": {
"description": "作品作者信息",
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户头像链接；当前不可用时为 null"
},
"bio": {
"description": "用户简介；当前不可用时为空字符串",
"type": "string"
},
"douyin_id": {
"description": "用户主页展示的抖音号；当前不可用时为空字符串",
"type": "string"
},
"follower_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台展示的粉丝数；当前不可用时为 null"
},
"following_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "关注数；当前不可用时为 null"
},
"name": {
"description": "用户昵称",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户主页链接；当前不可用时为 null"
},
"received_like_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "用户内容累计收到的点赞数；当前不可用时为 null"
},
"sec_user_id": {
"description": "用户 sec_user_id；当前不可用时为空字符串",
"type": "string"
},
"user_id": {
"description": "用户 user_id；当前不可用时为空字符串",
"type": "string"
},
"verification_label": {
"description": "用户认证文案；当前不可用时为空字符串",
"type": "string"
},
"verified": {
"description": "用户是否为认证账号",
"type": "boolean"
}
},
"required": [
"user_id",
"sec_user_id",
"name",
"avatar_url",
"profile_url",
"bio",
"verification_label",
"verified",
"follower_count",
"following_count",
"received_like_count",
"douyin_id"
],
"type": "object"
},
"aweme_id": {
"description": "作品 aweme_id",
"type": "string"
},
"collect_count": {
"description": "收藏数",
"type": "integer"
},
"comment_count": {
"description": "评论数",
"type": "integer"
},
"content_type": {
"description": "作品类型：video 表示视频，image 表示图文，unknown 表示未知",
"enum": [
"video",
"image",
"unknown"
],
"type": "string"
},
"cover_image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "封面图链接；当前不可用时为 null"
},
"description": {
"description": "作品文案",
"type": "string"
},
"images": {
"description": "图文图片资源列表；图文作品按顺序返回所有图片，视频作品为空数组",
"items": {
"properties": {
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片高度，像素；当前不可用时为 null"
},
"live_photo": {
"anyOf": [
{
"properties": {
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片动效视频资源时长，毫秒；当前不可用时为 null"
},
"format": {
"description": "图片动效视频资源格式，例如 mp4",
"type": "string"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片动效视频资源高度，像素；当前不可用时为 null"
},
"play_url": {
"description": "图片动效视频资源链接；用于还原图文作品中单张图片的动态效果，通常为 mp4",
"type": "string"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片动效视频资源宽度，像素；当前不可用时为 null"
}
},
"required": [
"play_url",
"duration_ms",
"width",
"height",
"format"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "图片动效视频资源；普通静态图片为 null，不表示作品主视频或背景音乐"
},
"url": {
"description": "图片展示资源链接；用于查看或分析图片内容",
"type": "string"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片宽度，像素；当前不可用时为 null"
}
},
"required": [
"url",
"width",
"height",
"live_photo"
],
"type": "object"
},
"type": "array"
},
"like_count": {
"description": "点赞数",
"type": "integer"
},
"publish_time": {
"description": "作品发布时间，秒级 Unix 时间戳",
"type": "integer"
},
"share_count": {
"description": "分享数",
"type": "integer"
},
"share_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作品页面或分享链接；可继续按 url 查询作品详情或评论；当前不可用时为 null"
},
"topic_tags": {
"description": "作品话题标签列表；无话题标签时为空数组",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"description": "话题标签 ID；当前不可用时为空字符串",
"type": "string"
},
"name": {
"description": "话题标签名称",
"type": "string"
}
},
"required": [
"name",
"id"
],
"type": "object"
},
"type": "array"
},
"video": {
"anyOf": [
{
"properties": {
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "播放器资源时长，毫秒；当前不可用时为 null"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "播放器资源高度，像素；当前不可用时为 null"
},
"media_type": {
"description": "播放器资源类型：video 表示视频，audio 表示音频，unknown 表示未知",
"enum": [
"video",
"audio",
"unknown"
],
"type": "string"
},
"play_url": {
"description": "抖音平台播放器资源链接；视频作品通常为 mp4，图文作品可能为音频播放资源；不同于作品页面或分享链接，不用于查询作品详情或评论",
"type": "string"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "播放器资源宽度，像素；当前不可用时为 null"
}
},
"required": [
"play_url",
"duration_ms",
"width",
"height",
"media_type"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "作品播放器资源；视频作品通常为视频，图文作品可能为音频播放资源"
}
},
"required": [
"aweme_id",
"content_type",
"description",
"publish_time",
"cover_image_url",
"images",
"video",
"share_url",
"topic_tags",
"author",
"like_count",
"comment_count",
"collect_count",
"share_count"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
}
},
"required": [
"items",
"next_page_token",
"points"
],
"type": "object"
}
},
{
"description": "根据抖音用户 sec_user_id 获取该用户发布的作品列表，支持 page_token 翻页。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"page_token": {
"default": "",
"description": "page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一用户作品分页链路的下一页，不能跨能力或用户复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"sec_user_id": {
"description": "抖音用户 sec_user_id，不透明标识；请传实际字段值，可从结果中的 sec_user_id 或 author.sec_user_id 复用；不要传公开抖音号 douyin_id、字段名或占位文本；只有主页链接时使用 profile_url 入口",
"type": "string"
}
},
"required": [
"sec_user_id"
],
"type": "object"
},
"name": "douyin_get_user_posted_videos_by_sec_user_id",
"outputSchema": {
"properties": {
"items": {
"description": "当前页作品列表",
"items": {
"properties": {
"author": {
"description": "作品作者信息",
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户头像链接；当前不可用时为 null"
},
"bio": {
"description": "用户简介；当前不可用时为空字符串",
"type": "string"
},
"douyin_id": {
"description": "用户主页展示的抖音号；当前不可用时为空字符串",
"type": "string"
},
"follower_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台展示的粉丝数；当前不可用时为 null"
},
"following_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "关注数；当前不可用时为 null"
},
"name": {
"description": "用户昵称",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户主页链接；当前不可用时为 null"
},
"received_like_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "用户内容累计收到的点赞数；当前不可用时为 null"
},
"sec_user_id": {
"description": "用户 sec_user_id；当前不可用时为空字符串",
"type": "string"
},
"user_id": {
"description": "用户 user_id；当前不可用时为空字符串",
"type": "string"
},
"verification_label": {
"description": "用户认证文案；当前不可用时为空字符串",
"type": "string"
},
"verified": {
"description": "用户是否为认证账号",
"type": "boolean"
}
},
"required": [
"user_id",
"sec_user_id",
"name",
"avatar_url",
"profile_url",
"bio",
"verification_label",
"verified",
"follower_count",
"following_count",
"received_like_count",
"douyin_id"
],
"type": "object"
},
"aweme_id": {
"description": "作品 aweme_id",
"type": "string"
},
"collect_count": {
"description": "收藏数",
"type": "integer"
},
"comment_count": {
"description": "评论数",
"type": "integer"
},
"content_type": {
"description": "作品类型：video 表示视频，image 表示图文，unknown 表示未知",
"enum": [
"video",
"image",
"unknown"
],
"type": "string"
},
"cover_image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "封面图链接；当前不可用时为 null"
},
"description": {
"description": "作品文案",
"type": "string"
},
"images": {
"description": "图文图片资源列表；图文作品按顺序返回所有图片，视频作品为空数组",
"items": {
"properties": {
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片高度，像素；当前不可用时为 null"
},
"live_photo": {
"anyOf": [
{
"properties": {
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片动效视频资源时长，毫秒；当前不可用时为 null"
},
"format": {
"description": "图片动效视频资源格式，例如 mp4",
"type": "string"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片动效视频资源高度，像素；当前不可用时为 null"
},
"play_url": {
"description": "图片动效视频资源链接；用于还原图文作品中单张图片的动态效果，通常为 mp4",
"type": "string"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片动效视频资源宽度，像素；当前不可用时为 null"
}
},
"required": [
"play_url",
"duration_ms",
"width",
"height",
"format"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "图片动效视频资源；普通静态图片为 null，不表示作品主视频或背景音乐"
},
"url": {
"description": "图片展示资源链接；用于查看或分析图片内容",
"type": "string"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片宽度，像素；当前不可用时为 null"
}
},
"required": [
"url",
"width",
"height",
"live_photo"
],
"type": "object"
},
"type": "array"
},
"like_count": {
"description": "点赞数",
"type": "integer"
},
"publish_time": {
"description": "作品发布时间，秒级 Unix 时间戳",
"type": "integer"
},
"share_count": {
"description": "分享数",
"type": "integer"
},
"share_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作品页面或分享链接；可继续按 url 查询作品详情或评论；当前不可用时为 null"
},
"topic_tags": {
"description": "作品话题标签列表；无话题标签时为空数组",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"description": "话题标签 ID；当前不可用时为空字符串",
"type": "string"
},
"name": {
"description": "话题标签名称",
"type": "string"
}
},
"required": [
"name",
"id"
],
"type": "object"
},
"type": "array"
},
"video": {
"anyOf": [
{
"properties": {
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "播放器资源时长，毫秒；当前不可用时为 null"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "播放器资源高度，像素；当前不可用时为 null"
},
"media_type": {
"description": "播放器资源类型：video 表示视频，audio 表示音频，unknown 表示未知",
"enum": [
"video",
"audio",
"unknown"
],
"type": "string"
},
"play_url": {
"description": "抖音平台播放器资源链接；视频作品通常为 mp4，图文作品可能为音频播放资源；不同于作品页面或分享链接，不用于查询作品详情或评论",
"type": "string"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "播放器资源宽度，像素；当前不可用时为 null"
}
},
"required": [
"play_url",
"duration_ms",
"width",
"height",
"media_type"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "作品播放器资源；视频作品通常为视频，图文作品可能为音频播放资源"
}
},
"required": [
"aweme_id",
"content_type",
"description",
"publish_time",
"cover_image_url",
"images",
"video",
"share_url",
"topic_tags",
"author",
"like_count",
"comment_count",
"collect_count",
"share_count"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
}
},
"required": [
"items",
"next_page_token",
"points"
],
"type": "object"
}
},
{
"description": "根据抖音主页长链接、短链接或分享文案获取用户短剧列表，支持 page_token 翻页。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"page_token": {
"default": "",
"description": "page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一用户短剧列表分页链路的下一页，不能跨能力或用户复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"profile_url": {
"description": "抖音用户主页链接、用户短链接或用户分享文案；不要传作品链接。已知 sec_user_id 时优先使用 ID 入口",
"type": "string"
}
},
"required": [
"profile_url"
],
"type": "object"
},
"name": "douyin_get_user_series_by_profile_url",
"outputSchema": {
"properties": {
"items": {
"description": "当前页短剧列表",
"items": {
"properties": {
"author": {
"description": "短剧作者信息",
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户头像链接；当前不可用时为 null"
},
"bio": {
"description": "用户简介；当前不可用时为空字符串",
"type": "string"
},
"douyin_id": {
"description": "用户主页展示的抖音号；当前不可用时为空字符串",
"type": "string"
},
"follower_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台展示的粉丝数；当前不可用时为 null"
},
"following_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "关注数；当前不可用时为 null"
},
"name": {
"description": "用户昵称",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户主页链接；当前不可用时为 null"
},
"received_like_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "用户内容累计收到的点赞数；当前不可用时为 null"
},
"sec_user_id": {
"description": "用户 sec_user_id；当前不可用时为空字符串",
"type": "string"
},
"user_id": {
"description": "用户 user_id；当前不可用时为空字符串",
"type": "string"
},
"verification_label": {
"description": "用户认证文案；当前不可用时为空字符串",
"type": "string"
},
"verified": {
"description": "用户是否为认证账号",
"type": "boolean"
}
},
"required": [
"user_id",
"sec_user_id",
"name",
"avatar_url",
"profile_url",
"bio",
"verification_label",
"verified",
"follower_count",
"following_count",
"received_like_count",
"douyin_id"
],
"type": "object"
},
"collect_count": {
"description": "收藏数",
"type": "integer"
},
"cover_image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "短剧封面图链接；当前不可用时为 null"
},
"create_time": {
"description": "短剧创建时间，秒级 Unix 时间戳",
"type": "integer"
},
"description": {
"description": "短剧简介；当前不可用时为空字符串",
"type": "string"
},
"play_count": {
"description": "播放数",
"type": "integer"
},
"series_id": {
"description": "短剧 ID",
"type": "string"
},
"share_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "短剧页面或分享链接；当前不可用时为 null"
},
"title": {
"description": "短剧标题",
"type": "string"
},
"total_episode_count": {
"description": "总集数",
"type": "integer"
},
"update_time": {
"description": "短剧更新时间，秒级 Unix 时间戳",
"type": "integer"
},
"updated_episode_count": {
"description": "已更新到的集数",
"type": "integer"
}
},
"required": [
"series_id",
"title",
"description",
"cover_image_url",
"share_url",
"create_time",
"update_time",
"play_count",
"collect_count",
"total_episode_count",
"updated_episode_count",
"author"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
}
},
"required": [
"items",
"next_page_token",
"points"
],
"type": "object"
}
},
{
"description": "根据抖音用户 sec_user_id 获取该用户短剧列表，支持 page_token 翻页。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"page_token": {
"default": "",
"description": "page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一用户短剧列表分页链路的下一页，不能跨能力或用户复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"sec_user_id": {
"description": "抖音用户 sec_user_id，不透明标识；请传实际字段值，可从结果中的 sec_user_id 或 author.sec_user_id 复用；不要传公开抖音号 douyin_id、字段名或占位文本；只有主页链接时使用 profile_url 入口",
"type": "string"
}
},
"required": [
"sec_user_id"
],
"type": "object"
},
"name": "douyin_get_user_series_by_sec_user_id",
"outputSchema": {
"properties": {
"items": {
"description": "当前页短剧列表",
"items": {
"properties": {
"author": {
"description": "短剧作者信息",
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户头像链接；当前不可用时为 null"
},
"bio": {
"description": "用户简介；当前不可用时为空字符串",
"type": "string"
},
"douyin_id": {
"description": "用户主页展示的抖音号；当前不可用时为空字符串",
"type": "string"
},
"follower_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台展示的粉丝数；当前不可用时为 null"
},
"following_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "关注数；当前不可用时为 null"
},
"name": {
"description": "用户昵称",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户主页链接；当前不可用时为 null"
},
"received_like_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "用户内容累计收到的点赞数；当前不可用时为 null"
},
"sec_user_id": {
"description": "用户 sec_user_id；当前不可用时为空字符串",
"type": "string"
},
"user_id": {
"description": "用户 user_id；当前不可用时为空字符串",
"type": "string"
},
"verification_label": {
"description": "用户认证文案；当前不可用时为空字符串",
"type": "string"
},
"verified": {
"description": "用户是否为认证账号",
"type": "boolean"
}
},
"required": [
"user_id",
"sec_user_id",
"name",
"avatar_url",
"profile_url",
"bio",
"verification_label",
"verified",
"follower_count",
"following_count",
"received_like_count",
"douyin_id"
],
"type": "object"
},
"collect_count": {
"description": "收藏数",
"type": "integer"
},
"cover_image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "短剧封面图链接；当前不可用时为 null"
},
"create_time": {
"description": "短剧创建时间，秒级 Unix 时间戳",
"type": "integer"
},
"description": {
"description": "短剧简介；当前不可用时为空字符串",
"type": "string"
},
"play_count": {
"description": "播放数",
"type": "integer"
},
"series_id": {
"description": "短剧 ID",
"type": "string"
},
"share_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "短剧页面或分享链接；当前不可用时为 null"
},
"title": {
"description": "短剧标题",
"type": "string"
},
"total_episode_count": {
"description": "总集数",
"type": "integer"
},
"update_time": {
"description": "短剧更新时间，秒级 Unix 时间戳",
"type": "integer"
},
"updated_episode_count": {
"description": "已更新到的集数",
"type": "integer"
}
},
"required": [
"series_id",
"title",
"description",
"cover_image_url",
"share_url",
"create_time",
"update_time",
"play_count",
"collect_count",
"total_episode_count",
"updated_episode_count",
"author"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
}
},
"required": [
"items",
"next_page_token",
"points"
],
"type": "object"
}
},
{
"description": "根据 aweme_id 和一级评论 comment_id 获取抖音评论回复；需同时传入 aweme_id 和 comment_id。用户已提供完整合法组合时直接使用；已有 aweme_id、作品链接或分享文案但缺少必需 ID 时，调用对应一级评论工具补全；缺少作品定位信息时向用户索取；不要传回复项自身的 comment_id；支持 page_token 翻页。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"aweme_id": {
"description": "抖音作品的数字 aweme_id，通常可从搜索、详情或评论结果中的 aweme_id 字段复用；不要传作品链接、分享文案或带引号的字符串；用户已提供时直接使用；调用评论回复工具时必填，需与 comment_id 同时传入，且两者须属于同一作品",
"type": "string"
},
"comment_id": {
"description": "一级评论 ID comment_id；用户已提供时直接使用，否则可从一级评论结果 items[*].comment_id 复用；调用评论回复工具时必须同时传入同一作品的 aweme_id；不要传评论回复结果里的 items[*].comment_id",
"type": "string"
},
"page_token": {
"default": "",
"description": "page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一作品下同一一级评论的回复分页链路，不能跨能力、作品或评论复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
}
},
"required": [
"aweme_id",
"comment_id"
],
"type": "object"
},
"name": "douyin_get_video_comment_replies_by_comment_id",
"outputSchema": {
"properties": {
"comment_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "该一级评论下的回复总量；当前不可用时为 null"
},
"items": {
"description": "当前页评论回复列表",
"items": {
"properties": {
"author": {
"description": "评论作者信息",
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "评论作者头像链接；当前不可用时为 null"
},
"douyin_id": {
"description": "评论作者主页展示的抖音号；当前不可用时为空字符串",
"type": "string"
},
"name": {
"description": "评论作者昵称",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "评论作者主页链接；当前不可用时为 null"
},
"sec_user_id": {
"description": "评论作者 sec_user_id；当前不可用时为空字符串",
"type": "string"
},
"user_id": {
"description": "评论作者 user_id；当前不可用时为空字符串",
"type": "string"
},
"verification_label": {
"description": "评论作者认证文案；当前不可用时为空字符串",
"type": "string"
},
"verified": {
"description": "评论作者是否为认证账号",
"type": "boolean"
}
},
"required": [
"user_id",
"sec_user_id",
"douyin_id",
"name",
"avatar_url",
"profile_url",
"verification_label",
"verified"
],
"type": "object"
},
"aweme_id": {
"description": "作品 aweme_id",
"type": "string"
},
"comment_id": {
"description": "当前评论回复自身 ID；不是读取回复时输入的一级评论 comment_id",
"type": "string"
},
"content": {
"description": "评论内容",
"type": "string"
},
"content_type": {
"description": "评论内容类型：text 表示文字，image 表示图片，sticker 表示表情或动图，unknown 表示未知",
"enum": [
"text",
"image",
"sticker",
"unknown"
],
"type": "string"
},
"create_time": {
"description": "评论发布时间，秒级 Unix 时间戳",
"type": "integer"
},
"image_urls": {
"description": "评论图片链接列表；无图片时为空数组",
"items": {
"type": "string"
},
"type": "array"
},
"ip_location": {
"description": "评论 IP 属地；当前不可用时为空字符串",
"type": "string"
},
"is_folded": {
"description": "评论是否折叠",
"type": "boolean"
},
"is_hot": {
"description": "是否为热评",
"type": "boolean"
},
"like_count": {
"description": "评论点赞数",
"type": "integer"
},
"reply_count": {
"description": "评论回复数",
"type": "integer"
},
"sticker": {
"anyOf": [
{
"properties": {
"animated_url": {
"description": "表情或动图的动态资源链接；不可用时为空字符串",
"type": "string"
},
"static_url": {
"description": "表情或动图的静态预览图链接；不可用时为空字符串",
"type": "string"
}
},
"required": [
"static_url",
"animated_url"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "评论表情或动图资源；无表情或动图时为 null"
}
},
"required": [
"comment_id",
"aweme_id",
"content",
"content_type",
"create_time",
"like_count",
"reply_count",
"ip_location",
"image_urls",
"sticker",
"is_hot",
"is_folded",
"author"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
}
},
"required": [
"items",
"next_page_token",
"comment_count",
"points"
],
"type": "object"
}
},
{
"description": "根据抖音作品 aweme_id 获取一级评论列表，支持 page_token 翻页。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"aweme_id": {
"description": "抖音作品的数字 aweme_id，通常可从搜索、详情或评论结果中的 aweme_id 字段复用；不要传作品链接、分享文案或带引号的字符串",
"type": "string"
},
"page_token": {
"default": "",
"description": "page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一作品评论分页链路的下一页，不能跨能力或作品复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
}
},
"required": [
"aweme_id"
],
"type": "object"
},
"name": "douyin_get_video_comments_by_aweme_id",
"outputSchema": {
"properties": {
"comment_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "作品评论总量；当前不可用时为 null"
},
"items": {
"description": "当前页一级评论列表",
"items": {
"properties": {
"author": {
"description": "评论作者信息",
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "评论作者头像链接；当前不可用时为 null"
},
"douyin_id": {
"description": "评论作者主页展示的抖音号；当前不可用时为空字符串",
"type": "string"
},
"name": {
"description": "评论作者昵称",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "评论作者主页链接；当前不可用时为 null"
},
"sec_user_id": {
"description": "评论作者 sec_user_id；当前不可用时为空字符串",
"type": "string"
},
"user_id": {
"description": "评论作者 user_id；当前不可用时为空字符串",
"type": "string"
},
"verification_label": {
"description": "评论作者认证文案；当前不可用时为空字符串",
"type": "string"
},
"verified": {
"description": "评论作者是否为认证账号",
"type": "boolean"
}
},
"required": [
"user_id",
"sec_user_id",
"douyin_id",
"name",
"avatar_url",
"profile_url",
"verification_label",
"verified"
],
"type": "object"
},
"aweme_id": {
"description": "作品 aweme_id",
"type": "string"
},
"comment_id": {
"description": "当前一级评论 ID",
"type": "string"
},
"content": {
"description": "评论内容",
"type": "string"
},
"content_type": {
"description": "评论内容类型：text 表示文字，image 表示图片，sticker 表示表情或动图，unknown 表示未知",
"enum": [
"text",
"image",
"sticker",
"unknown"
],
"type": "string"
},
"create_time": {
"description": "评论发布时间，秒级 Unix 时间戳",
"type": "integer"
},
"image_urls": {
"description": "评论图片链接列表；无图片时为空数组",
"items": {
"type": "string"
},
"type": "array"
},
"ip_location": {
"description": "评论 IP 属地；当前不可用时为空字符串",
"type": "string"
},
"is_folded": {
"description": "评论是否折叠",
"type": "boolean"
},
"is_hot": {
"description": "是否为热评",
"type": "boolean"
},
"like_count": {
"description": "评论点赞数",
"type": "integer"
},
"mentioned_users": {
"description": "当前一级评论正文中 @ 到的用户列表；无 @ 时为空数组",
"items": {
"properties": {
"end": {
"description": "@ 文本在原文中的结束位置",
"type": "integer"
},
"name": {
"description": "被 @ 用户昵称；当前不可用时为空字符串",
"type": "string"
},
"sec_user_id": {
"description": "被 @ 用户的 sec_user_id；当前不可用时为空字符串",
"type": "string"
},
"start": {
"description": "@ 文本在原文中的起始位置",
"type": "integer"
},
"user_id": {
"description": "被 @ 用户的 user_id",
"type": "string"
}
},
"required": [
"user_id",
"sec_user_id",
"name",
"start",
"end"
],
"type": "object"
},
"type": "array"
},
"reply_count": {
"description": "评论回复数",
"type": "integer"
},
"sticker": {
"anyOf": [
{
"properties": {
"animated_url": {
"description": "表情或动图的动态资源链接；不可用时为空字符串",
"type": "string"
},
"static_url": {
"description": "表情或动图的静态预览图链接；不可用时为空字符串",
"type": "string"
}
},
"required": [
"static_url",
"animated_url"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "评论表情或动图资源；无表情或动图时为 null"
}
},
"required": [
"comment_id",
"aweme_id",
"content",
"content_type",
"create_time",
"like_count",
"reply_count",
"ip_location",
"image_urls",
"sticker",
"is_hot",
"is_folded",
"mentioned_users",
"author"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
}
},
"required": [
"items",
"next_page_token",
"comment_count",
"points"
],
"type": "object"
}
},
{
"description": "根据抖音作品页面链接、作品短链接或包含作品链接的分享文案获取一级评论列表，支持 page_token 翻页。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"page_token": {
"default": "",
"description": "page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一作品评论分页链路的下一页，不能跨能力或作品复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"url": {
"description": "抖音作品页面链接、作品短链接或包含作品链接的完整分享文案；不要传 video.play_url 这类播放资源链接，也不要传用户主页链接；已知 aweme_id 时优先使用 ID 入口",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "douyin_get_video_comments_by_url",
"outputSchema": {
"properties": {
"comment_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "作品评论总量；当前不可用时为 null"
},
"items": {
"description": "当前页一级评论列表",
"items": {
"properties": {
"author": {
"description": "评论作者信息",
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "评论作者头像链接；当前不可用时为 null"
},
"douyin_id": {
"description": "评论作者主页展示的抖音号；当前不可用时为空字符串",
"type": "string"
},
"name": {
"description": "评论作者昵称",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "评论作者主页链接；当前不可用时为 null"
},
"sec_user_id": {
"description": "评论作者 sec_user_id；当前不可用时为空字符串",
"type": "string"
},
"user_id": {
"description": "评论作者 user_id；当前不可用时为空字符串",
"type": "string"
},
"verification_label": {
"description": "评论作者认证文案；当前不可用时为空字符串",
"type": "string"
},
"verified": {
"description": "评论作者是否为认证账号",
"type": "boolean"
}
},
"required": [
"user_id",
"sec_user_id",
"douyin_id",
"name",
"avatar_url",
"profile_url",
"verification_label",
"verified"
],
"type": "object"
},
"aweme_id": {
"description": "作品 aweme_id",
"type": "string"
},
"comment_id": {
"description": "当前一级评论 ID",
"type": "string"
},
"content": {
"description": "评论内容",
"type": "string"
},
"content_type": {
"description": "评论内容类型：text 表示文字，image 表示图片，sticker 表示表情或动图，unknown 表示未知",
"enum": [
"text",
"image",
"sticker",
"unknown"
],
"type": "string"
},
"create_time": {
"description": "评论发布时间，秒级 Unix 时间戳",
"type": "integer"
},
"image_urls": {
"description": "评论图片链接列表；无图片时为空数组",
"items": {
"type": "string"
},
"type": "array"
},
"ip_location": {
"description": "评论 IP 属地；当前不可用时为空字符串",
"type": "string"
},
"is_folded": {
"description": "评论是否折叠",
"type": "boolean"
},
"is_hot": {
"description": "是否为热评",
"type": "boolean"
},
"like_count": {
"description": "评论点赞数",
"type": "integer"
},
"mentioned_users": {
"description": "当前一级评论正文中 @ 到的用户列表；无 @ 时为空数组",
"items": {
"properties": {
"end": {
"description": "@ 文本在原文中的结束位置",
"type": "integer"
},
"name": {
"description": "被 @ 用户昵称；当前不可用时为空字符串",
"type": "string"
},
"sec_user_id": {
"description": "被 @ 用户的 sec_user_id；当前不可用时为空字符串",
"type": "string"
},
"start": {
"description": "@ 文本在原文中的起始位置",
"type": "integer"
},
"user_id": {
"description": "被 @ 用户的 user_id",
"type": "string"
}
},
"required": [
"user_id",
"sec_user_id",
"name",
"start",
"end"
],
"type": "object"
},
"type": "array"
},
"reply_count": {
"description": "评论回复数",
"type": "integer"
},
"sticker": {
"anyOf": [
{
"properties": {
"animated_url": {
"description": "表情或动图的动态资源链接；不可用时为空字符串",
"type": "string"
},
"static_url": {
"description": "表情或动图的静态预览图链接；不可用时为空字符串",
"type": "string"
}
},
"required": [
"static_url",
"animated_url"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "评论表情或动图资源；无表情或动图时为 null"
}
},
"required": [
"comment_id",
"aweme_id",
"content",
"content_type",
"create_time",
"like_count",
"reply_count",
"ip_location",
"image_urls",
"sticker",
"is_hot",
"is_folded",
"mentioned_users",
"author"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
}
},
"required": [
"items",
"next_page_token",
"comment_count",
"points"
],
"type": "object"
}
},
{
"description": "根据抖音作品 aweme_id 获取视频或图文作品详情；已知 aweme_id 时优先使用此入口。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"aweme_id": {
"description": "抖音作品的数字 aweme_id，通常可从搜索、详情或评论结果中的 aweme_id 字段复用；不要传作品链接、分享文案或带引号的字符串",
"type": "string"
}
},
"required": [
"aweme_id"
],
"type": "object"
},
"name": "douyin_get_video_detail_by_aweme_id",
"outputSchema": {
"properties": {
"author": {
"description": "作品作者信息",
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户头像链接；当前不可用时为 null"
},
"bio": {
"description": "用户简介；当前不可用时为空字符串",
"type": "string"
},
"douyin_id": {
"description": "用户主页展示的抖音号；当前不可用时为空字符串",
"type": "string"
},
"follower_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台展示的粉丝数；当前不可用时为 null"
},
"following_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "关注数；当前不可用时为 null"
},
"name": {
"description": "用户昵称",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户主页链接；当前不可用时为 null"
},
"received_like_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "用户内容累计收到的点赞数；当前不可用时为 null"
},
"sec_user_id": {
"description": "用户 sec_user_id；当前不可用时为空字符串",
"type": "string"
},
"user_id": {
"description": "用户 user_id；当前不可用时为空字符串",
"type": "string"
},
"verification_label": {
"description": "用户认证文案；当前不可用时为空字符串",
"type": "string"
},
"verified": {
"description": "用户是否为认证账号",
"type": "boolean"
}
},
"required": [
"user_id",
"sec_user_id",
"name",
"avatar_url",
"profile_url",
"bio",
"verification_label",
"verified",
"follower_count",
"following_count",
"received_like_count",
"douyin_id"
],
"type": "object"
},
"aweme_id": {
"description": "作品 aweme_id",
"type": "string"
},
"collect_count": {
"description": "作品收藏数",
"type": "integer"
},
"comment_count": {
"description": "作品评论数",
"type": "integer"
},
"content_type": {
"description": "作品类型：video 表示视频，image 表示图文，unknown 表示未知",
"enum": [
"video",
"image",
"unknown"
],
"type": "string"
},
"cover_image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作品封面图链接；当前不可用时为 null"
},
"description": {
"description": "作品文案",
"type": "string"
},
"images": {
"description": "作品图片展示资源列表；图文作品按顺序返回所有图片，视频作品为空数组",
"items": {
"properties": {
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片高度，像素；当前不可用时为 null"
},
"live_photo": {
"anyOf": [
{
"properties": {
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片动效视频资源时长，毫秒；当前不可用时为 null"
},
"format": {
"description": "图片动效视频资源格式，例如 mp4",
"type": "string"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片动效视频资源高度，像素；当前不可用时为 null"
},
"play_url": {
"description": "图片动效视频资源链接；用于还原图文作品中单张图片的动态效果，通常为 mp4",
"type": "string"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片动效视频资源宽度，像素；当前不可用时为 null"
}
},
"required": [
"play_url",
"duration_ms",
"width",
"height",
"format"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "图片动效视频资源；普通静态图片为 null，不表示作品主视频或背景音乐"
},
"url": {
"description": "图片展示资源链接；用于查看或分析图片内容",
"type": "string"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片宽度，像素；当前不可用时为 null"
}
},
"required": [
"url",
"width",
"height",
"live_photo"
],
"type": "object"
},
"type": "array"
},
"like_count": {
"description": "作品点赞数",
"type": "integer"
},
"mentioned_users": {
"description": "作品正文中 @ 到的用户列表；无 @ 时为空数组",
"items": {
"properties": {
"end": {
"description": "@ 文本在原文中的结束位置",
"type": "integer"
},
"name": {
"description": "被 @ 用户昵称；当前不可用时为空字符串",
"type": "string"
},
"sec_user_id": {
"description": "被 @ 用户的 sec_user_id；当前不可用时为空字符串",
"type": "string"
},
"start": {
"description": "@ 文本在原文中的起始位置",
"type": "integer"
},
"user_id": {
"description": "被 @ 用户的 user_id",
"type": "string"
}
},
"required": [
"user_id",
"sec_user_id",
"name",
"start",
"end"
],
"type": "object"
},
"type": "array"
},
"music": {
"anyOf": [
{
"properties": {
"author": {
"description": "音乐或原声作者；当前不可用时为空字符串",
"type": "string"
},
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "音乐或原声时长，毫秒；当前不可用时为 null"
},
"play_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "音乐或原声播放链接；当前不可用时为 null"
},
"title": {
"description": "作品绑定音乐或原声标题；当前不可用时为空字符串",
"type": "string"
}
},
"required": [
"title",
"author",
"play_url",
"duration_ms"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "作品绑定音乐或原声资产；不表示视频播放时需要额外叠加播放；当前不可用时为 null"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
},
"publish_time": {
"description": "作品发布时间，秒级 Unix 时间戳",
"type": "integer"
},
"share_count": {
"description": "作品分享数",
"type": "integer"
},
"share_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作品页面/分享链接；可作为按 url 查询作品详情或评论时的输入；当前不可用时为 null"
},
"topic_tags": {
"description": "作品话题标签列表；无话题标签时为空数组",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"description": "话题标签 ID；当前不可用时为空字符串",
"type": "string"
},
"name": {
"description": "话题标签名称",
"type": "string"
}
},
"required": [
"name",
"id"
],
"type": "object"
},
"type": "array"
},
"video": {
"anyOf": [
{
"properties": {
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "播放器资源时长，毫秒；当前不可用时为 null"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "播放器资源高度，像素；当前不可用时为 null"
},
"media_type": {
"description": "播放器资源类型：video 表示视频，audio 表示音频，unknown 表示未知",
"enum": [
"video",
"audio",
"unknown"
],
"type": "string"
},
"play_url": {
"description": "抖音平台播放器资源链接；视频作品通常为 mp4，图文作品可能为音频播放资源；不同于作品页面或分享链接，不用于查询作品详情或评论",
"type": "string"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "播放器资源宽度，像素；当前不可用时为 null"
}
},
"required": [
"play_url",
"duration_ms",
"width",
"height",
"media_type"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "抖音平台播放器资源；视频作品为视频播放资源，图文作品可能为音频播放资源；无法可靠识别时为 null"
}
},
"required": [
"aweme_id",
"content_type",
"description",
"publish_time",
"cover_image_url",
"images",
"video",
"music",
"share_url",
"mentioned_users",
"topic_tags",
"like_count",
"comment_count",
"collect_count",
"share_count",
"author",
"points"
],
"type": "object"
}
},
{
"description": "根据抖音作品页面链接、作品短链接或包含作品链接的分享文案获取视频或图文作品详情。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"url": {
"description": "抖音作品页面链接、作品短链接或包含作品链接的完整分享文案；不要传 video.play_url 这类播放资源链接，也不要传用户主页链接；已知 aweme_id 时优先使用 ID 入口",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "douyin_get_video_detail_by_url",
"outputSchema": {
"properties": {
"author": {
"description": "作品作者信息",
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户头像链接；当前不可用时为 null"
},
"bio": {
"description": "用户简介；当前不可用时为空字符串",
"type": "string"
},
"douyin_id": {
"description": "用户主页展示的抖音号；当前不可用时为空字符串",
"type": "string"
},
"follower_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台展示的粉丝数；当前不可用时为 null"
},
"following_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "关注数；当前不可用时为 null"
},
"name": {
"description": "用户昵称",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户主页链接；当前不可用时为 null"
},
"received_like_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "用户内容累计收到的点赞数；当前不可用时为 null"
},
"sec_user_id": {
"description": "用户 sec_user_id；当前不可用时为空字符串",
"type": "string"
},
"user_id": {
"description": "用户 user_id；当前不可用时为空字符串",
"type": "string"
},
"verification_label": {
"description": "用户认证文案；当前不可用时为空字符串",
"type": "string"
},
"verified": {
"description": "用户是否为认证账号",
"type": "boolean"
}
},
"required": [
"user_id",
"sec_user_id",
"name",
"avatar_url",
"profile_url",
"bio",
"verification_label",
"verified",
"follower_count",
"following_count",
"received_like_count",
"douyin_id"
],
"type": "object"
},
"aweme_id": {
"description": "作品 aweme_id",
"type": "string"
},
"collect_count": {
"description": "作品收藏数",
"type": "integer"
},
"comment_count": {
"description": "作品评论数",
"type": "integer"
},
"content_type": {
"description": "作品类型：video 表示视频，image 表示图文，unknown 表示未知",
"enum": [
"video",
"image",
"unknown"
],
"type": "string"
},
"cover_image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作品封面图链接；当前不可用时为 null"
},
"description": {
"description": "作品文案",
"type": "string"
},
"images": {
"description": "作品图片展示资源列表；图文作品按顺序返回所有图片，视频作品为空数组",
"items": {
"properties": {
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片高度，像素；当前不可用时为 null"
},
"live_photo": {
"anyOf": [
{
"properties": {
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片动效视频资源时长，毫秒；当前不可用时为 null"
},
"format": {
"description": "图片动效视频资源格式，例如 mp4",
"type": "string"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片动效视频资源高度，像素；当前不可用时为 null"
},
"play_url": {
"description": "图片动效视频资源链接；用于还原图文作品中单张图片的动态效果，通常为 mp4",
"type": "string"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片动效视频资源宽度，像素；当前不可用时为 null"
}
},
"required": [
"play_url",
"duration_ms",
"width",
"height",
"format"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "图片动效视频资源；普通静态图片为 null，不表示作品主视频或背景音乐"
},
"url": {
"description": "图片展示资源链接；用于查看或分析图片内容",
"type": "string"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片宽度，像素；当前不可用时为 null"
}
},
"required": [
"url",
"width",
"height",
"live_photo"
],
"type": "object"
},
"type": "array"
},
"like_count": {
"description": "作品点赞数",
"type": "integer"
},
"mentioned_users": {
"description": "作品正文中 @ 到的用户列表；无 @ 时为空数组",
"items": {
"properties": {
"end": {
"description": "@ 文本在原文中的结束位置",
"type": "integer"
},
"name": {
"description": "被 @ 用户昵称；当前不可用时为空字符串",
"type": "string"
},
"sec_user_id": {
"description": "被 @ 用户的 sec_user_id；当前不可用时为空字符串",
"type": "string"
},
"start": {
"description": "@ 文本在原文中的起始位置",
"type": "integer"
},
"user_id": {
"description": "被 @ 用户的 user_id",
"type": "string"
}
},
"required": [
"user_id",
"sec_user_id",
"name",
"start",
"end"
],
"type": "object"
},
"type": "array"
},
"music": {
"anyOf": [
{
"properties": {
"author": {
"description": "音乐或原声作者；当前不可用时为空字符串",
"type": "string"
},
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "音乐或原声时长，毫秒；当前不可用时为 null"
},
"play_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "音乐或原声播放链接；当前不可用时为 null"
},
"title": {
"description": "作品绑定音乐或原声标题；当前不可用时为空字符串",
"type": "string"
}
},
"required": [
"title",
"author",
"play_url",
"duration_ms"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "作品绑定音乐或原声资产；不表示视频播放时需要额外叠加播放；当前不可用时为 null"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
},
"publish_time": {
"description": "作品发布时间，秒级 Unix 时间戳",
"type": "integer"
},
"share_count": {
"description": "作品分享数",
"type": "integer"
},
"share_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作品页面/分享链接；可作为按 url 查询作品详情或评论时的输入；当前不可用时为 null"
},
"topic_tags": {
"description": "作品话题标签列表；无话题标签时为空数组",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"description": "话题标签 ID；当前不可用时为空字符串",
"type": "string"
},
"name": {
"description": "话题标签名称",
"type": "string"
}
},
"required": [
"name",
"id"
],
"type": "object"
},
"type": "array"
},
"video": {
"anyOf": [
{
"properties": {
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "播放器资源时长，毫秒；当前不可用时为 null"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "播放器资源高度，像素；当前不可用时为 null"
},
"media_type": {
"description": "播放器资源类型：video 表示视频，audio 表示音频，unknown 表示未知",
"enum": [
"video",
"audio",
"unknown"
],
"type": "string"
},
"play_url": {
"description": "抖音平台播放器资源链接；视频作品通常为 mp4，图文作品可能为音频播放资源；不同于作品页面或分享链接，不用于查询作品详情或评论",
"type": "string"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "播放器资源宽度，像素；当前不可用时为 null"
}
},
"required": [
"play_url",
"duration_ms",
"width",
"height",
"media_type"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "抖音平台播放器资源；视频作品为视频播放资源，图文作品可能为音频播放资源；无法可靠识别时为 null"
}
},
"required": [
"aweme_id",
"content_type",
"description",
"publish_time",
"cover_image_url",
"images",
"video",
"music",
"share_url",
"mentioned_users",
"topic_tags",
"like_count",
"comment_count",
"collect_count",
"share_count",
"author",
"points"
],
"type": "object"
}
},
{
"description": "根据作品 aweme_id 生成抖音分享短链接和可复制的完整分享文案；用户已提供 aweme_id 时直接使用，无需先搜索或读取详情。读取作品内容请使用详情工具。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"aweme_id": {
"description": "抖音作品的数字 aweme_id，通常可从搜索、详情或评论结果中的 aweme_id 字段复用；不要传作品链接、分享文案或带引号的字符串",
"type": "string"
}
},
"required": [
"aweme_id"
],
"type": "object"
},
"name": "douyin_get_video_share_link_by_aweme_id",
"outputSchema": {
"properties": {
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
},
"share_text": {
"description": "包含短链接的完整分享文案，可复制分享。",
"type": "string"
},
"short_url": {
"description": "抖音作品分享短链接。",
"type": "string"
}
},
"required": [
"share_text",
"short_url",
"points"
],
"type": "object"
}
},
{
"description": "根据作品页面链接、短链接或包含作品链接的分享文案生成抖音分享短链接和完整分享文案；已知 aweme_id 时使用 ID 入口。读取作品内容请使用详情工具。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"url": {
"description": "抖音作品页面链接、作品短链接或包含作品链接的完整分享文案；不要传 video.play_url 这类播放资源链接，也不要传用户主页链接；已知 aweme_id 时优先使用 ID 入口",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "douyin_get_video_share_link_by_url",
"outputSchema": {
"properties": {
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
},
"share_text": {
"description": "包含短链接的完整分享文案，可复制分享。",
"type": "string"
},
"short_url": {
"description": "抖音作品分享短链接。",
"type": "string"
}
},
"required": [
"share_text",
"short_url",
"points"
],
"type": "object"
}
},
{
"description": "根据用户提供的有效 job_id，或 submit 工具返回的 job_id 查询抖音视频口播转文字任务状态；用于继续未完成任务，每次最多等待 240 秒，不触发重处理，也不要重复提交任务。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"job_id": {
"description": "口播转文字任务 ID；用户已提供时直接使用，否则使用 submit 工具返回的 job_id；不要传 aweme_id、作品链接或其他 ID。",
"type": "string"
}
},
"required": [
"job_id"
],
"type": "object"
},
"name": "douyin_get_video_speech_text_job",
"outputSchema": {
"additionalProperties": false,
"properties": {
"content_id": {
"description": "平台内容 ID。",
"type": "string"
},
"content_meta": {
"additionalProperties": false,
"description": "作品上下文信息，便于结合转写内容做口播分析。",
"properties": {
"author": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者头像链接。"
},
"name": {
"description": "作者昵称。",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者主页链接。"
},
"user_id": {
"description": "作者用户 ID。",
"type": "string"
}
},
"required": [
"user_id",
"name",
"profile_url",
"avatar_url"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "作者信息。"
},
"content_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作品链接。"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "平台作品原始描述、正文或配文。"
},
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "音视频时长，单位毫秒。"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作品标题；平台无标题时为 null。"
}
},
"required": [
"content_url",
"title",
"description",
"duration_ms",
"author"
],
"type": "object"
},
"content_type": {
"description": "内容类型。",
"type": "string"
},
"error": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"code": {
"description": "稳定错误码。",
"type": "string"
},
"message": {
"description": "面向用户的错误说明。",
"type": "string"
},
"retryable": {
"default": false,
"description": "是否可重试。",
"type": "boolean"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "失败或过期时的稳定错误结构；非终态或成功时为 null。"
},
"is_terminal": {
"description": "是否已终态。",
"type": "boolean"
},
"job_id": {
"description": "任务 ID。",
"type": "string"
},
"message": {
"description": "面向用户/AI 的状态说明。",
"type": "string"
},
"next_action": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": true,
"description": "下一步查询工具可直接使用的参数。",
"type": "object"
},
"instruction": {
"description": "给 AI/客户端的查询指令，说明如何继续轮询到终态。",
"type": "string"
},
"job_id": {
"description": "需要继续查询的 job_id。",
"type": "string"
},
"tool_name": {
"description": "下一步建议调用的查询工具。",
"type": "string"
}
},
"required": [
"tool_name",
"job_id",
"arguments",
"instruction"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "非终态时建议的下一步查询动作。"
},
"next_poll_after_seconds": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "建议下次查询前等待的秒数；非终态时可用。"
},
"platform": {
"description": "任务所属平台。",
"type": "string"
},
"source_id": {
"description": "任务来源 ID。",
"type": "string"
},
"status": {
"description": "任务状态。",
"enum": [
"queued",
"running",
"succeeded",
"failed",
"expired"
],
"type": "string"
},
"transcript": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"segments": {
"description": "按时间顺序排列的分段结果。",
"items": {
"additionalProperties": false,
"properties": {
"end_ms": {
"description": "分段结束时间，单位毫秒。",
"minimum": 0,
"type": "integer"
},
"start_ms": {
"description": "分段开始时间，单位毫秒。",
"minimum": 0,
"type": "integer"
},
"text": {
"description": "分段文本。",
"type": "string"
}
},
"required": [
"start_ms",
"end_ms",
"text"
],
"type": "object"
},
"type": "array"
},
"text": {
"description": "完整口播转文字结果。",
"type": "string"
}
},
"required": [
"text",
"segments"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "成功时的口播转文字结果；非终态或失败时为 null。"
}
},
"required": [
"job_id",
"status",
"is_terminal",
"platform",
"content_id",
"source_id",
"content_type",
"content_meta",
"transcript",
"error",
"next_poll_after_seconds",
"next_action",
"message"
],
"type": "object"
}
},
{
"description": "用户需要按关键词查找抖音全局搜索中的商品时使用；支持排序、价格、服务和卖点筛选，返回归一化商品列表与不透明分页令牌。当前服务提供详情工具时：已有 product_id 时直接使用 douyin_get_product_detail_by_product_id；已有商品链接或分享文案时使用 douyin_get_product_detail_by_url。不用于搜索作品或用户，也不表示商城频道内完整搜索链路。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"dispatch_within_24h": {
"default": false,
"description": "true 时仅返回支持 24 小时内发货的商品；false 表示不限（默认）。",
"type": "boolean"
},
"keyword": {
"description": "抖音商品搜索词，必填，去除首尾空白后不能为空；可传关键词或短语，例如“iPhone 16”或“露营桌”；keyword 只传搜索词，不要传商品链接、抖音平台对象 ID（如 sku_id、promotion_id、aweme_id、sec_user_id）或 page_token；不要把价格、排序或服务条件拼进 keyword，请使用对应筛选参数。",
"type": "string"
},
"max_price": {
"anyOf": [
{
"exclusiveMinimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "最高价格，正整数，单位：元；必须大于 0，不传表示不限；与 min_price 同时传入时不得小于 min_price。"
},
"min_price": {
"anyOf": [
{
"exclusiveMinimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "最低价格，正整数，单位：元；必须大于 0，不传表示不限；与 max_price 同时传入时不得大于 max_price。"
},
"official_store": {
"default": false,
"description": "true 时仅返回带“抖音旗舰”标识的商品；false 表示不限（默认）。",
"type": "boolean"
},
"only_live": {
"default": false,
"description": "true 时仅返回当前正在直播的商品（抖音原生筛选“直播中”）；false 表示不限（默认）。",
"type": "boolean"
},
"page_token": {
"default": "",
"description": "page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一抖音商品搜索链路、关键词、排序和筛选条件，不能跨能力复用；翻页时 keyword、sort_type、min_price、max_price 及全部筛选参数必须与上一页保持一致；需要修改任一条件时，清空 page_token 后从第一页重新搜索；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"selling_point": {
"default": "all",
"description": "卖点筛选：all（不限，默认）、high_sales（月销过万）、high_rating（好评多）。",
"enum": [
"all",
"high_sales",
"high_rating"
],
"type": "string"
},
"seven_day_return": {
"default": false,
"description": "true 时仅返回支持 7 天无理由退货的商品；false 表示不限（默认）。",
"type": "boolean"
},
"shipping_insurance": {
"default": false,
"description": "true 时仅返回支持运费险的商品；false 表示不限（默认）。",
"type": "boolean"
},
"sort_type": {
"default": "general",
"description": "商品排序：general（综合，默认）、sales_descending（销量降序）、price_ascending（价格升序）、price_descending（价格降序）。",
"enum": [
"general",
"sales_descending",
"price_ascending",
"price_descending"
],
"type": "string"
}
},
"required": [
"keyword"
],
"type": "object"
},
"name": "douyin_search_products",
"outputSchema": {
"properties": {
"items": {
"description": "当前页商品列表",
"items": {
"properties": {
"card_type": {
"description": "商品卡类型：product（普通商品）、video（视频商品）、live（直播商品）",
"enum": [
"product",
"video",
"live"
],
"type": "string"
},
"image_url": {
"description": "商品主图链接",
"type": "string"
},
"live_room_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "直播商品卡关联的直播间 ID；card_type 不是 live 时为 null"
},
"price": {
"description": "商品卡展示价格，单位：元；不保证是最终实付价",
"type": "number"
},
"product_id": {
"description": "商品 ID；不要与当前商品卡对应的 sku_id 混用",
"type": "string"
},
"shop_id": {
"description": "店铺 ID",
"type": "string"
},
"sku_id": {
"description": "当前商品卡对应的规格 SKU ID",
"type": "string"
},
"title": {
"description": "商品标题",
"type": "string"
},
"video_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "视频商品卡关联的视频 ID；card_type 不是 video 时为 null"
}
},
"required": [
"product_id",
"sku_id",
"title",
"image_url",
"price",
"shop_id",
"card_type",
"video_id",
"live_room_id"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
}
},
"required": [
"items",
"next_page_token",
"points"
],
"type": "object"
}
},
{
"description": "获取抖音普通搜索输入框联想词；不用于搜索作品、用户或商品，也不要传 page_token。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"keyword": {
"description": "搜索词，用于获取抖音普通搜索输入框中的联想词；不要传作品链接、用户主页链接、aweme_id、sec_user_id 或 page_token。",
"type": "string"
}
},
"required": [
"keyword"
],
"type": "object"
},
"name": "douyin_search_suggestions",
"outputSchema": {
"additionalProperties": false,
"properties": {
"items": {
"description": "联想词列表",
"items": {
"additionalProperties": false,
"properties": {
"text": {
"description": "普通搜索输入框中的联想词",
"type": "string"
}
},
"required": [
"text"
],
"type": "object"
},
"type": "array"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
}
},
"required": [
"items",
"points"
],
"type": "object"
}
},
{
"description": "搜索抖音用户、账号、博主、创作者或达人，支持 page_token 翻页。用户需要按搜索词查找用户时使用；已有 sec_user_id 或用户主页链接时使用相应用户资料或列表工具；不用于搜索作品。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"follower_count_range": {
"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。",
"enum": [
"all",
"under_1k",
"1k_to_10k",
"10k_to_100k",
"100k_to_1m",
"over_1m"
],
"type": "string"
},
"keyword": {
"description": "搜索词，可传昵称、抖音号、账号名、达人名称或创作者/博主名称；不用于搜索作品；不要传作品链接、用户主页链接、sec_user_id 或 page_token。",
"type": "string"
},
"page_token": {
"default": "",
"description": "page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一搜索链路，不能跨能力、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"user_type": {
"default": "all",
"description": "用户类型筛选，可选：all（不限，默认）、regular_user（普通用户）、enterprise_verified（企业认证）、individual_verified（个人认证）。如无明确筛选需求，保持 all。",
"enum": [
"all",
"regular_user",
"enterprise_verified",
"individual_verified"
],
"type": "string"
}
},
"required": [
"keyword"
],
"type": "object"
},
"name": "douyin_search_users",
"outputSchema": {
"properties": {
"items": {
"description": "当前页用户搜索结果列表",
"items": {
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户头像链接；当前不可用时为 null"
},
"bio": {
"description": "用户简介；当前不可用时为空字符串",
"type": "string"
},
"douyin_id": {
"description": "用户主页展示的抖音号；当前不可用时为空字符串",
"type": "string"
},
"follower_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台展示的粉丝数；当前不可用时为 null"
},
"following_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "关注数；当前不可用时为 null"
},
"name": {
"description": "用户昵称",
"type": "string"
},
"posted_content_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "用户已发布作品数量，包含视频、图文等作品；当前不可用时为 null"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户主页链接；当前不可用时为 null"
},
"received_like_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "用户内容累计收到的点赞数；当前不可用时为 null"
},
"sec_user_id": {
"description": "用户 sec_user_id；当前不可用时为空字符串",
"type": "string"
},
"user_id": {
"description": "用户 user_id；当前不可用时为空字符串",
"type": "string"
},
"verification_label": {
"description": "用户认证文案；当前不可用时为空字符串",
"type": "string"
},
"verified": {
"description": "用户是否为认证账号",
"type": "boolean"
}
},
"required": [
"user_id",
"sec_user_id",
"name",
"avatar_url",
"profile_url",
"bio",
"verification_label",
"verified",
"follower_count",
"following_count",
"received_like_count",
"douyin_id",
"posted_content_count"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
}
},
"required": [
"items",
"next_page_token",
"points"
],
"type": "object"
}
},
{
"description": "搜索抖音视频和图文作品。用户需要按搜索词查找作品时使用；已有作品链接或 aweme_id 且需要单篇信息时使用相应详情、评论或口播转文字工具；作品通常为视频，也可能包含图文内容；支持 page_token 翻页。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"content_type": {
"default": "all",
"description": "内容形式筛选，可选：all（不限，默认）、video（视频）、image（图文）。如无明确筛选需求，保持 all。",
"enum": [
"all",
"video",
"image"
],
"type": "string"
},
"duration_range": {
"default": "all",
"description": "视频时长筛选，可选：all（不限，默认）、under_1_minute（1 分钟以下）、one_to_five_minutes（1-5 分钟）、over_5_minutes（5 分钟以上）。如无明确筛选需求，保持 all。",
"enum": [
"all",
"under_1_minute",
"one_to_five_minutes",
"over_5_minutes"
],
"type": "string"
},
"keyword": {
"description": "搜索词，可传关键词或短语，例如品牌名、话题、人物名或产品名；不要传作品链接、用户主页链接、aweme_id、sec_user_id 或 page_token。",
"type": "string"
},
"page_token": {
"default": "",
"description": "page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一搜索链路，不能跨能力、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"publish_time_range": {
"default": "all",
"description": "发布时间范围筛选，可选：all（不限，默认）、day（一天内）、week（一周内）、half_year（半年内）。如无明确筛选需求，保持 all。",
"enum": [
"all",
"day",
"week",
"half_year"
],
"type": "string"
},
"sort_type": {
"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 等写法均不是可接受值，请直接使用上述三个标准值。",
"enum": [
"general",
"time_descending",
"like_count_descending"
],
"type": "string"
}
},
"required": [
"keyword"
],
"type": "object"
},
"name": "douyin_search_videos",
"outputSchema": {
"properties": {
"items": {
"description": "当前页搜索结果中的作品列表",
"items": {
"properties": {
"author": {
"description": "作品作者信息",
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户头像链接；当前不可用时为 null"
},
"bio": {
"description": "用户简介；当前不可用时为空字符串",
"type": "string"
},
"follower_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台展示的粉丝数；当前不可用时为 null"
},
"following_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "关注数；当前不可用时为 null"
},
"name": {
"description": "用户昵称",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户主页链接；当前不可用时为 null"
},
"received_like_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "用户内容累计收到的点赞数；当前不可用时为 null"
},
"sec_user_id": {
"description": "用户 sec_user_id；当前不可用时为空字符串",
"type": "string"
},
"user_id": {
"description": "用户 user_id；当前不可用时为空字符串",
"type": "string"
},
"verification_label": {
"description": "用户认证文案；当前不可用时为空字符串",
"type": "string"
},
"verified": {
"description": "用户是否为认证账号",
"type": "boolean"
}
},
"required": [
"user_id",
"sec_user_id",
"name",
"avatar_url",
"profile_url",
"bio",
"verification_label",
"verified",
"follower_count",
"following_count",
"received_like_count"
],
"type": "object"
},
"aweme_id": {
"description": "作品 aweme_id",
"type": "string"
},
"collect_count": {
"description": "收藏数",
"type": "integer"
},
"comment_count": {
"description": "评论数",
"type": "integer"
},
"content_type": {
"description": "作品类型：video 表示视频，image 表示图文",
"enum": [
"video",
"image"
],
"type": "string"
},
"cover_image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "封面图链接；当前不可用时为 null"
},
"description": {
"description": "作品文案",
"type": "string"
},
"images": {
"description": "图文图片资源列表；图文作品按顺序返回所有图片，视频作品为空数组",
"items": {
"properties": {
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片高度，像素；当前不可用时为 null"
},
"live_photo": {
"anyOf": [
{
"properties": {
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片动效视频资源时长，毫秒；当前不可用时为 null"
},
"format": {
"description": "图片动效视频资源格式，例如 mp4",
"type": "string"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片动效视频资源高度，像素；当前不可用时为 null"
},
"play_url": {
"description": "图片动效视频资源链接；用于还原图文作品中单张图片的动态效果，通常为 mp4",
"type": "string"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片动效视频资源宽度，像素；当前不可用时为 null"
}
},
"required": [
"play_url",
"duration_ms",
"width",
"height",
"format"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "图片动效视频资源；普通静态图片为 null，不表示作品主视频或背景音乐"
},
"url": {
"description": "图片展示资源链接；用于查看或分析图片内容",
"type": "string"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片宽度，像素；当前不可用时为 null"
}
},
"required": [
"url",
"width",
"height",
"live_photo"
],
"type": "object"
},
"type": "array"
},
"like_count": {
"description": "点赞数",
"type": "integer"
},
"publish_time": {
"description": "作品发布时间，秒级 Unix 时间戳",
"type": "integer"
},
"share_count": {
"description": "分享数",
"type": "integer"
},
"share_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作品页面或分享链接；可继续按 url 查询作品详情或评论；当前不可用时为 null"
},
"topic_tags": {
"description": "作品话题标签列表；无话题标签时为空数组",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"description": "话题标签 ID；当前不可用时为空字符串",
"type": "string"
},
"name": {
"description": "话题标签名称",
"type": "string"
}
},
"required": [
"name",
"id"
],
"type": "object"
},
"type": "array"
},
"video": {
"anyOf": [
{
"properties": {
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "播放器资源时长，毫秒；当前不可用时为 null"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "播放器资源高度，像素；当前不可用时为 null"
},
"media_type": {
"description": "播放器资源类型：video 表示视频，audio 表示音频，unknown 表示未知",
"enum": [
"video",
"audio",
"unknown"
],
"type": "string"
},
"play_url": {
"description": "抖音平台播放器资源链接；视频作品通常为 mp4，图文作品可能为音频播放资源；不同于作品页面或分享链接，不用于查询作品详情或评论",
"type": "string"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "播放器资源宽度，像素；当前不可用时为 null"
}
},
"required": [
"play_url",
"duration_ms",
"width",
"height",
"media_type"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "作品播放器资源；视频作品通常为视频，图文作品可能为音频播放资源"
}
},
"required": [
"aweme_id",
"content_type",
"description",
"publish_time",
"cover_image_url",
"images",
"video",
"share_url",
"topic_tags",
"author",
"like_count",
"comment_count",
"collect_count",
"share_count"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"points": {
"additionalProperties": false,
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"balance": {
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0,
"type": "integer"
},
"cost": {
"description": "本次请求最终确认消耗的积分。",
"minimum": 0,
"type": "integer"
}
},
"required": [
"cost",
"balance"
],
"type": "object"
}
},
"required": [
"items",
"next_page_token",
"points"
],
"type": "object"
}
},
{
"description": "根据抖音 aweme_id 提交视频口播转文字任务；提交后最多等待 240 秒，未完成时返回 job_id 和下一步查询动作。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"aweme_id": {
"description": "抖音作品的数字 aweme_id，通常可从搜索、详情或评论结果中的 aweme_id 字段复用；不要传作品链接、分享文案或带引号的字符串",
"type": "string"
}
},
"required": [
"aweme_id"
],
"type": "object"
},
"name": "douyin_submit_video_speech_text_by_aweme_id",
"outputSchema": {
"additionalProperties": false,
"properties": {
"content_id": {
"description": "平台内容 ID。",
"type": "string"
},
"content_meta": {
"additionalProperties": false,
"description": "作品上下文信息，便于结合转写内容做口播分析。",
"properties": {
"author": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者头像链接。"
},
"name": {
"description": "作者昵称。",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者主页链接。"
},
"user_id": {
"description": "作者用户 ID。",
"type": "string"
}
},
"required": [
"user_id",
"name",
"profile_url",
"avatar_url"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "作者信息。"
},
"content_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作品链接。"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "平台作品原始描述、正文或配文。"
},
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "音视频时长，单位毫秒。"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作品标题；平台无标题时为 null。"
}
},
"required": [
"content_url",
"title",
"description",
"duration_ms",
"author"
],
"type": "object"
},
"content_type": {
"description": "内容类型。",
"type": "string"
},
"error": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"code": {
"description": "稳定错误码。",
"type": "string"
},
"message": {
"description": "面向用户的错误说明。",
"type": "string"
},
"retryable": {
"default": false,
"description": "是否可重试。",
"type": "boolean"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "失败或过期时的稳定错误结构；非终态或成功时为 null。"
},
"is_terminal": {
"description": "是否已终态。",
"type": "boolean"
},
"job_id": {
"description": "任务 ID。",
"type": "string"
},
"message": {
"description": "面向用户/AI 的状态说明。",
"type": "string"
},
"next_action": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": true,
"description": "下一步查询工具可直接使用的参数。",
"type": "object"
},
"instruction": {
"description": "给 AI/客户端的查询指令，说明如何继续轮询到终态。",
"type": "string"
},
"job_id": {
"description": "需要继续查询的 job_id。",
"type": "string"
},
"tool_name": {
"description": "下一步建议调用的查询工具。",
"type": "string"
}
},
"required": [
"tool_name",
"job_id",
"arguments",
"instruction"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "非终态时建议的下一步查询动作。"
},
"next_poll_after_seconds": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "建议下次查询前等待的秒数；非终态时可用。"
},
"platform": {
"description": "任务所属平台。",
"type": "string"
},
"source_id": {
"description": "任务来源 ID。",
"type": "string"
},
"status": {
"description": "任务状态。",
"enum": [
"queued",
"running",
"succeeded",
"failed",
"expired"
],
"type": "string"
},
"transcript": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"segments": {
"description": "按时间顺序排列的分段结果。",
"items": {
"additionalProperties": false,
"properties": {
"end_ms": {
"description": "分段结束时间，单位毫秒。",
"minimum": 0,
"type": "integer"
},
"start_ms": {
"description": "分段开始时间，单位毫秒。",
"minimum": 0,
"type": "integer"
},
"text": {
"description": "分段文本。",
"type": "string"
}
},
"required": [
"start_ms",
"end_ms",
"text"
],
"type": "object"
},
"type": "array"
},
"text": {
"description": "完整口播转文字结果。",
"type": "string"
}
},
"required": [
"text",
"segments"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "成功时的口播转文字结果；非终态或失败时为 null。"
}
},
"required": [
"job_id",
"status",
"is_terminal",
"platform",
"content_id",
"source_id",
"content_type",
"content_meta",
"transcript",
"error",
"next_poll_after_seconds",
"next_action",
"message"
],
"type": "object"
}
},
{
"description": "提交抖音作品视频口播转文字任务；提交后最多等待 240 秒，未完成时返回 job_id 和下一步查询动作。",
"inputSchema": {
"additionalProperties": false,
"properties": {
"video_url": {
"description": "抖音作品页面链接、作品短链接或包含作品链接的完整分享文案；不要传 video.play_url 这类播放资源链接，也不要传用户主页链接；已知 aweme_id 时优先使用 ID 入口",
"type": "string"
}
},
"required": [
"video_url"
],
"type": "object"
},
"name": "douyin_submit_video_speech_text_by_video_url",
"outputSchema": {
"additionalProperties": false,
"properties": {
"content_id": {
"description": "平台内容 ID。",
"type": "string"
},
"content_meta": {
"additionalProperties": false,
"description": "作品上下文信息，便于结合转写内容做口播分析。",
"properties": {
"author": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者头像链接。"
},
"name": {
"description": "作者昵称。",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者主页链接。"
},
"user_id": {
"description": "作者用户 ID。",
"type": "string"
}
},
"required": [
"user_id",
"name",
"profile_url",
"avatar_url"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "作者信息。"
},
"content_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作品链接。"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "平台作品原始描述、正文或配文。"
},
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "音视频时长，单位毫秒。"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作品标题；平台无标题时为 null。"
}
},
"required": [
"content_url",
"title",
"description",
"duration_ms",
"author"
],
"type": "object"
},
"content_type": {
"description": "内容类型。",
"type": "string"
},
"error": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"code": {
"description": "稳定错误码。",
"type": "string"
},
"message": {
"description": "面向用户的错误说明。",
"type": "string"
},
"retryable": {
"default": false,
"description": "是否可重试。",
"type": "boolean"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "失败或过期时的稳定错误结构；非终态或成功时为 null。"
},
"is_terminal": {
"description": "是否已终态。",
"type": "boolean"
},
"job_id": {
"description": "任务 ID。",
"type": "string"
},
"message": {
"description": "面向用户/AI 的状态说明。",
"type": "string"
},
"next_action": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": true,
"description": "下一步查询工具可直接使用的参数。",
"type": "object"
},
"instruction": {
"description": "给 AI/客户端的查询指令，说明如何继续轮询到终态。",
"type": "string"
},
"job_id": {
"description": "需要继续查询的 job_id。",
"type": "string"
},
"tool_name": {
"description": "下一步建议调用的查询工具。",
"type": "string"
}
},
"required": [
"tool_name",
"job_id",
"arguments",
"instruction"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "非终态时建议的下一步查询动作。"
},
"next_poll_after_seconds": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "建议下次查询前等待的秒数；非终态时可用。"
},
"platform": {
"description": "任务所属平台。",
"type": "string"
},
"source_id": {
"description": "任务来源 ID。",
"type": "string"
},
"status": {
"description": "任务状态。",
"enum": [
"queued",
"running",
"succeeded",
"failed",
"expired"
],
"type": "string"
},
"transcript": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"segments": {
"description": "按时间顺序排列的分段结果。",
"items": {
"additionalProperties": false,
"properties": {
"end_ms": {
"description": "分段结束时间，单位毫秒。",
"minimum": 0,
"type": "integer"
},
"start_ms": {
"description": "分段开始时间，单位毫秒。",
"minimum": 0,
"type": "integer"
},
"text": {
"description": "分段文本。",
"type": "string"
}
},
"required": [
"start_ms",
"end_ms",
"text"
],
"type": "object"
},
"type": "array"
},
"text": {
"description": "完整口播转文字结果。",
"type": "string"
}
},
"required": [
"text",
"segments"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "成功时的口播转文字结果；非终态或失败时为 null。"
}
},
"required": [
"job_id",
"status",
"is_terminal",
"platform",
"content_id",
"source_id",
"content_type",
"content_meta",
"transcript",
"error",
"next_poll_after_seconds",
"next_action",
"message"
],
"type": "object"
}
},
{
"description": "查询当前 API Key 账户的 SocialDataX 积分余额、剩余积分或点数 / remaining points balance。需要充值时请访问 https://socialdatax.com/dashboard/billing。",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "socialdatax_get_points_balance",
"outputSchema": {
"additionalProperties": {
"type": "integer"
},
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:279e6a333b9e3e63f2ca2bb27b69a933327060d306319dcb1751385369d226d8 | sha256sum