Endpoints: 76,849MCP servers: 32,728Payout addresses: 3,825Paid calls: 6,138Letters: 84Defects: 3,890counted 3 min ago
teppi

Server definition

Hash
sha256:9e947e0aef932581545bf52b5bb04b851741f201285efaefb6486d663ee962d0
What it is
What a remote MCP server returned when asked what it offers: 28 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", "title": "Cover Image Url" }, "hot_value": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "热度值;当前不可用时为 null", "title": "Hot Value" }, "keyword": { "description": "热点标题或热榜词", "title": "Keyword", "type": "string" }, "rank": { "description": "主热榜排名", "title": "Rank", "type": "integer" }, "tag": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "热点分类标签;当前不可用时为 null", "title": "Tag" }, "view_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "浏览量;当前不可用时为 null", "title": "View Count" } }, "required": [ "rank", "keyword", "tag", "hot_value", "view_count", "cover_image_url" ], "title": "DouyinHotSearchItemData", "type": "object" }, "title": "Hot Items", "type": "array" }, "points": { "additionalProperties": false, "description": "本次成功调用的积分消耗与账户积分余额。", "properties": { "balance": { "description": "优先返回调用完成时查询到的账户积分余额。查询失败时,回退到本次预扣后的余额快照。余额可为负数。", "type": "integer" }, "cost": { "description": "本次请求最终确认消耗的积分。", "minimum": 0, "type": "integer" } }, "required": [ "cost", "balance" ], "type": "object" } }, "required": [ "hot_items", "points" ], "title": "DouyinHotSearchResult", "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" }, "title": "Assurances", "type": "array" }, "detail_images": { "description": "商品详情图列表;空列表表示当前未返回对应图片", "items": { "additionalProperties": false, "properties": { "height": { "description": "平台返回的图片高度", "title": "Height", "type": "number" }, "image_url": { "description": "商品图片链接", "title": "Image Url", "type": "string" }, "width": { "description": "平台返回的图片宽度", "title": "Width", "type": "number" } }, "required": [ "image_url", "width", "height" ], "title": "DouyinProductDetailImageData", "type": "object" }, "title": "Detail Images", "type": "array" }, "discount_price": { "description": "优惠后起售价,单位:元;不限定为券后价,也不保证是最终实付价;没有单独优惠价时与 price 相同", "title": "Discount Price", "type": "number" }, "main_images": { "description": "商品顶部主图/轮播图列表;空列表表示当前未返回对应图片", "items": { "additionalProperties": false, "properties": { "height": { "description": "平台返回的图片高度", "title": "Height", "type": "number" }, "image_url": { "description": "商品图片链接", "title": "Image Url", "type": "string" }, "width": { "description": "平台返回的图片宽度", "title": "Width", "type": "number" } }, "required": [ "image_url", "width", "height" ], "title": "DouyinProductDetailImageData", "type": "object" }, "title": "Main Images", "type": "array" }, "on_sale": { "description": "商品当前是否在售;不等同于指定 SKU 有库存或当前用户可购买", "title": "On Sale", "type": "boolean" }, "points": { "additionalProperties": false, "description": "本次成功调用的积分消耗与账户积分余额。", "properties": { "balance": { "description": "优先返回调用完成时查询到的账户积分余额。查询失败时,回退到本次预扣后的余额快照。余额可为负数。", "type": "integer" }, "cost": { "description": "本次请求最终确认消耗的积分。", "minimum": 0, "type": "integer" } }, "required": [ "cost", "balance" ], "type": "object" }, "positive_review_rate": { "anyOf": [ { "maximum": 100, "minimum": 0, "type": "number" }, { "type": "null" } ], "default": null, "description": "商品好评率数值,单位为百分比,范围 0–100;92.9 表示 92.9%;统计周期见 positive_review_rate_text;无法确认时为 null,不代表 0%", "title": "Positive Review Rate" }, "positive_review_rate_text": { "default": "", "description": "商品好评率展示文本,保留近30天或历史累计等统计范围;不是店铺或同款好评率;没有时为空字符串", "title": "Positive Review Rate Text", "type": "string" }, "price": { "description": "商品起售价,单位:元;不是指定 SKU 的价格,也不保证是最终实付价", "title": "Price", "type": "number" }, "product_id": { "description": "商品 ID;可直接使用商品搜索结果中的 product_id", "title": "Product Id", "type": "string" }, "properties": { "description": "商品属性名称/值列表,不是可选规格组;没有时为空列表", "items": { "additionalProperties": false, "properties": { "name": { "description": "商品属性名称", "title": "Name", "type": "string" }, "value": { "description": "商品属性展示值;可能包含省略内容,不保证完整", "title": "Value", "type": "string" } }, "required": [ "name", "value" ], "title": "DouyinProductPropertyData", "type": "object" }, "title": "Properties", "type": "array" }, "review_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "商品评价数量解析值;整数直接返回,2.2万+返回展示下限22000;带万+的数量不是精确值,结合 review_count_text 解读;未知或无法解析时为 null,明确零评价返回0", "title": "Review Count" }, "review_count_text": { "default": "", "description": "商品评价数量原文;如2.2万+表示展示下限,用于解释 review_count 的精确性;没有时为空字符串", "title": "Review Count Text", "type": "string" }, "sales_text": { "description": "平台展示的商品销量文本;没有时为空字符串;带“+”的数量表示下限,不是精确销量", "title": "Sales Text", "type": "string" }, "seller_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "店铺关联抖音账号 UID;不是店铺 ID 或商品带货达人 ID;无法获取时为 null", "title": "Seller Id" }, "shipping": { "additionalProperties": false, "description": "发货地、运费与发货说明", "properties": { "fee": { "description": "运费展示文本;没有运费信息时为空字符串", "title": "Fee", "type": "string" }, "location": { "default": "", "description": "发货地展示文案,可能包含预计等限定;不是精确地址;没有时为空字符串", "title": "Location", "type": "string" }, "text": { "description": "发货说明;没有发货说明时为空字符串", "title": "Text", "type": "string" } }, "required": [ "fee", "text" ], "title": "DouyinProductShippingData", "type": "object" }, "shop_avatar_url": { "description": "店铺头像链接", "title": "Shop Avatar Url", "type": "string" }, "shop_id": { "description": "店铺 ID", "title": "Shop Id", "type": "string" }, "shop_name": { "description": "店铺名称", "title": "Shop Name", "type": "string" }, "sold_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "从销量文本解析的已售数量;不带“+”的万级展示数量换算为整数(如已售 1.5万返回 15000),不代表精确销量,须结合 sales_text 解读;缺失或无法解析时为 null,不代表零销量;0 表示明确已售 0", "title": "Sold Count" }, "title": { "description": "商品标题", "title": "Title", "type": "string" }, "variant_groups": { "description": "可选商品规格组(name/options),不是商品属性参数或已选 SKU;空列表表示当前未返回规格信息,不代表商品只有一种规格", "items": { "additionalProperties": false, "properties": { "name": { "description": "规格组名称", "title": "Name", "type": "string" }, "options": { "description": "规格选项列表", "items": { "additionalProperties": false, "properties": { "name": { "description": "规格选项名称", "title": "Name", "type": "string" }, "spec_id": { "description": "规格选项 ID,不是 SKU ID,不能用作商品详情查询的 product_id", "title": "Spec Id", "type": "string" } }, "required": [ "spec_id", "name" ], "title": "DouyinProductVariantOptionData", "type": "object" }, "title": "Options", "type": "array" } }, "required": [ "name", "options" ], "title": "DouyinProductVariantGroupData", "type": "object" }, "title": "Variant Groups", "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" ], "title": "DouyinProductDetailResult", "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" }, "title": "Assurances", "type": "array" }, "detail_images": { "description": "商品详情图列表;空列表表示当前未返回对应图片", "items": { "additionalProperties": false, "properties": { "height": { "description": "平台返回的图片高度", "title": "Height", "type": "number" }, "image_url": { "description": "商品图片链接", "title": "Image Url", "type": "string" }, "width": { "description": "平台返回的图片宽度", "title": "Width", "type": "number" } }, "required": [ "image_url", "width", "height" ], "title": "DouyinProductDetailImageData", "type": "object" }, "title": "Detail Images", "type": "array" }, "discount_price": { "description": "优惠后起售价,单位:元;不限定为券后价,也不保证是最终实付价;没有单独优惠价时与 price 相同", "title": "Discount Price", "type": "number" }, "main_images": { "description": "商品顶部主图/轮播图列表;空列表表示当前未返回对应图片", "items": { "additionalProperties": false, "properties": { "height": { "description": "平台返回的图片高度", "title": "Height", "type": "number" }, "image_url": { "description": "商品图片链接", "title": "Image Url", "type": "string" }, "width": { "description": "平台返回的图片宽度", "title": "Width", "type": "number" } }, "required": [ "image_url", "width", "height" ], "title": "DouyinProductDetailImageData", "type": "object" }, "title": "Main Images", "type": "array" }, "on_sale": { "description": "商品当前是否在售;不等同于指定 SKU 有库存或当前用户可购买", "title": "On Sale", "type": "boolean" }, "points": { "additionalProperties": false, "description": "本次成功调用的积分消耗与账户积分余额。", "properties": { "balance": { "description": "优先返回调用完成时查询到的账户积分余额。查询失败时,回退到本次预扣后的余额快照。余额可为负数。", "type": "integer" }, "cost": { "description": "本次请求最终确认消耗的积分。", "minimum": 0, "type": "integer" } }, "required": [ "cost", "balance" ], "type": "object" }, "positive_review_rate": { "anyOf": [ { "maximum": 100, "minimum": 0, "type": "number" }, { "type": "null" } ], "default": null, "description": "商品好评率数值,单位为百分比,范围 0–100;92.9 表示 92.9%;统计周期见 positive_review_rate_text;无法确认时为 null,不代表 0%", "title": "Positive Review Rate" }, "positive_review_rate_text": { "default": "", "description": "商品好评率展示文本,保留近30天或历史累计等统计范围;不是店铺或同款好评率;没有时为空字符串", "title": "Positive Review Rate Text", "type": "string" }, "price": { "description": "商品起售价,单位:元;不是指定 SKU 的价格,也不保证是最终实付价", "title": "Price", "type": "number" }, "product_id": { "description": "商品 ID;可直接使用商品搜索结果中的 product_id", "title": "Product Id", "type": "string" }, "properties": { "description": "商品属性名称/值列表,不是可选规格组;没有时为空列表", "items": { "additionalProperties": false, "properties": { "name": { "description": "商品属性名称", "title": "Name", "type": "string" }, "value": { "description": "商品属性展示值;可能包含省略内容,不保证完整", "title": "Value", "type": "string" } }, "required": [ "name", "value" ], "title": "DouyinProductPropertyData", "type": "object" }, "title": "Properties", "type": "array" }, "review_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "商品评价数量解析值;整数直接返回,2.2万+返回展示下限22000;带万+的数量不是精确值,结合 review_count_text 解读;未知或无法解析时为 null,明确零评价返回0", "title": "Review Count" }, "review_count_text": { "default": "", "description": "商品评价数量原文;如2.2万+表示展示下限,用于解释 review_count 的精确性;没有时为空字符串", "title": "Review Count Text", "type": "string" }, "sales_text": { "description": "平台展示的商品销量文本;没有时为空字符串;带“+”的数量表示下限,不是精确销量", "title": "Sales Text", "type": "string" }, "seller_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "店铺关联抖音账号 UID;不是店铺 ID 或商品带货达人 ID;无法获取时为 null", "title": "Seller Id" }, "shipping": { "additionalProperties": false, "description": "发货地、运费与发货说明", "properties": { "fee": { "description": "运费展示文本;没有运费信息时为空字符串", "title": "Fee", "type": "string" }, "location": { "default": "", "description": "发货地展示文案,可能包含预计等限定;不是精确地址;没有时为空字符串", "title": "Location", "type": "string" }, "text": { "description": "发货说明;没有发货说明时为空字符串", "title": "Text", "type": "string" } }, "required": [ "fee", "text" ], "title": "DouyinProductShippingData", "type": "object" }, "shop_avatar_url": { "description": "店铺头像链接", "title": "Shop Avatar Url", "type": "string" }, "shop_id": { "description": "店铺 ID", "title": "Shop Id", "type": "string" }, "shop_name": { "description": "店铺名称", "title": "Shop Name", "type": "string" }, "sold_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "从销量文本解析的已售数量;不带“+”的万级展示数量换算为整数(如已售 1.5万返回 15000),不代表精确销量,须结合 sales_text 解读;缺失或无法解析时为 null,不代表零销量;0 表示明确已售 0", "title": "Sold Count" }, "title": { "description": "商品标题", "title": "Title", "type": "string" }, "variant_groups": { "description": "可选商品规格组(name/options),不是商品属性参数或已选 SKU;空列表表示当前未返回规格信息,不代表商品只有一种规格", "items": { "additionalProperties": false, "properties": { "name": { "description": "规格组名称", "title": "Name", "type": "string" }, "options": { "description": "规格选项列表", "items": { "additionalProperties": false, "properties": { "name": { "description": "规格选项名称", "title": "Name", "type": "string" }, "spec_id": { "description": "规格选项 ID,不是 SKU ID,不能用作商品详情查询的 product_id", "title": "Spec Id", "type": "string" } }, "required": [ "spec_id", "name" ], "title": "DouyinProductVariantOptionData", "type": "object" }, "title": "Options", "type": "array" } }, "required": [ "name", "options" ], "title": "DouyinProductVariantGroupData", "type": "object" }, "title": "Variant Groups", "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" ], "title": "DouyinProductDetailResult", "type": "object" } }, { "description": "根据 product_id 读取抖音商品评价,包含初评、追评、图片、视频和商家回复,可用于了解买家体验和商品反馈。已有完整商品 ID 时直接使用;只有商品链接或分享文案时使用 douyin_get_product_reviews_by_url。未指定分类时查询全部评价。支持的分类见 review_category 参数说明,可直接查询,无需先请求首屏。review_categories 只返回平台实际提供且支持筛选的分类,category 可原样传入 review_category;名称和数量沿用平台,不补全未展示的选项。每页最多 20 条初评主记录,追评不单独计数;返回的评价集合总数可能少于商品页面总评价数。review_tags 仅提供标签名称和数量统计,用于了解买家关注点,不支持按标签筛选。分类和标签的数量采用商品页面统计口径,不是当前筛选结果内的分组数量。分类和标签统计仅首屏且平台提供时返回,续页省略。", "inputSchema": { "additionalProperties": false, "properties": { "page_token": { "default": "", "description": "不透明分页令牌;首屏留空,继续翻页时原样传回完整 next_page_token,并保持商品、分类和排序不变;更换任一条件时清空 page_token,从首屏重新查询", "type": "string" }, "product_id": { "description": "抖音商品 ID;用户已提供完整 ID 时原样使用,否则可从 douyin_search_products 的 product_id 获取;不要传 sku_id、链接或搜索词", "type": "string" }, "review_category": { "default": "", "description": "评价分类:all 全部、positive 好评、neutral 中评、negative 差评、with_media 含图片或视频、with_additional_reviews 含追评。可直接指定,无需先查询首屏;仅支持这些语义标识,不接受数字 ID。默认空字符串表示未指定分类,未指定分类时查询全部评价;切换分类时清空 page_token", "enum": [ "", "all", "positive", "neutral", "negative", "with_media", "with_additional_reviews" ], "type": "string" }, "sort_type": { "default": "general", "description": "评价排序:general 平台综合排序,time_descending 按初评时间从新到旧排列,追评不改变主评价的排序", "enum": [ "general", "time_descending" ], "type": "string" } }, "required": [ "product_id" ], "type": "object" }, "name": "douyin_get_product_reviews_by_product_id", "outputSchema": { "additionalProperties": false, "properties": { "items": { "description": "当前页的初评主记录,每条包含其追评、媒体和商家回复;追评不作为独立条目计数", "items": { "additionalProperties": false, "properties": { "additional_reviews": { "description": "当前初评对应的买家追评列表,即同一买家在初评后补充发表的评价。每条包含追评时间、正文、图片和视频;无追评时为空数组。", "items": { "additionalProperties": false, "properties": { "content": { "description": "追评完整正文;无文字时为空字符串,仍可能包含图片或视频,分别见 images、videos", "title": "Content", "type": "string" }, "images": { "description": "追评图片列表;未返回时为空数组", "items": { "additionalProperties": false, "properties": { "height": { "anyOf": [ { "minimum": 1, "type": "integer" }, { "type": "null" } ], "description": "图片高度,像素;未提供有效尺寸时为 null", "title": "Height" }, "image_url": { "description": "评价图片地址", "title": "Image Url", "type": "string" }, "thumbnail_url": { "description": "图片缩略图地址;当前不可用时为空字符串", "title": "Thumbnail Url", "type": "string" }, "width": { "anyOf": [ { "minimum": 1, "type": "integer" }, { "type": "null" } ], "description": "图片宽度,像素;未提供有效尺寸时为 null", "title": "Width" } }, "required": [ "image_url", "thumbnail_url", "width", "height" ], "title": "DouyinProductReviewImageData", "type": "object" }, "title": "Images", "type": "array" }, "review_time": { "description": "追评时间字符串,格式 YYYY-MM-DD HH:mm:ss;不含时区,时区未确认,保留平台展示时间", "title": "Review Time", "type": "string" }, "videos": { "description": "追评视频列表;未返回时为空数组", "items": { "additionalProperties": false, "properties": { "cover_image_url": { "description": "视频封面地址;当前不可用时为空字符串", "title": "Cover Image Url", "type": "string" }, "duration_ms": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "description": "视频时长,毫秒;未知时为 null", "title": "Duration Ms" }, "height": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "description": "视频高度,像素;未知时为 null", "title": "Height" }, "video_url": { "description": "评价视频播放地址", "title": "Video Url", "type": "string" }, "width": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "description": "视频宽度,像素;未知时为 null", "title": "Width" } }, "required": [ "video_url", "cover_image_url", "duration_ms", "width", "height" ], "title": "DouyinProductReviewVideoData", "type": "object" }, "title": "Videos", "type": "array" } }, "required": [ "review_time", "content", "images", "videos" ], "title": "DouyinProductReviewAdditionalData", "type": "object" }, "title": "Additional Reviews", "type": "array" }, "avatar_url": { "description": "评价者头像地址;当前不可用时为空字符串", "title": "Avatar Url", "type": "string" }, "content": { "description": "初评完整正文;无文字时为空字符串,仍可能包含图片或视频,分别见 images、videos", "title": "Content", "type": "string" }, "helpful_count": { "description": "当前这条商品评价获得的“有用”反馈数量;没有有用反馈时为0", "minimum": 0, "title": "Helpful Count", "type": "integer" }, "images": { "description": "初评图片列表;未返回时为空数组", "items": { "additionalProperties": false, "properties": { "height": { "anyOf": [ { "minimum": 1, "type": "integer" }, { "type": "null" } ], "description": "图片高度,像素;未提供有效尺寸时为 null", "title": "Height" }, "image_url": { "description": "评价图片地址", "title": "Image Url", "type": "string" }, "thumbnail_url": { "description": "图片缩略图地址;当前不可用时为空字符串", "title": "Thumbnail Url", "type": "string" }, "width": { "anyOf": [ { "minimum": 1, "type": "integer" }, { "type": "null" } ], "description": "图片宽度,像素;未提供有效尺寸时为 null", "title": "Width" } }, "required": [ "image_url", "thumbnail_url", "width", "height" ], "title": "DouyinProductReviewImageData", "type": "object" }, "title": "Images", "type": "array" }, "is_anonymous": { "description": "是否匿名发表这条评价,以平台返回的匿名标记为准,不根据昵称是否脱敏判断", "title": "Is Anonymous", "type": "boolean" }, "review_id": { "description": "商品评价 ID", "title": "Review Id", "type": "string" }, "review_time": { "description": "初评时间字符串,格式 YYYY-MM-DD HH:mm:ss;不含时区,时区未确认,保留平台展示时间", "title": "Review Time", "type": "string" }, "review_type": { "description": "平台提供的评价类型:positive 好评、neutral 中评、negative 差评;unknown 表示平台未提供或无法识别的评价类型。不根据评价正文推断。", "enum": [ "positive", "neutral", "negative", "unknown" ], "title": "Review Type", "type": "string" }, "shop_reply": { "description": "商家回复正文;未返回时为空字符串", "title": "Shop Reply", "type": "string" }, "sku_text": { "description": "买家购买的商品规格展示文字;不可用时为空字符串", "title": "Sku Text", "type": "string" }, "user_name": { "description": "评价者展示昵称,可能经过脱敏;不可用时为空字符串。匿名评价也可能有展示昵称", "title": "User Name", "type": "string" }, "videos": { "description": "初评视频列表;未返回时为空数组", "items": { "additionalProperties": false, "properties": { "cover_image_url": { "description": "视频封面地址;当前不可用时为空字符串", "title": "Cover Image Url", "type": "string" }, "duration_ms": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "description": "视频时长,毫秒;未知时为 null", "title": "Duration Ms" }, "height": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "description": "视频高度,像素;未知时为 null", "title": "Height" }, "video_url": { "description": "评价视频播放地址", "title": "Video Url", "type": "string" }, "width": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "description": "视频宽度,像素;未知时为 null", "title": "Width" } }, "required": [ "video_url", "cover_image_url", "duration_ms", "width", "height" ], "title": "DouyinProductReviewVideoData", "type": "object" }, "title": "Videos", "type": "array" }, "view_count": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "description": "评价浏览次数,由平台展示值换算为整数;如6.1万返回61000。带万单位的值为近似数;未知或无法解析时为 null。", "title": "View Count" } }, "required": [ "review_id", "user_name", "avatar_url", "is_anonymous", "review_time", "review_type", "sku_text", "content", "images", "videos", "helpful_count", "view_count", "shop_reply", "additional_reviews" ], "title": "DouyinProductReviewData", "type": "object" }, "title": "Items", "type": "array" }, "next_page_token": { "description": "下一页令牌;为空表示没有更多结果。继续翻页时原样传回,并保持商品、分类和排序不变;更换任一条件时清空 page_token,从首屏重新查询。", "title": "Next Page Token", "type": "string" }, "points": { "additionalProperties": false, "description": "本次成功调用的积分消耗与账户积分余额。", "properties": { "balance": { "description": "优先返回调用完成时查询到的账户积分余额。查询失败时,回退到本次预扣后的余额快照。余额可为负数。", "type": "integer" }, "cost": { "description": "本次请求最终确认消耗的积分。", "minimum": 0, "type": "integer" } }, "required": [ "cost", "balance" ], "type": "object" }, "product_id": { "description": "商品 ID", "title": "Product Id", "type": "string" }, "review_categories": { "description": "该商品页面实际提供且支持筛选的评价分类及数量,category 使用与 review_category 一致的语义标识;保持平台顺序,不补全未返回的分类,不是当前筛选结果内的分类分组统计;仅首屏且平台提供统计时返回,续页省略此字段,不返回 null。数量采用页面统计口径,可能与当前筛选列表的 total_review_count 不同;分类可能重叠,不能相加", "items": { "additionalProperties": false, "properties": { "category": { "description": "可筛选的评价分类标识;原样传入 review_category,不使用展示名称 name 代替", "enum": [ "all", "positive", "neutral", "negative", "with_media", "with_additional_reviews" ], "title": "Category", "type": "string" }, "count": { "description": "该分类或标签在商品页面的统计数量,不是当前筛选结果内的分组数量;不同分类或标签可能重叠,不能相加", "minimum": 0, "title": "Count", "type": "integer" }, "name": { "description": "平台页面展示的评价分类或标签名称", "title": "Name", "type": "string" } }, "required": [ "name", "count", "category" ], "title": "DouyinProductReviewCategoryData", "type": "object" }, "title": "Review Categories", "type": "array" }, "review_tags": { "description": "该商品页面的评价标签及数量,如很滋润、性价比高、回头客,每项仅含 name 和 count,用于了解买家关注点,不支持按标签筛选;不是当前筛选结果内的标签分组统计;仅首屏且平台提供统计时返回,续页省略此字段,不返回 null。标签可能重叠,不能相加,也不等同于当前页评价的关键词统计", "items": { "additionalProperties": false, "properties": { "count": { "description": "该分类或标签在商品页面的统计数量,不是当前筛选结果内的分组数量;不同分类或标签可能重叠,不能相加", "minimum": 0, "title": "Count", "type": "integer" }, "name": { "description": "平台页面展示的评价分类或标签名称", "title": "Name", "type": "string" } }, "required": [ "name", "count" ], "title": "DouyinProductReviewStatisticData", "type": "object" }, "title": "Review Tags", "type": "array" }, "total_review_count": { "description": "平台筛选后本次可查询评价集合的初评主记录总条数,非本页条数,追评不单独计数;可能少于首屏 review_categories 中页面“全部”分类的数量", "minimum": 0, "title": "Total Review Count", "type": "integer" } }, "required": [ "product_id", "items", "total_review_count", "next_page_token", "points" ], "title": "DouyinProductReviewsResult", "type": "object" } }, { "description": "根据抖音商品链接或分享文案读取商品评价,包含初评、追评、图片、视频和商家回复,可用于了解买家体验和商品反馈。已有完整 product_id 时使用 douyin_get_product_reviews_by_product_id。未指定分类时查询全部评价。支持的分类见 review_category 参数说明,可直接查询,无需先请求首屏。review_categories 只返回平台实际提供且支持筛选的分类,category 可原样传入 review_category;名称和数量沿用平台,不补全未展示的选项。每页最多 20 条初评主记录,追评不单独计数;返回的评价集合总数可能少于商品页面总评价数。review_tags 仅提供标签名称和数量统计,用于了解买家关注点,不支持按标签筛选。分类和标签的数量采用商品页面统计口径,不是当前筛选结果内的分组数量。分类和标签统计仅首屏且平台提供时返回,续页省略。", "inputSchema": { "additionalProperties": false, "properties": { "page_token": { "default": "", "description": "不透明分页令牌;首屏留空,继续翻页时原样传回完整 next_page_token,并保持商品、分类和排序不变;更换任一条件时清空 page_token,从首屏重新查询", "type": "string" }, "review_category": { "default": "", "description": "评价分类:all 全部、positive 好评、neutral 中评、negative 差评、with_media 含图片或视频、with_additional_reviews 含追评。可直接指定,无需先查询首屏;仅支持这些语义标识,不接受数字 ID。默认空字符串表示未指定分类,未指定分类时查询全部评价;切换分类时清空 page_token", "enum": [ "", "all", "positive", "neutral", "negative", "with_media", "with_additional_reviews" ], "type": "string" }, "sort_type": { "default": "general", "description": "评价排序:general 平台综合排序,time_descending 按初评时间从新到旧排列,追评不改变主评价的排序", "enum": [ "general", "time_descending" ], "type": "string" }, "url": { "description": "抖音商品短链接、商品页面链接或包含商品链接的分享文案;不要传 product_id、sku_id 或搜索词", "type": "string" } }, "required": [ "url" ], "type": "object" }, "name": "douyin_get_product_reviews_by_url", "outputSchema": { "additionalProperties": false, "properties": { "items": { "description": "当前页的初评主记录,每条包含其追评、媒体和商家回复;追评不作为独立条目计数", "items": { "additionalProperties": false, "properties": { "additional_reviews": { "description": "当前初评对应的买家追评列表,即同一买家在初评后补充发表的评价。每条包含追评时间、正文、图片和视频;无追评时为空数组。", "items": { "additionalProperties": false, "properties": { "content": { "description": "追评完整正文;无文字时为空字符串,仍可能包含图片或视频,分别见 images、videos", "title": "Content", "type": "string" }, "images": { "description": "追评图片列表;未返回时为空数组", "items": { "additionalProperties": false, "properties": { "height": { "anyOf": [ { "minimum": 1, "type": "integer" }, { "type": "null" } ], "description": "图片高度,像素;未提供有效尺寸时为 null", "title": "Height" }, "image_url": { "description": "评价图片地址", "title": "Image Url", "type": "string" }, "thumbnail_url": { "description": "图片缩略图地址;当前不可用时为空字符串", "title": "Thumbnail Url", "type": "string" }, "width": { "anyOf": [ { "minimum": 1, "type": "integer" }, { "type": "null" } ], "description": "图片宽度,像素;未提供有效尺寸时为 null", "title": "Width" } }, "required": [ "image_url", "thumbnail_url", "width", "height" ], "title": "DouyinProductReviewImageData", "type": "object" }, "title": "Images", "type": "array" }, "review_time": { "description": "追评时间字符串,格式 YYYY-MM-DD HH:mm:ss;不含时区,时区未确认,保留平台展示时间", "title": "Review Time", "type": "string" }, "videos": { "description": "追评视频列表;未返回时为空数组", "items": { "additionalProperties": false, "properties": { "cover_image_url": { "description": "视频封面地址;当前不可用时为空字符串", "title": "Cover Image Url", "type": "string" }, "duration_ms": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "description": "视频时长,毫秒;未知时为 null", "title": "Duration Ms" }, "height": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "description": "视频高度,像素;未知时为 null", "title": "Height" }, "video_url": { "description": "评价视频播放地址", "title": "Video Url", "type": "string" }, "width": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "description": "视频宽度,像素;未知时为 null", "title": "Width" } }, "required": [ "video_url", "cover_image_url", "duration_ms", "width", "height" ], "title": "DouyinProductReviewVideoData", "type": "object" }, "title": "Videos", "type": "array" } }, "required": [ "review_time", "content", "images", "videos" ], "title": "DouyinProductReviewAdditionalData", "type": "object" }, "title": "Additional Reviews", "type": "array" }, "avatar_url": { "description": "评价者头像地址;当前不可用时为空字符串", "title": "Avatar Url", "type": "string" }, "content": { "description": "初评完整正文;无文字时为空字符串,仍可能包含图片或视频,分别见 images、videos", "title": "Content", "type": "string" }, "helpful_count": { "description": "当前这条商品评价获得的“有用”反馈数量;没有有用反馈时为0", "minimum": 0, "title": "Helpful Count", "type": "integer" }, "images": { "description": "初评图片列表;未返回时为空数组", "items": { "additionalProperties": false, "properties": { "height": { "anyOf": [ { "minimum": 1, "type": "integer" }, { "type": "null" } ], "description": "图片高度,像素;未提供有效尺寸时为 null", "title": "Height" }, "image_url": { "description": "评价图片地址", "title": "Image Url", "type": "string" }, "thumbnail_url": { "description": "图片缩略图地址;当前不可用时为空字符串", "title": "Thumbnail Url", "type": "string" }, "width": { "anyOf": [ { "minimum": 1, "type": "integer" }, { "type": "null" } ], "description": "图片宽度,像素;未提供有效尺寸时为 null", "title": "Width" } }, "required": [ "image_url", "thumbnail_url", "width", "height" ], "title": "DouyinProductReviewImageData", "type": "object" }, "title": "Images", "type": "array" }, "is_anonymous": { "description": "是否匿名发表这条评价,以平台返回的匿名标记为准,不根据昵称是否脱敏判断", "title": "Is Anonymous", "type": "boolean" }, "review_id": { "description": "商品评价 ID", "title": "Review Id", "type": "string" }, "review_time": { "description": "初评时间字符串,格式 YYYY-MM-DD HH:mm:ss;不含时区,时区未确认,保留平台展示时间", "title": "Review Time", "type": "string" }, "review_type": { "description": "平台提供的评价类型:positive 好评、neutral 中评、negative 差评;unknown 表示平台未提供或无法识别的评价类型。不根据评价正文推断。", "enum": [ "positive", "neutral", "negative", "unknown" ], "title": "Review Type", "type": "string" }, "shop_reply": { "description": "商家回复正文;未返回时为空字符串", "title": "Shop Reply", "type": "string" }, "sku_text": { "description": "买家购买的商品规格展示文字;不可用时为空字符串", "title": "Sku Text", "type": "string" }, "user_name": { "description": "评价者展示昵称,可能经过脱敏;不可用时为空字符串。匿名评价也可能有展示昵称", "title": "User Name", "type": "string" }, "videos": { "description": "初评视频列表;未返回时为空数组", "items": { "additionalProperties": false, "properties": { "cover_image_url": { "description": "视频封面地址;当前不可用时为空字符串", "title": "Cover Image Url", "type": "string" }, "duration_ms": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "description": "视频时长,毫秒;未知时为 null", "title": "Duration Ms" }, "height": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "description": "视频高度,像素;未知时为 null", "title": "Height" }, "video_url": { "description": "评价视频播放地址", "title": "Video Url", "type": "string" }, "width": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "description": "视频宽度,像素;未知时为 null", "title": "Width" } }, "required": [ "video_url", "cover_image_url", "duration_ms", "width", "height" ], "title": "DouyinProductReviewVideoData", "type": "object" }, "title": "Videos", "type": "array" }, "view_count": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "description": "评价浏览次数,由平台展示值换算为整数;如6.1万返回61000。带万单位的值为近似数;未知或无法解析时为 null。", "title": "View Count" } }, "required": [ "review_id", "user_name", "avatar_url", "is_anonymous", "review_time", "review_type", "sku_text", "content", "images", "videos", "helpful_count", "view_count", "shop_reply", "additional_reviews" ], "title": "DouyinProductReviewData", "type": "object" }, "title": "Items", "type": "array" }, "next_page_token": { "description": "下一页令牌;为空表示没有更多结果。继续翻页时原样传回,并保持商品、分类和排序不变;更换任一条件时清空 page_token,从首屏重新查询。", "title": "Next Page Token", "type": "string" }, "points": { "additionalProperties": false, "description": "本次成功调用的积分消耗与账户积分余额。", "properties": { "balance": { "description": "优先返回调用完成时查询到的账户积分余额。查询失败时,回退到本次预扣后的余额快照。余额可为负数。", "type": "integer" }, "cost": { "description": "本次请求最终确认消耗的积分。", "minimum": 0, "type": "integer" } }, "required": [ "cost", "balance" ], "type": "object" }, "product_id": { "description": "商品 ID", "title": "Product Id", "type": "string" }, "review_categories": { "description": "该商品页面实际提供且支持筛选的评价分类及数量,category 使用与 review_category 一致的语义标识;保持平台顺序,不补全未返回的分类,不是当前筛选结果内的分类分组统计;仅首屏且平台提供统计时返回,续页省略此字段,不返回 null。数量采用页面统计口径,可能与当前筛选列表的 total_review_count 不同;分类可能重叠,不能相加", "items": { "additionalProperties": false, "properties": { "category": { "description": "可筛选的评价分类标识;原样传入 review_category,不使用展示名称 name 代替", "enum": [ "all", "positive", "neutral", "negative", "with_media", "with_additional_reviews" ], "title": "Category", "type": "string" }, "count": { "description": "该分类或标签在商品页面的统计数量,不是当前筛选结果内的分组数量;不同分类或标签可能重叠,不能相加", "minimum": 0, "title": "Count", "type": "integer" }, "name": { "description": "平台页面展示的评价分类或标签名称", "title": "Name", "type": "string" } }, "required": [ "name", "count", "category" ], "title": "DouyinProductReviewCategoryData", "type": "object" }, "title": "Review Categories", "type": "array" }, "review_tags": { "description": "该商品页面的评价标签及数量,如很滋润、性价比高、回头客,每项仅含 name 和 count,用于了解买家关注点,不支持按标签筛选;不是当前筛选结果内的标签分组统计;仅首屏且平台提供统计时返回,续页省略此字段,不返回 null。标签可能重叠,不能相加,也不等同于当前页评价的关键词统计", "items": { "additionalProperties": false, "properties": { "count": { "description": "该分类或标签在商品页面的统计数量,不是当前筛选结果内的分组数量;不同分类或标签可能重叠,不能相加", "minimum": 0, "title": "Count", "type": "integer" }, "name": { "description": "平台页面展示的评价分类或标签名称", "title": "Name", "type": "string" } }, "required": [ "name", "count" ], "title": "DouyinProductReviewStatisticData", "type": "object" }, "title": "Review Tags", "type": "array" }, "total_review_count": { "description": "平台筛选后本次可查询评价集合的初评主记录总条数,非本页条数,追评不单独计数;可能少于首屏 review_categories 中页面“全部”分类的数量", "minimum": 0, "title": "Total Review Count", "type": "integer" } }, "required": [ "product_id", "items", "total_review_count", "next_page_token", "points" ], "title": "DouyinProductReviewsResult", "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", "title": "Avatar Url" }, "bio": { "description": "用户简介;当前不可用时为空字符串", "title": "Bio", "type": "string" }, "cross_platform_follower_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "关联平台合计粉丝数;当前不可用时为 null", "title": "Cross Platform Follower Count" }, "douyin_follower_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "抖音单端粉丝数;当前不可用时为 null", "title": "Douyin Follower Count" }, "douyin_id": { "description": "用户主页展示的抖音号;当前不可用时为空字符串", "title": "Douyin Id", "type": "string" }, "follower_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "平台展示的粉丝数;当前不可用时为 null", "title": "Follower Count" }, "following_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "关注数;当前不可用时为 null", "title": "Following Count" }, "gender": { "description": "性别:male 表示男,female 表示女,unknown 表示未知", "enum": [ "male", "female", "unknown" ], "title": "Gender", "type": "string" }, "ip_location": { "description": "IP 属地;当前不可用时为空字符串", "title": "Ip Location", "type": "string" }, "live_info": { "anyOf": [ { "properties": { "is_live": { "description": "用户当前是否正在直播", "title": "Is Live", "type": "boolean" }, "live_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "直播间页面链接;当前不可用时为 null", "title": "Live Url" }, "online_user_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "请求时直播间在线人数快照;当前不可用时为 null", "title": "Online User Count" }, "room_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "直播间 ID;当前不可用时为 null", "title": "Room Id" } }, "required": [ "is_live", "room_id", "live_url", "online_user_count" ], "title": "DouyinUserLiveInfoData", "type": "object" }, { "type": "null" } ], "description": "用户直播状态摘要;用户当前未直播时为 null" }, "name": { "description": "用户昵称", "title": "Name", "type": "string" }, "points": { "additionalProperties": false, "description": "本次成功调用的积分消耗与账户积分余额。", "properties": { "balance": { "description": "优先返回调用完成时查询到的账户积分余额。查询失败时,回退到本次预扣后的余额快照。余额可为负数。", "type": "integer" }, "cost": { "description": "本次请求最终确认消耗的积分。", "minimum": 0, "type": "integer" } }, "required": [ "cost", "balance" ], "type": "object" }, "posted_content_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "用户已发布作品数量,包含视频、图文等作品;当前不可用时为 null", "title": "Posted Content Count" }, "profile_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "用户主页链接;当前不可用时为 null", "title": "Profile Url" }, "received_like_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "用户内容累计收到的点赞数;当前不可用时为 null", "title": "Received Like Count" }, "sec_user_id": { "description": "用户 sec_user_id;当前不可用时为空字符串", "title": "Sec User Id", "type": "string" }, "user_id": { "description": "用户 user_id;当前不可用时为空字符串", "title": "User Id", "type": "string" }, "verification_label": { "description": "用户认证文案;当前不可用时为空字符串", "title": "Verification Label", "type": "string" }, "verified": { "description": "用户是否为认证账号", "title": "Verified", "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" ], "title": "DouyinUserInfoData", "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", "title": "Avatar Url" }, "bio": { "description": "用户简介;当前不可用时为空字符串", "title": "Bio", "type": "string" }, "cross_platform_follower_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "关联平台合计粉丝数;当前不可用时为 null", "title": "Cross Platform Follower Count" }, "douyin_follower_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "抖音单端粉丝数;当前不可用时为 null", "title": "Douyin Follower Count" }, "douyin_id": { "description": "用户主页展示的抖音号;当前不可用时为空字符串", "title": "Douyin Id", "type": "string" }, "follower_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "平台展示的粉丝数;当前不可用时为 null", "title": "Follower Count" }, "following_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "关注数;当前不可用时为 null", "title": "Following Count" }, "gender": { "description": "性别:male 表示男,female 表示女,unknown 表示未知", "enum": [ "male", "female", "unknown" ], "title": "Gender", "type": "string" }, "ip_location": { "description": "IP 属地;当前不可用时为空字符串", "title": "Ip Location", "type": "string" }, "live_info": { "anyOf": [ { "properties": { "is_live": { "description": "用户当前是否正在直播", "title": "Is Live", "type": "boolean" }, "live_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "直播间页面链接;当前不可用时为 null", "title": "Live Url" }, "online_user_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "请求时直播间在线人数快照;当前不可用时为 null", "title": "Online User Count" }, "room_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "直播间 ID;当前不可用时为 null", "title": "Room Id" } }, "required": [ "is_live", "room_id", "live_url", "online_user_count" ], "title": "DouyinUserLiveInfoData", "type": "object" }, { "type": "null" } ], "description": "用户直播状态摘要;用户当前未直播时为 null" }, "name": { "description": "用户昵称", "title": "Name", "type": "string" }, "points": { "additionalProperties": false, "description": "本次成功调用的积分消耗与账户积分余额。", "properties": { "balance": { "description": "优先返回调用完成时查询到的账户积分余额。查询失败时,回退到本次预扣后的余额快照。余额可为负数。", "type": "integer" }, "cost": { "description": "本次请求最终确认消耗的积分。", "minimum": 0, "type": "integer" } }, "required": [ "cost", "balance" ], "type": "object" }, "posted_content_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "用户已发布作品数量,包含视频、图文等作品;当前不可用时为 null", "title": "Posted Content Count" }, "profile_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "用户主页链接;当前不可用时为 null", "title": "Profile Url" }, "received_like_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "用户内容累计收到的点赞数;当前不可用时为 null", "title": "Received Like Count" }, "sec_user_id": { "description": "用户 sec_user_id;当前不可用时为空字符串", "title": "Sec User Id", "type": "string" }, "user_id": { "description": "用户 user_id;当前不可用时为空字符串", "title": "User Id", "type": "string" }, "verification_label": { "description": "用户认证文案;当前不可用时为空字符串", "title": "Verification Label", "type": "string" }, "verified": { "description": "用户是否为认证账号", "title": "Verified", "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" ], "title": "DouyinUserInfoData", "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", "title": "Avatar Url" }, "bio": { "description": "用户简介;当前不可用时为空字符串", "title": "Bio", "type": "string" }, "cross_platform_follower_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "关联平台合计粉丝数;当前不可用时为 null", "title": "Cross Platform Follower Count" }, "douyin_follower_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "抖音单端粉丝数;当前不可用时为 null", "title": "Douyin Follower Count" }, "douyin_id": { "description": "用户主页展示的抖音号;当前不可用时为空字符串", "title": "Douyin Id", "type": "string" }, "follower_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "平台展示的粉丝数;当前不可用时为 null", "title": "Follower Count" }, "following_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "关注数;当前不可用时为 null", "title": "Following Count" }, "gender": { "description": "性别:male 表示男,female 表示女,unknown 表示未知", "enum": [ "male", "female", "unknown" ], "title": "Gender", "type": "string" }, "ip_location": { "description": "IP 属地;当前不可用时为空字符串", "title": "Ip Location", "type": "string" }, "live_info": { "anyOf": [ { "properties": { "is_live": { "description": "用户当前是否正在直播", "title": "Is Live", "type": "boolean" }, "live_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "直播间页面链接;当前不可用时为 null", "title": "Live Url" }, "online_user_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "请求时直播间在线人数快照;当前不可用时为 null", "title": "Online User Count" }, "room_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "直播间 ID;当前不可用时为 null", "title": "Room Id" } }, "required": [ "is_live", "room_id", "live_url", "online_user_count" ], "title": "DouyinUserLiveInfoData", "type": "object" }, { "type": "null" } ], "description": "用户直播状态摘要;用户当前未直播时为 null" }, "name": { "description": "用户昵称", "title": "Name", "type": "string" }, "points": { "additionalProperties": false, "description": "本次成功调用的积分消耗与账户积分余额。", "properties": { "balance": { "description": "优先返回调用完成时查询到的账户积分余额。查询失败时,回退到本次预扣后的余额快照。余额可为负数。", "type": "integer" }, "cost": { "description": "本次请求最终确认消耗的积分。", "minimum": 0, "type": "integer" } }, "required": [ "cost", "balance" ], "type": "object" }, "posted_content_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "用户已发布作品数量,包含视频、图文等作品;当前不可用时为 null", "title": "Posted Content Count" }, "profile_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "用户主页链接;当前不可用时为 null", "title": "Profile Url" }, "received_like_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "用户内容累计收到的点赞数;当前不可用时为 null", "title": "Received Like Count" }, "sec_user_id": { "description": "用户 sec_user_id;当前不可用时为空字符串", "title": "Sec User Id", "type": "string" }, "user_id": { "description": "用户 user_id;当前不可用时为空字符串", "title": "User Id", "type": "string" }, "verification_label": { "description": "用户认证文案;当前不可用时为空字符串", "title": "Verification Label", "type": "string" }, "verified": { "description": "用户是否为认证账号", "title": "Verified", "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" ], "title": "DouyinUserInfoData", "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", "title": "Avatar Url" }, "bio": { "description": "用户简介;当前不可用时为空字符串", "title": "Bio", "type": "string" }, "douyin_id": { "description": "用户主页展示的抖音号;当前不可用时为空字符串", "title": "Douyin Id", "type": "string" }, "follower_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "平台展示的粉丝数;当前不可用时为 null", "title": "Follower Count" }, "following_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "关注数;当前不可用时为 null", "title": "Following Count" }, "name": { "description": "用户昵称", "title": "Name", "type": "string" }, "profile_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "用户主页链接;当前不可用时为 null", "title": "Profile Url" }, "received_like_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "用户内容累计收到的点赞数;当前不可用时为 null", "title": "Received Like Count" }, "sec_user_id": { "description": "用户 sec_user_id;当前不可用时为空字符串", "title": "Sec User Id", "type": "string" }, "user_id": { "description": "用户 user_id;当前不可用时为空字符串", "title": "User Id", "type": "string" }, "verification_label": { "description": "用户认证文案;当前不可用时为空字符串", "title": "Verification Label", "type": "string" }, "verified": { "description": "用户是否为认证账号", "title": "Verified", "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" ], "title": "DouyinAuthorData", "type": "object" }, "aweme_id": { "description": "作品 aweme_id", "title": "Aweme Id", "type": "string" }, "collect_count": { "description": "收藏数", "title": "Collect Count", "type": "integer" }, "comment_count": { "description": "评论数", "title": "Comment Count", "type": "integer" }, "content_type": { "description": "作品类型:video 表示视频,image 表示图文,unknown 表示未知", "enum": [ "video", "image", "unknown" ], "title": "Content Type", "type": "string" }, "cover_image_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "封面图链接;当前不可用时为 null", "title": "Cover Image Url" }, "description": { "description": "作品文案", "title": "Description", "type": "string" }, "images": { "description": "图文图片资源列表;图文作品按顺序返回所有图片,视频作品为空数组", "items": { "properties": { "height": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "图片高度,像素;当前不可用时为 null", "title": "Height" }, "live_photo": { "anyOf": [ { "properties": { "duration_ms": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "图片动效视频资源时长,毫秒;当前不可用时为 null", "title": "Duration Ms" }, "format": { "description": "图片动效视频资源格式,例如 mp4", "title": "Format", "type": "string" }, "height": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "图片动效视频资源高度,像素;当前不可用时为 null", "title": "Height" }, "play_url": { "description": "图片动效视频资源链接;用于还原图文作品中单张图片的动态效果,通常为 mp4", "title": "Play Url", "type": "string" }, "width": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "图片动效视频资源宽度,像素;当前不可用时为 null", "title": "Width" } }, "required": [ "play_url", "duration_ms", "width", "height", "format" ], "title": "DouyinDetailLivePhotoData", "type": "object" }, { "type": "null" } ], "description": "图片动效视频资源;普通静态图片为 null,不表示作品主视频或背景音乐" }, "url": { "description": "图片展示资源链接;用于查看或分析图片内容", "title": "Url", "type": "string" }, "width": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "图片宽度,像素;当前不可用时为 null", "title": "Width" } }, "required": [ "url", "width", "height", "live_photo" ], "title": "DouyinDetailImageData", "type": "object" }, "title": "Images", "type": "array" }, "is_pinned": { "default": false, "description": "是否为用户主页置顶作品。", "title": "Is Pinned", "type": "boolean" }, "like_count": { "description": "点赞数", "title": "Like Count", "type": "integer" }, "publish_time": { "description": "作品发布时间,秒级 Unix 时间戳", "title": "Publish Time", "type": "integer" }, "share_count": { "description": "分享数", "title": "Share Count", "type": "integer" }, "share_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "作品页面或分享链接;可继续按 url 查询作品详情或评论;当前不可用时为 null", "title": "Share Url" }, "topic_tags": { "description": "作品话题标签列表;无话题标签时为空数组", "items": { "additionalProperties": false, "properties": { "id": { "description": "话题标签 ID;当前不可用时为空字符串", "title": "Id", "type": "string" }, "name": { "description": "话题标签名称", "title": "Name", "type": "string" } }, "required": [ "name", "id" ], "title": "DouyinTopicTagData", "type": "object" }, "title": "Topic Tags", "type": "array" }, "video": { "anyOf": [ { "properties": { "duration_ms": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "播放器资源时长,毫秒;当前不可用时为 null", "title": "Duration Ms" }, "height": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "播放器资源高度,像素;当前不可用时为 null", "title": "Height" }, "media_type": { "description": "播放器资源类型:video 表示视频,audio 表示音频,unknown 表示未知", "enum": [ "video", "audio", "unknown" ], "title": "Media Type", "type": "string" }, "play_url": { "description": "抖音平台播放器资源链接;视频作品通常为 mp4,图文作品可能为音频播放资源;不同于作品页面或分享链接,不用于查询作品详情或评论", "title": "Play Url", "type": "string" }, "width": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "播放器资源宽度,像素;当前不可用时为 null", "title": "Width" } }, "required": [ "play_url", "duration_ms", "width", "height", "media_type" ], "title": "DouyinDetailVideoData", "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" ], "title": "DouyinUserPostedItemData", "type": "object" }, "title": "Items", "type": "array" }, "next_page_token": { "description": "下一页不透明分页令牌;为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路,不能跨能力、作品、用户、评论、关键词或筛选条件复用;不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成,不得用省略号替换中间内容。", "title": "Next Page Token", "type": "string" }, "points": { "additionalProperties": false, "description": "本次成功调用的积分消耗与账户积分余额。", "properties": { "balance": { "description": "优先返回调用完成时查询到的账户积分余额。查询失败时,回退到本次预扣后的余额快照。余额可为负数。", "type": "integer" }, "cost": { "description": "本次请求最终确认消耗的积分。", "minimum": 0, "type": "integer" } }, "required": [ "cost", "balance" ], "type": "object" } }, "required": [ "items", "next_page_token", "points" ], "title": "DouyinUserPostedResult", "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", "title": "Avatar Url" }, "bio": { "description": "用户简介;当前不可用时为空字符串", "title": "Bio", "type": "string" }, "douyin_id": { "description": "用户主页展示的抖音号;当前不可用时为空字符串", "title": "Douyin Id", "type": "string" }, "follower_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "平台展示的粉丝数;当前不可用时为 null", "title": "Follower Count" }, "following_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "关注数;当前不可用时为 null", "title": "Following Count" }, "name": { "description": "用户昵称", "title": "Name", "type": "string" }, "profile_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "用户主页链接;当前不可用时为 null", "title": "Profile Url" }, "received_like_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "用户内容累计收到的点赞数;当前不可用时为 null", "title": "Received Like Count" }, "sec_user_id": { "description": "用户 sec_user_id;当前不可用时为空字符串", "title": "Sec User Id", "type": "string" }, "user_id": { "description": "用户 user_id;当前不可用时为空字符串", "title": "User Id", "type": "string" }, "verification_label": { "description": "用户认证文案;当前不可用时为空字符串", "title": "Verification Label", "type": "string" }, "verified": { "description": "用户是否为认证账号", "title": "Verified", "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" ], "title": "DouyinAuthorData", "type": "object" }, "aweme_id": { "description": "作品 aweme_id", "title": "Aweme Id", "type": "string" }, "collect_count": { "description": "收藏数", "title": "Collect Count", "type": "integer" }, "comment_count": { "description": "评论数", "title": "Comment Count", "type": "integer" }, "content_type": { "description": "作品类型:video 表示视频,image 表示图文,unknown 表示未知", "enum": [ "video", "image", "unknown" ], "title": "Content Type", "type": "string" }, "cover_image_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "封面图链接;当前不可用时为 null", "title": "Cover Image Url" }, "description": { "description": "作品文案", "title": "Description", "type": "string" }, "images": { "description": "图文图片资源列表;图文作品按顺序返回所有图片,视频作品为空数组", "items": { "properties": { "height": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "图片高度,像素;当前不可用时为 null", "title": "Height" }, "live_photo": { "anyOf": [ { "properties": { "duration_ms": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "图片动效视频资源时长,毫秒;当前不可用时为 null", "title": "Duration Ms" }, "format": { "description": "图片动效视频资源格式,例如 mp4", "title": "Format", "type": "string" }, "height": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "图片动效视频资源高度,像素;当前不可用时为 null", "title": "Height" }, "play_url": { "description": "图片动效视频资源链接;用于还原图文作品中单张图片的动态效果,通常为 mp4", "title": "Play Url", "type": "string" }, "width": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "图片动效视频资源宽度,像素;当前不可用时为 null", "title": "Width" } }, "required": [ "play_url", "duration_ms", "width", "height", "format" ], "title": "DouyinDetailLivePhotoData", "type": "object" }, { "type": "null" } ], "description": "图片动效视频资源;普通静态图片为 null,不表示作品主视频或背景音乐" }, "url": { "description": "图片展示资源链接;用于查看或分析图片内容", "title": "Url", "type": "string" }, "width": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "图片宽度,像素;当前不可用时为 null", "title": "Width" } }, "required": [ "url", "width", "height", "live_photo" ], "title": "DouyinDetailImageData", "type": "object" }, "title": "Images", "type": "array" }, "is_pinned": { "default": false, "description": "是否为用户主页置顶作品。", "title": "Is Pinned", "type": "boolean" }, "like_count": { "description": "点赞数", "title": "Like Count", "type": "integer" }, "publish_time": { "description": "作品发布时间,秒级 Unix 时间戳", "title": "Publish Time", "type": "integer" }, "share_count": { "description": "分享数", "title": "Share Count", "type": "integer" }, "share_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "作品页面或分享链接;可继续按 url 查询作品详情或评论;当前不可用时为 null", "title": "Share Url" }, "topic_tags": { "description": "作品话题标签列表;无话题标签时为空数组", "items": { "additionalProperties": false, "properties": { "id": { "description": "话题标签 ID;当前不可用时为空字符串", "title": "Id", "type": "string" }, "name": { "description": "话题标签名称", "title": "Name", "type": "string" } }, "required": [ "name", "id" ], "title": "DouyinTopicTagData", "type": "object" }, "title": "Topic Tags", "type": "array" }, "video": { "anyOf": [ { "properties": { "duration_ms": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "播放器资源时长,毫秒;当前不可用时为 null", "title": "Duration Ms" }, "height": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "播放器资源高度,像素;当前不可用时为 null", "title": "Height" }, "media_type": { "description": "播放器资源类型:video 表示视频,audio 表示音频,unknown 表示未知", "enum": [ "video", "audio", "unknown" ], "title": "Media Type", "type": "string" }, "play_url": { "description": "抖音平台播放器资源链接;视频作品通常为 mp4,图文作品可能为音频播放资源;不同于作品页面或分享链接,不用于查询作品详情或评论", "title": "Play Url", "type": "string" }, "width": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "播放器资源宽度,像素;当前不可用时为 null", "title": "Width" } }, "required": [ "play_url", "duration_ms", "width", "height", "media_type" ], "title": "DouyinDetailVideoData", "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" ], "title": "DouyinUserPostedItemData", "type": "object" }, "title": "Items", "type": "array" }, "next_page_token": { "description": "下一页不透明分页令牌;为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路,不能跨能力、作品、用户、评论、关键词或筛选条件复用;不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成,不得用省略号替换中间内容。", "title": "Next Page Token", "type": "string" }, "points": { "additionalProperties": false, "description": "本次成功调用的积分消耗与账户积分余额。", "properties": { "balance": { "description": "优先返回调用完成时查询到的账户积分余额。查询失败时,回退到本次预扣后的余额快照。余额可为负数。", "type": "integer" }, "cost": { "description": "本次请求最终确认消耗的积分。", "minimum": 0, "type": "integer" } }, "required": [ "cost", "balance" ], "type": "object" } }, "required": [ "items", "next_page_token", "points" ], "title": "DouyinUserPostedResult", "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", "title": "Avatar Url" }, "bio": { "description": "用户简介;当前不可用时为空字符串", "title": "Bio", "type": "string" }, "douyin_id": { "description": "用户主页展示的抖音号;当前不可用时为空字符串", "title": "Douyin Id", "type": "string" }, "follower_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "平台展示的粉丝数;当前不可用时为 null", "title": "Follower Count" }, "following_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "关注数;当前不可用时为 null", "title": "Following Count" }, "name": { "description": "用户昵称", "title": "Name", "type": "string" }, "profile_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "用户主页链接;当前不可用时为 null", "title": "Profile Url" }, "received_like_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "用户内容累计收到的点赞数;当前不可用时为 null", "title": "Received Like Count" }, "sec_user_id": { "description": "用户 sec_user_id;当前不可用时为空字符串", "title": "Sec User Id", "type": "string" }, "user_id": { "description": "用户 user_id;当前不可用时为空字符串", "title": "User Id", "type": "string" }, "verification_label": { "description": "用户认证文案;当前不可用时为空字符串", "title": "Verification Label", "type": "string" }, "verified": { "description": "用户是否为认证账号", "title": "Verified", "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" ], "title": "DouyinAuthorData", "type": "object" }, "collect_count": { "description": "收藏数", "title": "Collect Count", "type": "integer" }, "cover_image_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "短剧封面图链接;当前不可用时为 null", "title": "Cover Image Url" }, "create_time": { "description": "短剧创建时间,秒级 Unix 时间戳", "title": "Create Time", "type": "integer" }, "description": { "description": "短剧简介;当前不可用时为空字符串", "title": "Description", "type": "string" }, "play_count": { "description": "播放数", "title": "Play Count", "type": "integer" }, "series_id": { "description": "短剧 ID", "title": "Series Id", "type": "string" }, "share_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "短剧页面或分享链接;当前不可用时为 null", "title": "Share Url" }, "title": { "description": "短剧标题", "title": "Title", "type": "string" }, "total_episode_count": { "description": "总集数", "title": "Total Episode Count", "type": "integer" }, "update_time": { "description": "短剧更新时间,秒级 Unix 时间戳", "title": "Update Time", "type": "integer" }, "updated_episode_count": { "description": "已更新到的集数", "title": "Updated Episode Count", "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" ], "title": "DouyinSeriesItemData", "type": "object" }, "title": "Items", "type": "array" }, "next_page_token": { "description": "下一页不透明分页令牌;为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路,不能跨能力、作品、用户、评论、关键词或筛选条件复用;不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成,不得用省略号替换中间内容。", "title": "Next Page Token", "type": "string" }, "points": { "additionalProperties": false, "description": "本次成功调用的积分消耗与账户积分余额。", "properties": { "balance": { "description": "优先返回调用完成时查询到的账户积分余额。查询失败时,回退到本次预扣后的余额快照。余额可为负数。", "type": "integer" }, "cost": { "description": "本次请求最终确认消耗的积分。", "minimum": 0, "type": "integer" } }, "required": [ "cost", "balance" ], "type": "object" } }, "required": [ "items", "next_page_token", "points" ], "title": "DouyinUserSeriesResult", "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", "title": "Avatar Url" }, "bio": { "description": "用户简介;当前不可用时为空字符串", "title": "Bio", "type": "string" }, "douyin_id": { "description": "用户主页展示的抖音号;当前不可用时为空字符串", "title": "Douyin Id", "type": "string" }, "follower_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "平台展示的粉丝数;当前不可用时为 null", "title": "Follower Count" }, "following_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "关注数;当前不可用时为 null", "title": "Following Count" }, "name": { "description": "用户昵称", "title": "Name", "type": "string" }, "profile_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "用户主页链接;当前不可用时为 null", "title": "Profile Url" }, "received_like_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "用户内容累计收到的点赞数;当前不可用时为 null", "title": "Received Like Count" }, "sec_user_id": { "description": "用户 sec_user_id;当前不可用时为空字符串", "title": "Sec User Id", "type": "string" }, "user_id": { "description": "用户 user_id;当前不可用时为空字符串", "title": "User Id", "type": "string" }, "verification_label": { "description": "用户认证文案;当前不可用时为空字符串", "title": "Verification Label", "type": "string" }, "verified": { "description": "用户是否为认证账号", "title": "Verified", "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" ], "title": "DouyinAuthorData", "type": "object" }, "collect_count": { "description": "收藏数", "title": "Collect Count", "type": "integer" }, "cover_image_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "短剧封面图链接;当前不可用时为 null", "title": "Cover Image Url" }, "create_time": { "description": "短剧创建时间,秒级 Unix 时间戳", "title": "Create Time", "type": "integer" }, "description": { "description": "短剧简介;当前不可用时为空字符串", "title": "Description", "type": "string" }, "play_count": { "description": "播放数", "title": "Play Count", "type": "integer" }, "series_id": { "description": "短剧 ID", "title": "Series Id", "type": "string" }, "share_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "短剧页面或分享链接;当前不可用时为 null", "title": "Share Url" }, "title": { "description": "短剧标题", "title": "Title", "type": "string" }, "total_episode_count": { "description": "总集数", "title": "Total Episode Count", "type": "integer" }, "update_time": { "description": "短剧更新时间,秒级 Unix 时间戳", "title": "Update Time", "type": "integer" }, "updated_episode_count": { "description": "已更新到的集数", "title": "Updated Episode Count", "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" ], "title": "DouyinSeriesItemData", "type": "object" }, "title": "Items", "type": "array" }, "next_page_token": { "description": "下一页不透明分页令牌;为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路,不能跨能力、作品、用户、评论、关键词或筛选条件复用;不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成,不得用省略号替换中间内容。", "title": "Next Page Token", "type": "string" }, "points": { "additionalProperties": false, "description": "本次成功调用的积分消耗与账户积分余额。", "properties": { "balance": { "description": "优先返回调用完成时查询到的账户积分余额。查询失败时,回退到本次预扣后的余额快照。余额可为负数。", "type": "integer" }, "cost": { "description": "本次请求最终确认消耗的积分。", "minimum": 0, "type": "integer" } }, "required": [ "cost", "balance" ], "type": "object" } }, "required": [ "items", "next_page_token", "points" ], "title": "DouyinUserSeriesResult", "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", "title": "Comment Count" }, "items": { "description": "当前页评论回复列表", "items": { "properties": { "author": { "description": "评论作者信息", "properties": { "avatar_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "评论作者头像链接;当前不可用时为 null", "title": "Avatar Url" }, "douyin_id": { "description": "评论作者主页展示的抖音号;当前不可用时为空字符串", "title": "Douyin Id", "type": "string" }, "name": { "description": "评论作者昵称", "title": "Name", "type": "string" }, "profile_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "评论作者主页链接;当前不可用时为 null", "title": "Profile Url" }, "sec_user_id": { "description": "评论作者 sec_user_id;当前不可用时为空字符串", "title": "Sec User Id", "type": "string" }, "user_id": { "description": "评论作者 user_id;当前不可用时为空字符串", "title": "User Id", "type": "string" }, "verification_label": { "description": "评论作者认证文案;当前不可用时为空字符串", "title": "Verification Label", "type": "string" }, "verified": { "description": "评论作者是否为认证账号", "title": "Verified", "type": "boolean" } }, "required": [ "user_id", "sec_user_id", "douyin_id", "name", "avatar_url", "profile_url", "verification_label", "verified" ], "title": "DouyinCommentAuthorData", "type": "object" }, "aweme_id": { "description": "作品 aweme_id", "title": "Aweme Id", "type": "string" }, "comment_id": { "description": "当前评论回复自身 ID;不是读取回复时输入的一级评论 comment_id", "title": "Comment Id", "type": "string" }, "content": { "description": "评论内容", "title": "Content", "type": "string" }, "content_type": { "description": "评论内容类型:text 表示文字,image 表示图片,sticker 表示表情或动图,unknown 表示未知", "enum": [ "text", "image", "sticker", "unknown" ], "title": "Content Type", "type": "string" }, "create_time": { "description": "评论发布时间,秒级 Unix 时间戳", "title": "Create Time", "type": "integer" }, "image_urls": { "description": "评论图片链接列表;无图片时为空数组", "items": { "type": "string" }, "title": "Image Urls", "type": "array" }, "ip_location": { "description": "评论 IP 属地;当前不可用时为空字符串", "title": "Ip Location", "type": "string" }, "is_folded": { "description": "评论是否折叠", "title": "Is Folded", "type": "boolean" }, "is_hot": { "description": "是否为热评", "title": "Is Hot", "type": "boolean" }, "like_count": { "description": "评论点赞数", "title": "Like Count", "type": "integer" }, "reply_count": { "description": "评论回复数", "title": "Reply Count", "type": "integer" }, "sticker": { "anyOf": [ { "properties": { "animated_url": { "description": "表情或动图的动态资源链接;不可用时为空字符串", "title": "Animated Url", "type": "string" }, "static_url": { "description": "表情或动图的静态预览图链接;不可用时为空字符串", "title": "Static Url", "type": "string" } }, "required": [ "static_url", "animated_url" ], "title": "DouyinCommentStickerData", "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" ], "title": "DouyinCommentReplyItem", "type": "object" }, "title": "Items", "type": "array" }, "next_page_token": { "description": "下一页不透明分页令牌;为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路,不能跨能力、作品、用户、评论、关键词或筛选条件复用;不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成,不得用省略号替换中间内容。", "title": "Next Page Token", "type": "string" }, "points": { "additionalProperties": false, "description": "本次成功调用的积分消耗与账户积分余额。", "properties": { "balance": { "description": "优先返回调用完成时查询到的账户积分余额。查询失败时,回退到本次预扣后的余额快照。余额可为负数。", "type": "integer" }, "cost": { "description": "本次请求最终确认消耗的积分。", "minimum": 0, "type": "integer" } }, "required": [ "cost", "balance" ], "type": "object" } }, "required": [ "items", "next_page_token", "comment_count", "points" ], "title": "DouyinVideoCommentRepliesResult", "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", "title": "Comment Count" }, "items": { "description": "当前页一级评论列表", "items": { "properties": { "author": { "description": "评论作者信息", "properties": { "avatar_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "评论作者头像链接;当前不可用时为 null", "title": "Avatar Url" }, "douyin_id": { "description": "评论作者主页展示的抖音号;当前不可用时为空字符串", "title": "Douyin Id", "type": "string" }, "name": { "description": "评论作者昵称", "title": "Name", "type": "string" }, "profile_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "评论作者主页链接;当前不可用时为 null", "title": "Profile Url" }, "sec_user_id": { "description": "评论作者 sec_user_id;当前不可用时为空字符串", "title": "Sec User Id", "type": "string" }, "user_id": { "description": "评论作者 user_id;当前不可用时为空字符串", "title": "User Id", "type": "string" }, "verification_label": { "description": "评论作者认证文案;当前不可用时为空字符串", "title": "Verification Label", "type": "string" }, "verified": { "description": "评论作者是否为认证账号", "title": "Verified", "type": "boolean" } }, "required": [ "user_id", "sec_user_id", "douyin_id", "name", "avatar_url", "profile_url", "verification_label", "verified" ], "title": "DouyinCommentAuthorData", "type": "object" }, "aweme_id": { "description": "作品 aweme_id", "title": "Aweme Id", "type": "string" }, "comment_id": { "description": "当前一级评论 ID", "title": "Comment Id", "type": "string" }, "content": { "description": "评论内容", "title": "Content", "type": "string" }, "content_type": { "description": "评论内容类型:text 表示文字,image 表示图片,sticker 表示表情或动图,unknown 表示未知", "enum": [ "text", "image", "sticker", "unknown" ], "title": "Content Type", "type": "string" }, "create_time": { "description": "评论发布时间,秒级 Unix 时间戳", "title": "Create Time", "type": "integer" }, "image_urls": { "description": "评论图片链接列表;无图片时为空数组", "items": { "type": "string" }, "title": "Image Urls", "type": "array" }, "ip_location": { "description": "评论 IP 属地;当前不可用时为空字符串", "title": "Ip Location", "type": "string" }, "is_folded": { "description": "评论是否折叠", "title": "Is Folded", "type": "boolean" }, "is_hot": { "description": "是否为热评", "title": "Is Hot", "type": "boolean" }, "like_count": { "description": "评论点赞数", "title": "Like Count", "type": "integer" }, "mentioned_users": { "description": "当前一级评论正文中 @ 到的用户列表;无 @ 时为空数组", "items": { "properties": { "end": { "description": "@ 文本在原文中的结束位置", "title": "End", "type": "integer" }, "name": { "description": "被 @ 用户昵称;当前不可用时为空字符串", "title": "Name", "type": "string" }, "sec_user_id": { "description": "被 @ 用户的 sec_user_id;当前不可用时为空字符串", "title": "Sec User Id", "type": "string" }, "start": { "description": "@ 文本在原文中的起始位置", "title": "Start", "type": "integer" }, "user_id": { "description": "被 @ 用户的 user_id", "title": "User Id", "type": "string" } }, "required": [ "user_id", "sec_user_id", "name", "start", "end" ], "title": "DouyinMentionedUserData", "type": "object" }, "title": "Mentioned Users", "type": "array" }, "reply_count": { "description": "评论回复数", "title": "Reply Count", "type": "integer" }, "sticker": { "anyOf": [ { "properties": { "animated_url": { "description": "表情或动图的动态资源链接;不可用时为空字符串", "title": "Animated Url", "type": "string" }, "static_url": { "description": "表情或动图的静态预览图链接;不可用时为空字符串", "title": "Static Url", "type": "string" } }, "required": [ "static_url", "animated_url" ], "title": "DouyinCommentStickerData", "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" ], "title": "DouyinCommentItem", "type": "object" }, "title": "Items", "type": "array" }, "next_page_token": { "description": "下一页不透明分页令牌;为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路,不能跨能力、作品、用户、评论、关键词或筛选条件复用;不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成,不得用省略号替换中间内容。", "title": "Next Page Token", "type": "string" }, "points": { "additionalProperties": false, "description": "本次成功调用的积分消耗与账户积分余额。", "properties": { "balance": { "description": "优先返回调用完成时查询到的账户积分余额。查询失败时,回退到本次预扣后的余额快照。余额可为负数。", "type": "integer" }, "cost": { "description": "本次请求最终确认消耗的积分。", "minimum": 0, "type": "integer" } }, "required": [ "cost", "balance" ], "type": "object" } }, "required": [ "items", "next_page_token", "comment_count", "points" ], "title": "DouyinVideoCommentsResult", "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", "title": "Comment Count" }, "items": { "description": "当前页一级评论列表", "items": { "properties": { "author": { "description": "评论作者信息", "properties": { "avatar_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "评论作者头像链接;当前不可用时为 null", "title": "Avatar Url" }, "douyin_id": { "description": "评论作者主页展示的抖音号;当前不可用时为空字符串", "title": "Douyin Id", "type": "string" }, "name": { "description": "评论作者昵称", "title": "Name", "type": "string" }, "profile_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "评论作者主页链接;当前不可用时为 null", "title": "Profile Url" }, "sec_user_id": { "description": "评论作者 sec_user_id;当前不可用时为空字符串", "title": "Sec User Id", "type": "string" }, "user_id": { "description": "评论作者 user_id;当前不可用时为空字符串", "title": "User Id", "type": "string" }, "verification_label": { "description": "评论作者认证文案;当前不可用时为空字符串", "title": "Verification Label", "type": "string" }, "verified": { "description": "评论作者是否为认证账号", "title": "Verified", "type": "boolean" } }, "required": [ "user_id", "sec_user_id", "douyin_id", "name", "avatar_url", "profile_url", "verification_label", "verified" ], "title": "DouyinCommentAuthorData", "type": "object" }, "aweme_id": { "description": "作品 aweme_id", "title": "Aweme Id", "type": "string" }, "comment_id": { "description": "当前一级评论 ID", "title": "Comment Id", "type": "string" }, "content": { "description": "评论内容", "title": "Content", "type": "string" }, "content_type": { "description": "评论内容类型:text 表示文字,image 表示图片,sticker 表示表情或动图,unknown 表示未知", "enum": [ "text", "image", "sticker", "unknown" ], "title": "Content Type", "type": "string" }, "create_time": { "description": "评论发布时间,秒级 Unix 时间戳", "title": "Create Time", "type": "integer" }, "image_urls": { "description": "评论图片链接列表;无图片时为空数组", "items": { "type": "string" }, "title": "Image Urls", "type": "array" }, "ip_location": { "description": "评论 IP 属地;当前不可用时为空字符串", "title": "Ip Location", "type": "string" }, "is_folded": { "description": "评论是否折叠", "title": "Is Folded", "type": "boolean" }, "is_hot": { "description": "是否为热评", "title": "Is Hot", "type": "boolean" }, "like_count": { "description": "评论点赞数", "title": "Like Count", "type": "integer" }, "mentioned_users": { "description": "当前一级评论正文中 @ 到的用户列表;无 @ 时为空数组", "items": { "properties": { "end": { "description": "@ 文本在原文中的结束位置", "title": "End", "type": "integer" }, "name": { "description": "被 @ 用户昵称;当前不可用时为空字符串", "title": "Name", "type": "string" }, "sec_user_id": { "description": "被 @ 用户的 sec_user_id;当前不可用时为空字符串", "title": "Sec User Id", "type": "string" }, "start": { "description": "@ 文本在原文中的起始位置", "title": "Start", "type": "integer" }, "user_id": { "description": "被 @ 用户的 user_id", "title": "User Id", "type": "string" } }, "required": [ "user_id", "sec_user_id", "name", "start", "end" ], "title": "DouyinMentionedUserData", "type": "object" }, "title": "Mentioned Users", "type": "array" }, "reply_count": { "description": "评论回复数", "title": "Reply Count", "type": "integer" }, "sticker": { "anyOf": [ { "properties": { "animated_url": { "description": "表情或动图的动态资源链接;不可用时为空字符串", "title": "Animated Url", "type": "string" }, "static_url": { "description": "表情或动图的静态预览图链接;不可用时为空字符串", "title": "Static Url", "type": "string" } }, "required": [ "static_url", "animated_url" ], "title": "DouyinCommentStickerData", "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" ], "title": "DouyinCommentItem", "type": "object" }, "title": "Items", "type": "array" }, "next_page_token": { "description": "下一页不透明分页令牌;为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路,不能跨能力、作品、用户、评论、关键词或筛选条件复用;不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成,不得用省略号替换中间内容。", "title": "Next Page Token", "type": "string" }, "points": { "additionalProperties": false, "description": "本次成功调用的积分消耗与账户积分余额。", "properties": { "balance": { "description": "优先返回调用完成时查询到的账户积分余额。查询失败时,回退到本次预扣后的余额快照。余额可为负数。", "type": "integer" }, "cost": { "description": "本次请求最终确认消耗的积分。", "minimum": 0, "type": "integer" } }, "required": [ "cost", "balance" ], "type": "object" } }, "required": [ "items", "next_page_token", "comment_count", "points" ], "title": "DouyinVideoCommentsResult", "type": "object" } }, { "description": "根据抖音作品 aweme_id 获取视频或图文作品详情及播放量;播放量未获取到时为 null,不影响其余详情,不额外收费。已知 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", "title": "Avatar Url" }, "bio": { "description": "用户简介;当前不可用时为空字符串", "title": "Bio", "type": "string" }, "douyin_id": { "description": "用户主页展示的抖音号;当前不可用时为空字符串", "title": "Douyin Id", "type": "string" }, "follower_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "平台展示的粉丝数;当前不可用时为 null", "title": "Follower Count" }, "following_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "关注数;当前不可用时为 null", "title": "Following Count" }, "name": { "description": "用户昵称", "title": "Name", "type": "string" }, "profile_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "用户主页链接;当前不可用时为 null", "title": "Profile Url" }, "received_like_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "用户内容累计收到的点赞数;当前不可用时为 null", "title": "Received Like Count" }, "sec_user_id": { "description": "用户 sec_user_id;当前不可用时为空字符串", "title": "Sec User Id", "type": "string" }, "user_id": { "description": "用户 user_id;当前不可用时为空字符串", "title": "User Id", "type": "string" }, "verification_label": { "description": "用户认证文案;当前不可用时为空字符串", "title": "Verification Label", "type": "string" }, "verified": { "description": "用户是否为认证账号", "title": "Verified", "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" ], "title": "DouyinAuthorData", "type": "object" }, "aweme_id": { "description": "作品 aweme_id", "title": "Aweme Id", "type": "string" }, "collect_count": { "description": "作品收藏数", "title": "Collect Count", "type": "integer" }, "comment_count": { "description": "作品评论数", "title": "Comment Count", "type": "integer" }, "content_type": { "description": "作品类型:video 表示视频,image 表示图文,unknown 表示未知", "enum": [ "video", "image", "unknown" ], "title": "Content Type", "type": "string" }, "cover_image_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "作品封面图链接;当前不可用时为 null", "title": "Cover Image Url" }, "description": { "description": "作品文案", "title": "Description", "type": "string" }, "images": { "description": "作品图片展示资源列表;图文作品按顺序返回所有图片,视频作品为空数组", "items": { "properties": { "height": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "图片高度,像素;当前不可用时为 null", "title": "Height" }, "live_photo": { "anyOf": [ { "properties": { "duration_ms": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "图片动效视频资源时长,毫秒;当前不可用时为 null", "title": "Duration Ms" }, "format": { "description": "图片动效视频资源格式,例如 mp4", "title": "Format", "type": "string" }, "height": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "图片动效视频资源高度,像素;当前不可用时为 null", "title": "Height" }, "play_url": { "description": "图片动效视频资源链接;用于还原图文作品中单张图片的动态效果,通常为 mp4", "title": "Play Url", "type": "string" }, "width": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "图片动效视频资源宽度,像素;当前不可用时为 null", "title": "Width" } }, "required": [ "play_url", "duration_ms", "width", "height", "format" ], "title": "DouyinDetailLivePhotoData", "type": "object" }, { "type": "null" } ], "description": "图片动效视频资源;普通静态图片为 null,不表示作品主视频或背景音乐" }, "url": { "description": "图片展示资源链接;用于查看或分析图片内容", "title": "Url", "type": "string" }, "width": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "图片宽度,像素;当前不可用时为 null", "title": "Width" } }, "required": [ "url", "width", "height", "live_photo" ], "title": "DouyinDetailImageData", "type": "object" }, "title": "Images", "type": "array" }, "like_count": { "description": "作品点赞数", "title": "Like Count", "type": "integer" }, "mentioned_users": { "description": "作品正文中 @ 到的用户列表;无 @ 时为空数组", "items": { "properties": { "end": { "description": "@ 文本在原文中的结束位置", "title": "End", "type": "integer" }, "name": { "description": "被 @ 用户昵称;当前不可用时为空字符串", "title": "Name", "type": "string" }, "sec_user_id": { "description": "被 @ 用户的 sec_user_id;当前不可用时为空字符串", "title": "Sec User Id", "type": "string" }, "start": { "description": "@ 文本在原文中的起始位置", "title": "Start", "type": "integer" }, "user_id": { "description": "被 @ 用户的 user_id", "title": "User Id", "type": "string" } }, "required": [ "user_id", "sec_user_id", "name", "start", "end" ], "title": "DouyinMentionedUserData", "type": "object" }, "title": "Mentioned Users", "type": "array" }, "music": { "anyOf": [ { "properties": { "author": { "description": "音乐或原声作者;当前不可用时为空字符串", "title": "Author", "type": "string" }, "duration_ms": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "音乐或原声时长,毫秒;当前不可用时为 null", "title": "Duration Ms" }, "play_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "音乐或原声播放链接;当前不可用时为 null", "title": "Play Url" }, "title": { "description": "作品绑定音乐或原声标题;当前不可用时为空字符串", "title": "Title", "type": "string" } }, "required": [ "title", "author", "play_url", "duration_ms" ], "title": "DouyinDetailMusicData", "type": "object" }, { "type": "null" } ], "description": "作品绑定音乐或原声资产;不表示视频播放时需要额外叠加播放;当前不可用时为 null" }, "play_count": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "description": "作品播放量;0 表示实际返回零,未获取到时为 null", "title": "Play Count" }, "points": { "additionalProperties": false, "description": "本次成功调用的积分消耗与账户积分余额。", "properties": { "balance": { "description": "优先返回调用完成时查询到的账户积分余额。查询失败时,回退到本次预扣后的余额快照。余额可为负数。", "type": "integer" }, "cost": { "description": "本次请求最终确认消耗的积分。", "minimum": 0, "type": "integer" } }, "required": [ "cost", "balance" ], "type": "object" }, "publish_time": { "description": "作品发布时间,秒级 Unix 时间戳", "title": "Publish Time", "type": "integer" }, "share_count": { "description": "作品分享数", "title": "Share Count", "type": "integer" }, "share_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "作品页面/分享链接;可作为按 url 查询作品详情或评论时的输入;当前不可用时为 null", "title": "Share Url" }, "topic_tags": { "description": "作品话题标签列表;无话题标签时为空数组", "items": { "additionalProperties": false, "properties": { "id": { "description": "话题标签 ID;当前不可用时为空字符串", "title": "Id", "type": "string" }, "name": { "description": "话题标签名称", "title": "Name", "type": "string" } }, "required": [ "name", "id" ], "title": "DouyinTopicTagData", "type": "object" }, "title": "Topic Tags", "type": "array" }, "video": { "anyOf": [ { "properties": { "duration_ms": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "播放器资源时长,毫秒;当前不可用时为 null", "title": "Duration Ms" }, "height": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "播放器资源高度,像素;当前不可用时为 null", "title": "Height" }, "media_type": { "description": "播放器资源类型:video 表示视频,audio 表示音频,unknown 表示未知", "enum": [ "video", "audio", "unknown" ], "title": "Media Type", "type": "string" }, "play_url": { "description": "抖音平台播放器资源链接;视频作品通常为 mp4,图文作品可能为音频播放资源;不同于作品页面或分享链接,不用于查询作品详情或评论", "title": "Play Url", "type": "string" }, "width": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "播放器资源宽度,像素;当前不可用时为 null", "title": "Width" } }, "required": [ "play_url", "duration_ms", "width", "height", "media_type" ], "title": "DouyinDetailVideoData", "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" ], "title": "DouyinPublicVideoDetailData", "type": "object" } }, { "description": "根据抖音作品页面链接、作品短链接或包含作品链接的分享文案获取视频或图文作品详情及播放量;播放量未获取到时为 null,不影响其余详情,不额外收费。", "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", "title": "Avatar Url" }, "bio": { "description": "用户简介;当前不可用时为空字符串", "title": "Bio", "type": "string" }, "douyin_id": { "description": "用户主页展示的抖音号;当前不可用时为空字符串", "title": "Douyin Id", "type": "string" }, "follower_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "平台展示的粉丝数;当前不可用时为 null", "title": "Follower Count" }, "following_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "关注数;当前不可用时为 null", "title": "Following Count" }, "name": { "description": "用户昵称", "title": "Name", "type": "string" }, "profile_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "用户主页链接;当前不可用时为 null", "title": "Profile Url" }, "received_like_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "用户内容累计收到的点赞数;当前不可用时为 null", "title": "Received Like Count" }, "sec_user_id": { "description": "用户 sec_user_id;当前不可用时为空字符串", "title": "Sec User Id", "type": "string" }, "user_id": { "description": "用户 user_id;当前不可用时为空字符串", "title": "User Id", "type": "string" }, "verification_label": { "description": "用户认证文案;当前不可用时为空字符串", "title": "Verification Label", "type": "string" }, "verified": { "description": "用户是否为认证账号", "title": "Verified", "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" ], "title": "DouyinAuthorData", "type": "object" }, "aweme_id": { "description": "作品 aweme_id", "title": "Aweme Id", "type": "string" }, "collect_count": { "description": "作品收藏数", "title": "Collect Count", "type": "integer" }, "comment_count": { "description": "作品评论数", "title": "Comment Count", "type": "integer" }, "content_type": { "description": "作品类型:video 表示视频,image 表示图文,unknown 表示未知", "enum": [ "video", "image", "unknown" ], "title": "Content Type", "type": "string" }, "cover_image_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "作品封面图链接;当前不可用时为 null", "title": "Cover Image Url" }, "description": { "description": "作品文案", "title": "Description", "type": "string" }, "images": { "description": "作品图片展示资源列表;图文作品按顺序返回所有图片,视频作品为空数组", "items": { "properties": { "height": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "图片高度,像素;当前不可用时为 null", "title": "Height" }, "live_photo": { "anyOf": [ { "properties": { "duration_ms": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "图片动效视频资源时长,毫秒;当前不可用时为 null", "title": "Duration Ms" }, "format": { "description": "图片动效视频资源格式,例如 mp4", "title": "Format", "type": "string" }, "height": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "图片动效视频资源高度,像素;当前不可用时为 null", "title": "Height" }, "play_url": { "description": "图片动效视频资源链接;用于还原图文作品中单张图片的动态效果,通常为 mp4", "title": "Play Url", "type": "string" }, "width": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "图片动效视频资源宽度,像素;当前不可用时为 null", "title": "Width" } }, "required": [ "play_url", "duration_ms", "width", "height", "format" ], "title": "DouyinDetailLivePhotoData", "type": "object" }, { "type": "null" } ], "description": "图片动效视频资源;普通静态图片为 null,不表示作品主视频或背景音乐" }, "url": { "description": "图片展示资源链接;用于查看或分析图片内容", "title": "Url", "type": "string" }, "width": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "图片宽度,像素;当前不可用时为 null", "title": "Width" } }, "required": [ "url", "width", "height", "live_photo" ], "title": "DouyinDetailImageData", "type": "object" }, "title": "Images", "type": "array" }, "like_count": { "description": "作品点赞数", "title": "Like Count", "type": "integer" }, "mentioned_users": { "description": "作品正文中 @ 到的用户列表;无 @ 时为空数组", "items": { "properties": { "end": { "description": "@ 文本在原文中的结束位置", "title": "End", "type": "integer" }, "name": { "description": "被 @ 用户昵称;当前不可用时为空字符串", "title": "Name", "type": "string" }, "sec_user_id": { "description": "被 @ 用户的 sec_user_id;当前不可用时为空字符串", "title": "Sec User Id", "type": "string" }, "start": { "description": "@ 文本在原文中的起始位置", "title": "Start", "type": "integer" }, "user_id": { "description": "被 @ 用户的 user_id", "title": "User Id", "type": "string" } }, "required": [ "user_id", "sec_user_id", "name", "start", "end" ], "title": "DouyinMentionedUserData", "type": "object" }, "title": "Mentioned Users", "type": "array" }, "music": { "anyOf": [ { "properties": { "author": { "description": "音乐或原声作者;当前不可用时为空字符串", "title": "Author", "type": "string" }, "duration_ms": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "音乐或原声时长,毫秒;当前不可用时为 null", "title": "Duration Ms" }, "play_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "音乐或原声播放链接;当前不可用时为 null", "title": "Play Url" }, "title": { "description": "作品绑定音乐或原声标题;当前不可用时为空字符串", "title": "Title", "type": "string" } }, "required": [ "title", "author", "play_url", "duration_ms" ], "title": "DouyinDetailMusicData", "type": "object" }, { "type": "null" } ], "description": "作品绑定音乐或原声资产;不表示视频播放时需要额外叠加播放;当前不可用时为 null" }, "play_count": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "description": "作品播放量;0 表示实际返回零,未获取到时为 null", "title": "Play Count" }, "points": { "additionalProperties": false, "description": "本次成功调用的积分消耗与账户积分余额。", "properties": { "balance": { "description": "优先返回调用完成时查询到的账户积分余额。查询失败时,回退到本次预扣后的余额快照。余额可为负数。", "type": "integer" }, "cost": { "description": "本次请求最终确认消耗的积分。", "minimum": 0, "type": "integer" } }, "required": [ "cost", "balance" ], "type": "object" }, "publish_time": { "description": "作品发布时间,秒级 Unix 时间戳", "title": "Publish Time", "type": "integer" }, "share_count": { "description": "作品分享数", "title": "Share Count", "type": "integer" }, "share_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "作品页面/分享链接;可作为按 url 查询作品详情或评论时的输入;当前不可用时为 null", "title": "Share Url" }, "topic_tags": { "description": "作品话题标签列表;无话题标签时为空数组", "items": { "additionalProperties": false, "properties": { "id": { "description": "话题标签 ID;当前不可用时为空字符串", "title": "Id", "type": "string" }, "name": { "description": "话题标签名称", "title": "Name", "type": "string" } }, "required": [ "name", "id" ], "title": "DouyinTopicTagData", "type": "object" }, "title": "Topic Tags", "type": "array" }, "video": { "anyOf": [ { "properties": { "duration_ms": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "播放器资源时长,毫秒;当前不可用时为 null", "title": "Duration Ms" }, "height": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "播放器资源高度,像素;当前不可用时为 null", "title": "Height" }, "media_type": { "description": "播放器资源类型:video 表示视频,audio 表示音频,unknown 表示未知", "enum": [ "video", "audio", "unknown" ], "title": "Media Type", "type": "string" }, "play_url": { "description": "抖音平台播放器资源链接;视频作品通常为 mp4,图文作品可能为音频播放资源;不同于作品页面或分享链接,不用于查询作品详情或评论", "title": "Play Url", "type": "string" }, "width": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "播放器资源宽度,像素;当前不可用时为 null", "title": "Width" } }, "required": [ "play_url", "duration_ms", "width", "height", "media_type" ], "title": "DouyinDetailVideoData", "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" ], "title": "DouyinPublicVideoDetailData", "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": "优先返回调用完成时查询到的账户积分余额。查询失败时,回退到本次预扣后的余额快照。余额可为负数。", "type": "integer" }, "cost": { "description": "本次请求最终确认消耗的积分。", "minimum": 0, "type": "integer" } }, "required": [ "cost", "balance" ], "type": "object" }, "share_text": { "description": "包含短链接的完整分享文案,可复制分享。", "title": "Share Text", "type": "string" }, "short_url": { "description": "抖音作品分享短链接。", "title": "Short Url", "type": "string" } }, "required": [ "share_text", "short_url", "points" ], "title": "DouyinShareLinkData", "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": "优先返回调用完成时查询到的账户积分余额。查询失败时,回退到本次预扣后的余额快照。余额可为负数。", "type": "integer" }, "cost": { "description": "本次请求最终确认消耗的积分。", "minimum": 0, "type": "integer" } }, "required": [ "cost", "balance" ], "type": "object" }, "share_text": { "description": "包含短链接的完整分享文案,可复制分享。", "title": "Share Text", "type": "string" }, "short_url": { "description": "抖音作品分享短链接。", "title": "Short Url", "type": "string" } }, "required": [ "share_text", "short_url", "points" ], "title": "DouyinShareLinkData", "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": "按单个作品 ID 查询视频或图文播放量、点赞数、评论数和下载数,每次仅传一个 ID;未提供的互动指标为 null,未返回统计的 ID 单独列出。", "inputSchema": { "additionalProperties": false, "properties": { "aweme_id": { "description": "单个抖音视频或图文作品 ID,1–32 位数字字符串。可复用搜索或详情结果中的 aweme_id,不传链接或分享文案。", "maxLength": 32, "minLength": 1, "type": "string" } }, "required": [ "aweme_id" ], "type": "object" }, "name": "douyin_get_video_statistics", "outputSchema": { "additionalProperties": false, "properties": { "items": { "description": "取得播放量的作品,按请求 ID 顺序排列", "items": { "additionalProperties": false, "properties": { "aweme_id": { "description": "抖音作品 ID", "title": "Aweme Id", "type": "string" }, "comment_count": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "description": "本次查询返回的评论数;未提供时为 null", "title": "Comment Count" }, "download_count": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "description": "本次查询返回的下载数;未提供时为 null", "title": "Download Count" }, "like_count": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "description": "本次查询返回的点赞数;未提供时为 null", "title": "Like Count" }, "play_count": { "description": "本次查询返回的作品播放量;0 表示返回值为零", "minimum": 0, "title": "Play Count", "type": "integer" } }, "required": [ "aweme_id", "play_count" ], "title": "DouyinVideoStatistic", "type": "object" }, "title": "Items", "type": "array" }, "missing_aweme_ids": { "description": "本次未返回统计的作品 ID;不代表作品已删除,也不表示播放量为零", "items": { "type": "string" }, "title": "Missing Aweme Ids", "type": "array" }, "points": { "additionalProperties": false, "description": "本次成功调用的积分消耗与账户积分余额。", "properties": { "balance": { "description": "优先返回调用完成时查询到的账户积分余额。查询失败时,回退到本次预扣后的余额快照。余额可为负数。", "type": "integer" }, "cost": { "description": "本次请求最终确认消耗的积分。", "minimum": 0, "type": "integer" } }, "required": [ "cost", "balance" ], "type": "object" } }, "required": [ "items", "missing_aweme_ids", "points" ], "title": "DouyinVideoStatisticsResult", "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" ], "title": "Card Type", "type": "string" }, "image_url": { "description": "商品主图链接", "title": "Image Url", "type": "string" }, "live_room_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "直播商品卡关联的直播间 ID;card_type 不是 live 时为 null", "title": "Live Room Id" }, "price": { "description": "商品卡展示价格,单位:元;不保证是最终实付价", "title": "Price", "type": "number" }, "product_id": { "description": "商品 ID;不要与当前商品卡对应的 sku_id 混用", "title": "Product Id", "type": "string" }, "shop_id": { "description": "店铺 ID", "title": "Shop Id", "type": "string" }, "sku_id": { "description": "当前商品卡对应的规格 SKU ID", "title": "Sku Id", "type": "string" }, "title": { "description": "商品标题", "title": "Title", "type": "string" }, "video_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "视频商品卡关联的视频 ID;card_type 不是 video 时为 null", "title": "Video Id" } }, "required": [ "product_id", "sku_id", "title", "image_url", "price", "shop_id", "card_type", "video_id", "live_room_id" ], "title": "DouyinMallSearchItemData", "type": "object" }, "title": "Items", "type": "array" }, "next_page_token": { "description": "下一页不透明分页令牌;为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路,不能跨能力、作品、用户、评论、关键词或筛选条件复用;不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成,不得用省略号替换中间内容。", "title": "Next Page Token", "type": "string" }, "points": { "additionalProperties": false, "description": "本次成功调用的积分消耗与账户积分余额。", "properties": { "balance": { "description": "优先返回调用完成时查询到的账户积分余额。查询失败时,回退到本次预扣后的余额快照。余额可为负数。", "type": "integer" }, "cost": { "description": "本次请求最终确认消耗的积分。", "minimum": 0, "type": "integer" } }, "required": [ "cost", "balance" ], "type": "object" } }, "required": [ "items", "next_page_token", "points" ], "title": "DouyinMallSearchResult", "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": "普通搜索输入框中的联想词", "title": "Text", "type": "string" } }, "required": [ "text" ], "title": "DouyinSearchSuggestionItemData", "type": "object" }, "title": "Items", "type": "array" }, "points": { "additionalProperties": false, "description": "本次成功调用的积分消耗与账户积分余额。", "properties": { "balance": { "description": "优先返回调用完成时查询到的账户积分余额。查询失败时,回退到本次预扣后的余额快照。余额可为负数。", "type": "integer" }, "cost": { "description": "本次请求最终确认消耗的积分。", "minimum": 0, "type": "integer" } }, "required": [ "cost", "balance" ], "type": "object" } }, "required": [ "items", "points" ], "title": "DouyinSearchSuggestionsResult", "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", "title": "Avatar Url" }, "bio": { "description": "用户简介;当前不可用时为空字符串", "title": "Bio", "type": "string" }, "douyin_id": { "description": "用户主页展示的抖音号;当前不可用时为空字符串", "title": "Douyin Id", "type": "string" }, "follower_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "平台展示的粉丝数;当前不可用时为 null", "title": "Follower Count" }, "following_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "关注数;当前不可用时为 null", "title": "Following Count" }, "name": { "description": "用户昵称", "title": "Name", "type": "string" }, "posted_content_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "用户已发布作品数量,包含视频、图文等作品;当前不可用时为 null", "title": "Posted Content Count" }, "profile_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "用户主页链接;当前不可用时为 null", "title": "Profile Url" }, "received_like_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "用户内容累计收到的点赞数;当前不可用时为 null", "title": "Received Like Count" }, "sec_user_id": { "description": "用户 sec_user_id;当前不可用时为空字符串", "title": "Sec User Id", "type": "string" }, "user_id": { "description": "用户 user_id;当前不可用时为空字符串", "title": "User Id", "type": "string" }, "verification_label": { "description": "用户认证文案;当前不可用时为空字符串", "title": "Verification Label", "type": "string" }, "verified": { "description": "用户是否为认证账号", "title": "Verified", "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" ], "title": "DouyinUserSearchItemData", "type": "object" }, "title": "Items", "type": "array" }, "next_page_token": { "description": "下一页不透明分页令牌;为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路,不能跨能力、作品、用户、评论、关键词或筛选条件复用;不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成,不得用省略号替换中间内容。", "title": "Next Page Token", "type": "string" }, "points": { "additionalProperties": false, "description": "本次成功调用的积分消耗与账户积分余额。", "properties": { "balance": { "description": "优先返回调用完成时查询到的账户积分余额。查询失败时,回退到本次预扣后的余额快照。余额可为负数。", "type": "integer" }, "cost": { "description": "本次请求最终确认消耗的积分。", "minimum": 0, "type": "integer" } }, "required": [ "cost", "balance" ], "type": "object" } }, "required": [ "items", "next_page_token", "points" ], "title": "DouyinUserSearchResult", "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", "title": "Avatar Url" }, "bio": { "description": "用户简介;当前不可用时为空字符串", "title": "Bio", "type": "string" }, "follower_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "平台展示的粉丝数;当前不可用时为 null", "title": "Follower Count" }, "following_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "关注数;当前不可用时为 null", "title": "Following Count" }, "name": { "description": "用户昵称", "title": "Name", "type": "string" }, "profile_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "用户主页链接;当前不可用时为 null", "title": "Profile Url" }, "received_like_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "用户内容累计收到的点赞数;当前不可用时为 null", "title": "Received Like Count" }, "sec_user_id": { "description": "用户 sec_user_id;当前不可用时为空字符串", "title": "Sec User Id", "type": "string" }, "user_id": { "description": "用户 user_id;当前不可用时为空字符串", "title": "User Id", "type": "string" }, "verification_label": { "description": "用户认证文案;当前不可用时为空字符串", "title": "Verification Label", "type": "string" }, "verified": { "description": "用户是否为认证账号", "title": "Verified", "type": "boolean" } }, "required": [ "user_id", "sec_user_id", "name", "avatar_url", "profile_url", "bio", "verification_label", "verified", "follower_count", "following_count", "received_like_count" ], "title": "DouyinUserSummaryData", "type": "object" }, "aweme_id": { "description": "作品 aweme_id", "title": "Aweme Id", "type": "string" }, "collect_count": { "description": "收藏数", "title": "Collect Count", "type": "integer" }, "comment_count": { "description": "评论数", "title": "Comment Count", "type": "integer" }, "content_type": { "description": "作品类型:video 表示视频,image 表示图文", "enum": [ "video", "image" ], "title": "Content Type", "type": "string" }, "cover_image_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "封面图链接;当前不可用时为 null", "title": "Cover Image Url" }, "description": { "description": "作品文案", "title": "Description", "type": "string" }, "images": { "description": "图文图片资源列表;图文作品按顺序返回所有图片,视频作品为空数组", "items": { "properties": { "height": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "图片高度,像素;当前不可用时为 null", "title": "Height" }, "live_photo": { "anyOf": [ { "properties": { "duration_ms": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "图片动效视频资源时长,毫秒;当前不可用时为 null", "title": "Duration Ms" }, "format": { "description": "图片动效视频资源格式,例如 mp4", "title": "Format", "type": "string" }, "height": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "图片动效视频资源高度,像素;当前不可用时为 null", "title": "Height" }, "play_url": { "description": "图片动效视频资源链接;用于还原图文作品中单张图片的动态效果,通常为 mp4", "title": "Play Url", "type": "string" }, "width": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "图片动效视频资源宽度,像素;当前不可用时为 null", "title": "Width" } }, "required": [ "play_url", "duration_ms", "width", "height", "format" ], "title": "DouyinDetailLivePhotoData", "type": "object" }, { "type": "null" } ], "description": "图片动效视频资源;普通静态图片为 null,不表示作品主视频或背景音乐" }, "url": { "description": "图片展示资源链接;用于查看或分析图片内容", "title": "Url", "type": "string" }, "width": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "图片宽度,像素;当前不可用时为 null", "title": "Width" } }, "required": [ "url", "width", "height", "live_photo" ], "title": "DouyinDetailImageData", "type": "object" }, "title": "Images", "type": "array" }, "like_count": { "description": "点赞数", "title": "Like Count", "type": "integer" }, "publish_time": { "description": "作品发布时间,秒级 Unix 时间戳", "title": "Publish Time", "type": "integer" }, "share_count": { "description": "分享数", "title": "Share Count", "type": "integer" }, "share_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "作品页面或分享链接;可继续按 url 查询作品详情或评论;当前不可用时为 null", "title": "Share Url" }, "topic_tags": { "description": "作品话题标签列表;无话题标签时为空数组", "items": { "additionalProperties": false, "properties": { "id": { "description": "话题标签 ID;当前不可用时为空字符串", "title": "Id", "type": "string" }, "name": { "description": "话题标签名称", "title": "Name", "type": "string" } }, "required": [ "name", "id" ], "title": "DouyinTopicTagData", "type": "object" }, "title": "Topic Tags", "type": "array" }, "video": { "anyOf": [ { "properties": { "duration_ms": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "播放器资源时长,毫秒;当前不可用时为 null", "title": "Duration Ms" }, "height": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "播放器资源高度,像素;当前不可用时为 null", "title": "Height" }, "media_type": { "description": "播放器资源类型:video 表示视频,audio 表示音频,unknown 表示未知", "enum": [ "video", "audio", "unknown" ], "title": "Media Type", "type": "string" }, "play_url": { "description": "抖音平台播放器资源链接;视频作品通常为 mp4,图文作品可能为音频播放资源;不同于作品页面或分享链接,不用于查询作品详情或评论", "title": "Play Url", "type": "string" }, "width": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "播放器资源宽度,像素;当前不可用时为 null", "title": "Width" } }, "required": [ "play_url", "duration_ms", "width", "height", "media_type" ], "title": "DouyinDetailVideoData", "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" ], "title": "DouyinSearchItemData", "type": "object" }, "title": "Items", "type": "array" }, "next_page_token": { "description": "下一页不透明分页令牌;为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路,不能跨能力、作品、用户、评论、关键词或筛选条件复用;不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成,不得用省略号替换中间内容。", "title": "Next Page Token", "type": "string" }, "points": { "additionalProperties": false, "description": "本次成功调用的积分消耗与账户积分余额。", "properties": { "balance": { "description": "优先返回调用完成时查询到的账户积分余额。查询失败时,回退到本次预扣后的余额快照。余额可为负数。", "type": "integer" }, "cost": { "description": "本次请求最终确认消耗的积分。", "minimum": 0, "type": "integer" } }, "required": [ "cost", "balance" ], "type": "object" } }, "required": [ "items", "next_page_token", "points" ], "title": "DouyinSearchResult", "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 yourselfcurl -s https://api.teppi.xyz/v1/evidence/sha256:9e947e0aef932581545bf52b5bb04b851741f201285efaefb6486d663ee962d0 | sha256sum