{"version":"2026-09-02","title":"SocialDataX API Catalog","product":{"name":"社媒数据助手","english_name":"SocialDataX","website":"https://socialdatax.com"},"public_api_base_url":"https://mcp.socialdatax.com","usage_limits":{"scope":"shared_api_key_rate_limit","applies_to":["public_api","authenticated_mcp"],"rate_limit":{"enabled":true,"max_requests":5,"window_seconds":1,"key":"API Key","behavior":"业务 API 与鉴权 MCP 共用 API Key 维度限流；命中上限时返回 429，并通过 Retry-After 告知建议等待时间。","retry_after_header":"Retry-After","requests_per_second":5,"description":"当前按 API Key 限流：1 秒内最多 5 次请求。批量任务建议降低并发并增加退避重试。"}},"error_contract":{"response_body_schema":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"integer","description":"错误码；成功响应不会返回该字段。"},"message":{"type":"string","description":"可直接展示给用户的错误说明。"},"retry_after_seconds":{"type":"integer","description":"建议等待多少秒后重试；仅在服务能确定等待时间时返回。HTTP 429 响应会同步返回 Retry-After header。","minimum":1},"rate_limit_max_requests":{"type":"integer","description":"当前限流窗口内最多允许的请求次数；仅 HTTP 429 返回。","minimum":1},"rate_limit_window_seconds":{"type":"integer","description":"当前限流窗口秒数；仅 HTTP 429 返回。","minimum":1},"rate_limit_requests_per_second":{"type":"number","description":"按秒换算后的当前请求速率上限；仅 HTTP 429 返回。","exclusiveMinimum":0},"available_sort_types":{"type":"array","description":"当前内容可用的公开排序值；仅排序不可用错误码 2001 返回。","items":{"type":"string","enum":["default","time_descending","like_count_descending"]},"minItems":1,"uniqueItems":true}}},"common_errors":[{"id":"validation_error","http_status":400,"code":1400,"title":"请求参数错误","message":"请求体参数不正确","when":"请求 JSON 不是对象、缺少必填字段，或字段类型、枚举取值不符合 Schema。","handling":"按请求 Schema 修正参数后重试。"},{"id":"authentication_error","http_status":401,"code":1401,"title":"API Key 无效","message":"API Key 无效或已失效。","when":"API Key 缺失、配置冲突、无效、已失效或已暂停。","handling":"确认只使用一种鉴权 Header，并在后台创建或启用可用的 API Key。"},{"id":"rate_limited","http_status":429,"code":1429,"title":"请求过于频繁","message":"请求过于频繁，请稍后重试。","when":"同一个 API Key 在短时间内发起过多请求。","handling":"降低并发或稍后重试；批量任务建议增加退避重试。"},{"id":"invalid_argument","http_status":200,"code":1001,"title":"业务参数不正确","message":"参数不正确，请检查后重试","when":"参数格式通过校验，但传入的 ID、链接或筛选条件不符合接口要求。","handling":"检查 ID、链接、筛选条件和平台类型是否符合接口说明。"},{"id":"invalid_pagination_state","http_status":200,"code":1002,"title":"分页状态无效","message":"page_token 无效或已失效，请清空 page_token 后从第一页重新请求","when":"继续翻页时传入的 page_token 或分页上下文已失效。","handling":"清空 page_token 后从第一页重新请求。"},{"id":"not_found","http_status":200,"code":1003,"title":"内容不存在","message":"未找到对应内容","when":"目标笔记、评论或用户不存在，或公开访问不可见。","handling":"确认链接或 ID 是否正确，并确认内容仍可公开访问。"},{"id":"insufficient_balance","http_status":200,"code":1004,"title":"积分不足","message":"当前 API Key 积分不足。请访问 https://socialdatax.com/dashboard/billing 充值，或切换有余额的 API Key 后重试。","when":"当前账号积分不足，无法发起本次业务 API 调用。","handling":"前往后台充值或更换有余额的 API Key 后重试。"},{"id":"service_failure","http_status":200,"code":1005,"title":"服务暂时不可用","message":"服务暂时不可用，请稍后重试","when":"服务当前不可用，暂时无法完成本次请求。","handling":"稍后重试；若持续失败，请记录请求时间和接口名称后联系支持。"},{"id":"content_unavailable","http_status":200,"code":1006,"title":"内容暂不可用","message":"当前内容暂时不可用","when":"目标内容存在但当前无法读取，例如权限、状态或平台限制导致不可访问。","handling":"确认内容可公开访问；必要时换用其他公开内容重试。"},{"id":"surface_unavailable","http_status":200,"code":1007,"title":"页面暂不可访问","message":"当前页面暂时不可访问","when":"目标页面、平台入口或当前访问面暂时不可访问。","handling":"稍后重试，或确认目标链接仍可公开访问。"},{"id":"content_deleted","http_status":200,"code":1008,"title":"内容已删除","message":"当前作品已删除。","when":"目标作品已被删除，无法继续读取详情或相关内容。","handling":"作为业务失败处理，不要重试；可更换其他公开内容。"},{"id":"pgy_commercial_data_unavailable","http_status":200,"code":1009,"title":"暂无蒲公英商业合作数据","message":"该笔记暂无蒲公英商业合作数据","when":"蒲公英详情接口未提供该笔记的商业合作数据。","handling":"作为业务状态处理，不要重复重试。"},{"id":"content_sort_unavailable","http_status":200,"code":2001,"title":"当前内容不支持请求的排序方式","message":"当前内容不支持请求的排序方式","when":"当前内容没有开放请求的排序方式。","handling":"从 available_sort_types 中选择可用的公开排序值后重新请求；不得解析 message 判断可用排序。"}]},"docs_mcp":{"status":"available","endpoint":"https://mcp.socialdatax.com/docs/mcp","path":"/docs/mcp","authentication":{"required":false},"server_card_url":"https://mcp.socialdatax.com/.well-known/mcp/docs-server-card.json","resources":["socialdatax://api/catalog","socialdatax://api/platform/{platform_id}","socialdatax://api/operation/{operation_id}","socialdatax://api/openapi.json"],"tools":["search_api_docs","get_api_operation","get_openapi_spec"]},"platforms":[{"platform_id":"account","label":"账号","english_label":"Account","status":"available","surfaces":[{"surface":"http","status":"available","base_path":"/socialdatax/api/v1/points","description":"公开账号 HTTP API 提供当前 API Key 的积分余额查询。","operations":[{"operation_id":"socialdatax_get_points_balance","platform_id":"account","surface":"http","status":"available","method":"GET","path":"/socialdatax/api/v1/points/balance","summary":"查询积分余额","description":"查询当前 API Key 所属账户的 SocialDataX 积分余额。该接口只读且不扣积分。","tags":["账号","积分"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":0,"unit":"query","point_unit_price_cny":0.01,"description":"余额查询不扣积分。"},"request":{"content_type":"application/json","schema":{"properties":{},"title":"PublicPointsBalanceRequest","type":"object"},"example":{}},"response":{"content_type":"application/json","schema":{"properties":{"balance":{"title":"Balance","type":"integer","description":"当前 API Key 所属账户的积分余额。"}},"required":["balance"],"title":"PublicPointsBalanceResponse","type":"object"},"example":{"balance":990}},"related_mcp_tools":["socialdatax_get_points_balance"]}]}]},{"platform_id":"xhs","label":"小红书","english_label":"XHS / RedNote","status":"available","surfaces":[{"surface":"http","status":"available","base_path":"/socialdatax/api/v1/xhs","operation_groups":[{"group_id":"content_account","label":"笔记与账号相关","english_label":"Notes & Account","operation_ids":["xhs_get_search_hot_list","xhs_search_suggestions","xhs_search_notes","xhs_get_note_detail","xhs_get_topic_notes_by_page_id","xhs_get_note_comments","xhs_get_note_sub_comments","xhs_get_user_info","xhs_get_user_posted_notes"]},{"group_id":"product","label":"商品相关","english_label":"Product","operation_ids":["xhs_search_products","xhs_get_product_detail","xhs_get_product_reviews"]},{"group_id":"pgy","label":"蒲公英相关","english_label":"PGY","operation_ids":["xhs_pgy_get_note_detail"]}],"operations":[{"operation_id":"xhs_get_search_hot_list","platform_id":"xhs","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/xhs/hot/search/list","summary":"读取小红书搜索热榜","description":"读取小红书搜索热榜，返回热榜标题和热度值。","tags":["内容搜索","搜索热榜","小红书"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{},"title":"InternalSearchHotListRequest","type":"object"},"example":{}},"response":{"content_type":"application/json","schema":{"$defs":{"SearchHotListItem":{"additionalProperties":false,"properties":{"title":{"description":"热榜标题","title":"Title","type":"string"},"hot_value":{"description":"热度值","title":"Hot Value","type":"integer"}},"required":["title","hot_value"],"title":"SearchHotListItem","type":"object"}},"additionalProperties":false,"properties":{"items":{"description":"搜索热榜条目列表","items":{"$ref":"#/$defs/SearchHotListItem"},"title":"Items","type":"array"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","points"],"title":"SearchHotListResult","type":"object"},"example":{"items":[{"title":"用万能旅行拍照姿势美美出片","hot_value":9255000}],"points":{"cost":10,"balance":990}}},"related_mcp_tools":["xhs_get_search_hot_list"]},{"operation_id":"xhs_search_suggestions","platform_id":"xhs","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/xhs/search/suggestions","summary":"读取小红书搜索建议","description":"按搜索词读取候选搜索建议，返回建议文本、搜索目标和补充说明。","tags":["内容搜索","搜索建议","小红书"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"keyword":{"title":"Keyword","type":"string","description":"搜索词，可传正在输入的关键词或短语；不要传笔记链接、主页链接、note_id、user_id 或分页令牌。"}},"required":["keyword"],"title":"InternalSearchSuggestionsRequest","type":"object"},"example":{"keyword":"露营"}},"response":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"items":{"description":"搜索建议条目列表","items":{"additionalProperties":false,"properties":{"text":{"description":"搜索建议文本","title":"Text","type":"string"},"search_target":{"description":"采用该建议后应搜索的对象，例如 notes 或 goods","title":"Search Target","type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"搜索建议补充说明；没有补充说明时为 null","title":"Description"}},"required":["text","search_target","description"],"title":"SearchSuggestionItem","type":"object"},"title":"Items","type":"array"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","points"],"title":"SearchSuggestionsResult","type":"object"},"example":{"items":[{"text":"露营装备","search_target":"notes","description":null}],"points":{"cost":10,"balance":990}}},"related_mcp_tools":["xhs_search_suggestions"]},{"operation_id":"xhs_search_notes","platform_id":"xhs","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/xhs/note/search","summary":"搜索小红书笔记","description":"按关键词和筛选条件搜索公开小红书笔记，返回结构化笔记摘要和下一页分页令牌。","tags":["内容搜索","小红书"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"keyword":{"title":"Keyword","type":"string","description":"搜索词，可传关键词或短语，例如品牌名、话题、人物名、产品名或内容需求；不要传笔记链接、主页链接、note_id、user_id 或 page_token。"},"sort_type":{"default":"general","enum":["general","time_descending","like_count_descending","comment_count_descending","collect_count_descending"],"title":"Sort Type","type":"string","description":"笔记搜索结果排序方式。","x-socialdatax-enum-labels":{"general":"综合","time_descending":"最新发布优先","like_count_descending":"最多点赞优先","comment_count_descending":"最多评论优先","collect_count_descending":"最多收藏优先"}},"note_type":{"default":"all","enum":["all","image","video"],"title":"Note Type","type":"string","description":"笔记类型筛选。","x-socialdatax-enum-labels":{"all":"不限","image":"图文","video":"视频"}},"publish_time_range":{"default":"all","enum":["all","day","week","half_year"],"title":"Publish Time Range","type":"string","description":"发布时间范围筛选。","x-socialdatax-enum-labels":{"all":"不限","day":"一天内","week":"一周内","half_year":"半年内"}},"page_token":{"default":"","title":"Page Token","type":"string","description":"笔记搜索分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌，只能用于同一笔记搜索链路，不能跨关键词、排序、笔记类型、发布时间范围和调用方复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"}},"required":["keyword"],"title":"InternalSearchNotesRequest","type":"object"},"example":{"keyword":"露营","sort_type":"general","note_type":"all","publish_time_range":"all","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"AuthorSummary":{"properties":{"user_id":{"description":"作者 user_id","title":"User Id","type":"string"},"name":{"description":"作者名称","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者头像链接；没有头像链接时为 null","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者主页链接；没有主页链接时为 null","title":"Profile Url"},"red_id":{"description":"作者公开小红书号；没有小红书号时为空字符串","title":"Red Id","type":"string"}},"required":["user_id","name","avatar_url","profile_url","red_id"],"title":"AuthorSummary","type":"object"},"SearchNoteItem":{"properties":{"note_url":{"description":"note_url 是可打开笔记内容所需的完整 URL。任何使用该返回链接的场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得修改、截断、脱敏、规范化、重组，也不得用 note_id 重新拼接链接。","title":"Note Url","type":"string"},"note_id":{"description":"小红书笔记 ID。必须原样使用完整 note_id；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。","title":"Note Id","type":"string"},"note_type":{"description":"笔记类型；当前公开值固定为 image 或 video","enum":["image","video"],"title":"Note Type","type":"string","x-socialdatax-enum-labels":{"image":"图文","video":"视频"}},"title":{"description":"笔记标题","title":"Title","type":"string"},"summary":{"description":"笔记摘要；不是全文","title":"Summary","type":"string"},"cover_image_url":{"description":"统一封面图","title":"Cover Image Url","type":"string"},"like_count":{"description":"点赞数","title":"Like Count","type":"integer"},"collect_count":{"description":"收藏数","title":"Collect Count","type":"integer"},"comment_count":{"description":"评论数","title":"Comment Count","type":"integer"},"share_count":{"description":"分享数","title":"Share Count","type":"integer"},"publish_time":{"description":"发布时间，秒级 Unix 时间戳","title":"Publish Time","type":"integer"},"update_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"更新时间，秒级 Unix 时间戳；没有有效更新时间时为 null","title":"Update Time"},"video":{"anyOf":[{"$ref":"#/$defs/SearchNoteVideo"},{"type":"null"}],"description":"视频摘要信息；仅视频笔记返回对象，图文为 null"},"author":{"$ref":"#/$defs/AuthorSummary","description":"作者信息"}},"required":["note_url","note_id","note_type","title","summary","cover_image_url","like_count","collect_count","comment_count","share_count","publish_time","update_time","video","author"],"title":"SearchNoteItem","type":"object"},"SearchNoteVideo":{"additionalProperties":false,"properties":{"video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"视频链接；没有视频链接时为 null","title":"Video Url"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频原始时长，单位毫秒；没有时长时为 null","title":"Duration Ms"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频宽度，像素；没有时为 null","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频高度，像素；没有时为 null","title":"Height"}},"required":["video_url","duration_ms","width","height"],"title":"SearchNoteVideo","type":"object"}},"properties":{"items":{"description":"笔记搜索结果中的笔记列表，已过滤非笔记卡片与不可公开笔记；当前页过滤后可能为空数组","items":{"$ref":"#/$defs/SearchNoteItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果或无法继续 token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一笔记搜索链路，不能跨关键词、排序、笔记类型、发布时间范围和调用方复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"SearchNotesResult","type":"object"},"example":{"items":[{"note_url":"https://www.xiaohongshu.com/discovery/item/69e71b110000000022029e5e?xsec_source=app_share&xsec_token=CB8LYwuNCmdLCh4IingDx12rfddpSYoSu-dkiRRHnsk6o=","note_id":"69e71b110000000022029e5e","note_type":"image","title":"露营装备清单","summary":"适合周末出行的装备组合。","cover_image_url":"https://example.invalid/cover.webp","like_count":120,"collect_count":35,"comment_count":18,"share_count":4,"publish_time":1714316800,"update_time":null,"video":null,"author":{"user_id":"67c25fdc000000000a03dae1","name":"露营研究员","avatar_url":"https://example.invalid/avatar.webp","profile_url":"https://www.xiaohongshu.com/user/profile/67c25fdc000000000a03dae1","red_id":"camp-001"}}],"next_page_token":"opaque-search-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["xhs_search_notes"]},{"operation_id":"xhs_search_products","platform_id":"xhs","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/xhs/product/search","summary":"搜索小红书商品","description":"按关键词搜索公开小红书商品，返回商品信息和下一页分页令牌。","tags":["商品搜索","小红书"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"keyword":{"title":"Keyword","type":"string","description":"搜索词，可传商品名、品牌名、品类或商品需求；不要传商品链接、sku_id、spu_id 或 page_token。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"商品搜索分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 只能用于同一商品关键词和调用方的商品搜索链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"}},"required":["keyword"],"title":"InternalProductSearchRequest","type":"object"},"example":{"keyword":"露营","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"ProductSearchItem":{"additionalProperties":false,"properties":{"sku_id":{"description":"商品 SKU ID；可用于商品详情接口，也可用于商品评价接口","title":"Sku Id","type":"string"},"spu_id":{"description":"商品 SPU ID；不要作为商品详情接口入参，也不要作为商品评价接口入参","title":"Spu Id","type":"string"},"title":{"description":"商品标题","title":"Title","type":"string"},"description":{"description":"商品搜索展示描述；可能与标题重复或包含规格信息，不保证是完整详情描述","title":"Description","type":"string"},"image_url":{"description":"商品图片链接","title":"Image Url","type":"string"},"price":{"description":"商品列表展示销售价，单位：元","title":"Price","type":"number"},"coupon_price":{"description":"券后价格，单位：元","title":"Coupon Price","type":"number"},"shop_id":{"description":"店铺 ID","title":"Shop Id","type":"string"},"shop_name":{"description":"店铺名称","title":"Shop Name","type":"string"},"shop_avatar_url":{"description":"店铺头像链接","title":"Shop Avatar Url","type":"string"},"stock_quantity":{"description":"库存数量","title":"Stock Quantity","type":"integer"},"purchasable":{"description":"是否可购买","title":"Purchasable","type":"boolean"},"sold_count":{"description":"已售数量；平台以带“+”的万级文本展示时转换为对应整数下限（如“已售1万+”返回 10000、“已售1.2万+”返回 12000），无法解析时为 0","title":"Sold Count","type":"integer"}},"required":["sku_id","spu_id","title","description","image_url","price","coupon_price","shop_id","shop_name","shop_avatar_url","stock_quantity","purchasable","sold_count"],"title":"ProductSearchItem","type":"object"}},"additionalProperties":false,"properties":{"items":{"description":"商品搜索结果列表","items":{"$ref":"#/$defs/ProductSearchItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明商品搜索分页令牌；为空表示没有更多结果或当前无法继续翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一商品关键词和调用方的商品搜索链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"ProductSearchResult","type":"object"},"example":{"items":[{"sku_id":"691c1de31896c300014f6ea8","spu_id":"691c1de31896c300014f6ea7","title":"露营折叠桌","description":"适合露营使用的折叠桌","image_url":"https://example.invalid/product.webp","price":299.0,"coupon_price":296.0,"shop_id":"69d25a8635183b00159be6ef","shop_name":"露营装备店","shop_avatar_url":"https://example.invalid/shop.webp","stock_quantity":19,"purchasable":true,"sold_count":5}],"next_page_token":"opaque-product-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["xhs_search_products"]},{"operation_id":"xhs_get_product_detail","platform_id":"xhs","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/xhs/product/detail","summary":"读取小红书商品详情","description":"根据完整 sku_id 读取小红书商品详情；用户已提供时直接使用，否则可从商品搜索结果获取，返回价格、店铺、图片、发货和规格参数。","tags":["商品详情","小红书"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"sku_id":{"description":"小红书商品 SKU ID；用户已提供完整 sku_id 时原样使用，否则可从商品搜索结果复制。不支持 spu_id、商品链接或搜索关键词。","title":"Sku Id","type":"string"}},"required":["sku_id"],"title":"InternalProductDetailRequest","type":"object"},"example":{"sku_id":"691c1de31896c300014f6ea8"}},"response":{"content_type":"application/json","schema":{"$defs":{"ProductDetailImage":{"additionalProperties":false,"properties":{"image_url":{"description":"商品展示图片链接；可能为缩放图","title":"Image Url","type":"string"},"width":{"description":"原始图片宽度；不一定等于 image_url 下载文件的像素宽度","title":"Width","type":"integer"},"height":{"description":"原始图片高度；不一定等于 image_url 下载文件的像素高度","title":"Height","type":"integer"}},"required":["image_url","width","height"],"title":"ProductDetailImage","type":"object"},"ProductDetailShipping":{"additionalProperties":false,"properties":{"location":{"description":"发货地；没有发货地时为空字符串","title":"Location","type":"string"},"fee":{"description":"运费展示文本；没有运费信息时为空字符串","title":"Fee","type":"string"},"text":{"description":"发货说明；没有发货说明时为空字符串","title":"Text","type":"string"}},"required":["location","fee","text"],"title":"ProductDetailShipping","type":"object"},"ProductDetailSpecification":{"additionalProperties":false,"properties":{"name":{"description":"规格参数名称","title":"Name","type":"string"},"value":{"description":"规格参数值","title":"Value","type":"string"}},"required":["name","value"],"title":"ProductDetailSpecification","type":"object"}},"additionalProperties":false,"properties":{"sku_id":{"description":"商品 SKU ID","title":"Sku Id","type":"string"},"title":{"description":"商品标题","title":"Title","type":"string"},"price":{"description":"商品原价，单位：元","title":"Price","type":"number"},"coupon_price":{"description":"券后/成交价格，单位：元","title":"Coupon Price","type":"number"},"sold_count":{"description":"已售数量；平台以带“+”的万级文本展示时转换为对应整数下限（如“已售1万+”返回 10000、“已售1.2万+”返回 12000），无法解析时为 0","title":"Sold Count","type":"integer"},"stock_status":{"description":"库存状态码；具体码值含义未公开定义，不要自行解释","title":"Stock Status","type":"integer"},"shop_id":{"description":"店铺 ID","title":"Shop Id","type":"string"},"shop_name":{"description":"店铺名称","title":"Shop Name","type":"string"},"shop_avatar_url":{"description":"店铺头像链接","title":"Shop Avatar Url","type":"string"},"images":{"description":"商品头图列表","items":{"$ref":"#/$defs/ProductDetailImage"},"title":"Images","type":"array"},"detail_images":{"description":"商品详情图列表","items":{"$ref":"#/$defs/ProductDetailImage"},"title":"Detail Images","type":"array"},"selected_variant":{"description":"当前选中规格；没有规格时为空字符串","title":"Selected Variant","type":"string"},"assurances":{"description":"商品保障服务列表","items":{"type":"string"},"title":"Assurances","type":"array"},"shipping":{"$ref":"#/$defs/ProductDetailShipping","description":"发货信息"},"shop_score":{"description":"店铺评分展示值；没有评分时为空字符串","title":"Shop Score","type":"string"},"shop_fans_text":{"description":"店铺粉丝数展示值；没有粉丝信息时为空字符串","title":"Shop Fans Text","type":"string"},"shop_sold_text":{"description":"店铺已售展示值；没有已售信息时为空字符串","title":"Shop Sold Text","type":"string"},"specifications":{"description":"规格参数列表","items":{"$ref":"#/$defs/ProductDetailSpecification"},"title":"Specifications","type":"array"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["sku_id","title","price","coupon_price","sold_count","stock_status","shop_id","shop_name","shop_avatar_url","images","detail_images","selected_variant","assurances","shipping","shop_score","shop_fans_text","shop_sold_text","specifications","points"],"title":"ProductDetailResult","type":"object"},"example":{"sku_id":"691c1de31896c300014f6ea8","title":"露营折叠桌","price":299.0,"coupon_price":296.0,"sold_count":5,"stock_status":1,"shop_id":"69d25a8635183b00159be6ef","shop_name":"露营装备店","shop_avatar_url":"https://example.invalid/shop.webp","images":[{"image_url":"https://example.invalid/product.webp","width":1200,"height":1200}],"detail_images":[{"image_url":"https://example.invalid/detail.webp","width":1200,"height":800}],"selected_variant":"默认规格","assurances":["7天无理由退货"],"shipping":{"location":"浙江宁波","fee":"包邮","text":"预计24小时内发货"},"shop_score":"4.8","shop_fans_text":"1200","shop_sold_text":"3500","specifications":[{"name":"商品名称","value":"露营折叠桌"}],"points":{"cost":10,"balance":990}}},"related_mcp_tools":["xhs_get_product_detail"]},{"operation_id":"xhs_get_product_reviews","platform_id":"xhs","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/xhs/product/review/list","summary":"读取小红书商品评价","description":"根据完整 sku_id 读取小红书商品评价；用户已提供时直接使用，否则可从商品搜索结果获取，支持排序、仅看带图评价和分页令牌。","tags":["商品评价","小红书"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"sku_id":{"description":"小红书商品 SKU ID；用户已提供完整 sku_id 时原样使用，否则可从商品搜索结果复制。不支持 spu_id、商品链接或搜索关键词。","title":"Sku Id","type":"string"},"page_token":{"default":"","description":"商品评价分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 只能用于同一商品 SKU、排序、图片筛选和调用方的商品评价链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。","title":"Page Token","type":"string"},"sort_type":{"default":"general","description":"商品评价排序方式，可选：general（综合，默认）、time_descending（最新评价优先）","enum":["general","time_descending"],"title":"Sort Type","type":"string","x-socialdatax-enum-labels":{"general":"综合","time_descending":"最新评价优先"}},"has_image":{"default":false,"description":"是否只返回带图片的商品评价","title":"Has Image","type":"boolean"}},"required":["sku_id"],"title":"InternalProductReviewsRequest","type":"object"},"example":{"sku_id":"691c1de31896c300014f6ea8","page_token":"","sort_type":"general","has_image":false}},"response":{"content_type":"application/json","schema":{"$defs":{"ProductReviewAuthor":{"additionalProperties":false,"properties":{"user_id":{"description":"作者 user_id","title":"User Id","type":"string"},"name":{"description":"作者名称；没有作者名时为空字符串","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者头像链接；没有头像链接时为 null","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者主页链接；没有主页链接时为 null","title":"Profile Url"}},"required":["user_id","name","avatar_url","profile_url"],"title":"ProductReviewAuthor","type":"object"},"ProductReviewImageItem":{"additionalProperties":false,"properties":{"image_url":{"description":"评价原图链接","title":"Image Url","type":"string"},"thumbnail_url":{"description":"评价图片缩略图链接；没有缩略图链接时为空字符串","title":"Thumbnail Url","type":"string"},"width":{"description":"评价原图宽度；无法获取时为 0","title":"Width","type":"integer"},"height":{"description":"评价原图高度；无法获取时为 0","title":"Height","type":"integer"}},"required":["image_url","thumbnail_url","width","height"],"title":"ProductReviewImageItem","type":"object"},"ProductReviewItem":{"additionalProperties":false,"properties":{"content":{"description":"评价文字内容；图片评价可能没有文字，此时为空字符串","title":"Content","type":"string"},"like_count":{"description":"评价点赞数；无法获取时为 0","title":"Like Count","type":"integer"},"review_id":{"description":"评价 ID；无法获取时为空字符串","title":"Review Id","type":"string"},"publish_time_text":{"description":"评价时间展示文本；可能是相对时间（如 1小时前）、月日（如 08-05）或完整日期（如 2025-06-13）；不是 Unix 时间戳，不要自行补全年份或时分秒；无法获取时为空字符串","title":"Publish Time Text","type":"string"},"image_items":{"description":"评价图片列表","items":{"$ref":"#/$defs/ProductReviewImageItem"},"title":"Image Items","type":"array"},"product_score":{"description":"商品评分，通常为 1-5；0 表示无法获取","title":"Product Score","type":"integer"},"logistics_score":{"description":"物流评分，通常为 1-5；0 表示无法获取","title":"Logistics Score","type":"integer"},"service_score":{"description":"服务评分，通常为 1-5；0 表示无法获取","title":"Service Score","type":"integer"},"purchased_variants":{"description":"购买时选择的商品规格列表","items":{"$ref":"#/$defs/ProductReviewVariant"},"title":"Purchased Variants","type":"array"},"author":{"$ref":"#/$defs/ProductReviewAuthor","description":"评价作者信息"}},"required":["content","like_count","review_id","publish_time_text","image_items","product_score","logistics_score","service_score","purchased_variants","author"],"title":"ProductReviewItem","type":"object"},"ProductReviewVariant":{"additionalProperties":false,"properties":{"name":{"description":"购买规格名称","title":"Name","type":"string"},"value":{"description":"购买规格值","title":"Value","type":"string"}},"required":["name","value"],"title":"ProductReviewVariant","type":"object"}},"additionalProperties":false,"properties":{"items":{"description":"当前页商品评价列表","items":{"$ref":"#/$defs/ProductReviewItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明商品评价分页令牌；items 为空时仍应继续翻页；为空表示没有更多结果或当前无法继续翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一商品 SKU、排序、图片筛选和调用方的商品评价链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"ProductReviewsResult","type":"object"},"example":{"items":[{"content":"评价内容","like_count":3,"review_id":"498254417103766817","publish_time_text":"2025-06-13","image_items":[{"image_url":"https://example.invalid/review.webp","thumbnail_url":"https://example.invalid/review-thumb.webp","width":3024,"height":4032}],"product_score":5,"logistics_score":4,"service_score":5,"purchased_variants":[{"name":"颜色分类","value":"经典款"}],"author":{"user_id":"5decf8630000000001003d5f","name":"小红书用户","avatar_url":"https://example.invalid/avatar.webp","profile_url":"https://www.xiaohongshu.com/user/profile/5decf8630000000001003d5f"}}],"next_page_token":"<完整分页令牌>","points":{"cost":10,"balance":990}}},"related_mcp_tools":["xhs_get_product_reviews"]},{"operation_id":"xhs_get_note_detail","platform_id":"xhs","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/xhs/note/detail","summary":"读取小红书笔记详情","description":"按笔记 ID、笔记链接、短链接或分享文案读取公开笔记详情，返回正文、媒体摘要、互动指标和作者信息。","tags":["内容详情","小红书"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"note_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"小红书笔记 ID。已有完整 note_id 时原样使用，否则可从笔记搜索结果、笔记详情、评论、标签页笔记列表或用户发帖列表复制；不得截断、缩写或只传前缀","title":"Note Id"},"note_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Note Url","description":"小红书笔记链接、短链接或分享文案。"}},"title":"InternalNoteDetailRequest","type":"object"},"example":{"note_id":"69e71b110000000022029e5e"}},"response":{"content_type":"application/json","schema":{"$defs":{"BaseAuthorSummary":{"additionalProperties":false,"properties":{"user_id":{"description":"作者 user_id","title":"User Id","type":"string"},"name":{"description":"作者名称","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者头像链接；没有头像链接时为 null","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者主页链接；没有主页链接时为 null","title":"Profile Url"}},"required":["user_id","name","avatar_url","profile_url"],"title":"BaseAuthorSummary","type":"object"},"NoteDetailVideo":{"additionalProperties":false,"properties":{"video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"视频链接；没有视频链接时为 null","title":"Video Url"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频时长，单位毫秒；没有时长时为 null","title":"Duration Ms"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频宽度，像素；没有时为 null","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频高度，像素；没有时为 null","title":"Height"}},"required":["video_url","duration_ms","width","height"],"title":"NoteDetailVideo","type":"object"},"NoteImageItem":{"additionalProperties":false,"properties":{"image_url":{"description":"图片链接","title":"Image Url","type":"string"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片宽度，像素；没有时为 null","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片高度，像素；没有时为 null","title":"Height"},"live_photo":{"anyOf":[{"$ref":"#/$defs/NoteLivePhoto"},{"type":"null"}],"description":"Live 图视频摘要；普通图片或没有视频摘要时为 null"}},"required":["image_url","width","height","live_photo"],"title":"NoteImageItem","type":"object"},"NoteLivePhoto":{"additionalProperties":false,"properties":{"video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Live 图视频链接；没有视频链接时为 null","title":"Video Url"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Live 图时长，单位毫秒；没有时长时为 null","title":"Duration Ms"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Live 图视频宽度，像素；没有时为 null","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Live 图视频高度，像素；没有时为 null","title":"Height"}},"required":["video_url","duration_ms","width","height"],"title":"NoteLivePhoto","type":"object"},"NoteMentionedUser":{"additionalProperties":false,"properties":{"user_id":{"description":"被 @ 用户的 user_id；没有用户 ID 时为空字符串","title":"User Id","type":"string"},"name":{"description":"被 @ 用户名称；没有用户名称时为空字符串","title":"Name","type":"string"}},"required":["user_id","name"],"title":"NoteMentionedUser","type":"object"},"NoteTopicTag":{"additionalProperties":false,"properties":{"name":{"description":"话题标签名称","title":"Name","type":"string"},"id":{"description":"话题标签 ID；没有可用 ID 时为空字符串","title":"Id","type":"string"}},"required":["name","id"],"title":"NoteTopicTag","type":"object"}},"additionalProperties":false,"properties":{"note_id":{"description":"小红书笔记 ID。必须原样使用完整 note_id；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。","title":"Note Id","type":"string"},"note_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"note_url 是可打开笔记内容所需的完整 URL。任何使用该返回链接的场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得修改、截断、脱敏、规范化、重组，也不得用 note_id 重新拼接链接。无法提供可用链接时为 null；note_url 为 null 时不要用 note_id 合成公开链接。","title":"Note Url"},"note_type":{"description":"笔记类型；当前公开值固定为 image 或 video","enum":["image","video"],"title":"Note Type","type":"string","x-socialdatax-enum-labels":{"image":"图文","video":"视频"}},"title":{"description":"笔记标题","title":"Title","type":"string"},"content":{"description":"笔记正文","title":"Content","type":"string"},"cover_image_url":{"description":"统一封面图","title":"Cover Image Url","type":"string"},"image_items":{"description":"图片结构化明细；每项都表示一张图片，Live 图会在对应项携带 live_photo 摘要","items":{"$ref":"#/$defs/NoteImageItem"},"title":"Image Items","type":"array"},"video":{"anyOf":[{"$ref":"#/$defs/NoteDetailVideo"},{"type":"null"}],"description":"视频摘要信息；无可用视频摘要时为 null"},"like_count":{"description":"点赞数","title":"Like Count","type":"integer"},"collect_count":{"description":"收藏数","title":"Collect Count","type":"integer"},"comment_count":{"description":"评论数","title":"Comment Count","type":"integer"},"share_count":{"description":"分享数","title":"Share Count","type":"integer"},"publish_time":{"description":"发布时间，秒级 Unix 时间戳","title":"Publish Time","type":"integer"},"update_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"更新时间，秒级 Unix 时间戳；没有有效更新时间时为 null","title":"Update Time"},"ip_location":{"description":"笔记发布时的 IP 属地；没有 IP 属地时为空字符串","title":"Ip Location","type":"string"},"topic_tags":{"description":"笔记详情中的话题标签；无话题时为空数组","items":{"$ref":"#/$defs/NoteTopicTag"},"title":"Topic Tags","type":"array"},"mentioned_users":{"description":"笔记正文中 @ 到的用户列表；无 @ 时为空数组","items":{"$ref":"#/$defs/NoteMentionedUser"},"title":"Mentioned Users","type":"array"},"author":{"$ref":"#/$defs/BaseAuthorSummary","description":"作者信息；详情页不返回小红书号"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["note_id","note_url","note_type","title","content","cover_image_url","image_items","video","like_count","collect_count","comment_count","share_count","publish_time","update_time","ip_location","topic_tags","mentioned_users","author","points"],"title":"NoteDetailData","type":"object"},"example":{"note_id":"69e71b110000000022029e5e","note_url":"https://www.xiaohongshu.com/discovery/item/69e71b110000000022029e5e?xsec_source=app_share&xsec_token=CB8LYwuNCmdLCh4IingDx12rfddpSYoSu-dkiRRHnsk6o=","note_type":"image","title":"露营装备清单","content":"周末露营可以从这几类装备开始准备。","cover_image_url":"https://example.invalid/cover.webp","image_items":[{"image_url":"https://example.invalid/1.webp","width":1200,"height":1600,"live_photo":null}],"video":null,"like_count":120,"collect_count":35,"comment_count":18,"share_count":4,"publish_time":1714316800,"update_time":null,"ip_location":"上海","topic_tags":[{"name":"露营","id":"topic-1"}],"mentioned_users":[{"user_id":"mentioned-user-1","name":"装备清单"}],"author":{"user_id":"67c25fdc000000000a03dae1","name":"露营研究员","avatar_url":"https://example.invalid/avatar.webp","profile_url":"https://www.xiaohongshu.com/user/profile/67c25fdc000000000a03dae1"},"points":{"cost":10,"balance":990}}},"related_mcp_tools":["xhs_get_note_detail_by_note_id","xhs_get_note_detail_by_note_url"]},{"operation_id":"xhs_pgy_get_note_detail","platform_id":"xhs","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/xhs/pgy/note/detail","summary":"读取小红书蒲公英单篇笔记详情","description":"按 note_id 或小红书笔记链接、短链接、分享文案读取蒲公英单篇笔记商业增强详情，返回正文、图片或视频摘要、作者、曝光量、阅读量、互动量和图文/视频报价。这是蒲公英商业口径数据，不等同普通公开笔记详情；只支持查询单篇笔记，不支持博主全量笔记汇总。成功调用扣减 20 积分，失败不扣费。","tags":["蒲公英","内容详情","小红书"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":20,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 20 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"note_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"小红书笔记 ID。已有完整 note_id 时原样使用，否则可从笔记搜索结果、笔记详情、评论、标签页笔记列表或用户发帖列表复制；不得截断、缩写或只传前缀","title":"Note Id"},"note_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"小红书笔记链接、短链接或包含链接的分享文案；与 note_id 必须且只能提供一个","title":"Note Url"}},"title":"InternalPgyNoteDetailRequest","type":"object"},"example":{"note_url":"https://www.xiaohongshu.com/discovery/item/69e71b110000000022029e5e?xsec_source=app_share&xsec_token=CB8LYwuNCmdLCh4IingDx12rfddpSYoSu-dkiRRHnsk6o="}},"response":{"content_type":"application/json","schema":{"$defs":{"NoteDetailVideo":{"additionalProperties":false,"properties":{"video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"视频链接；没有视频链接时为 null","title":"Video Url"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频时长，单位毫秒；没有时长时为 null","title":"Duration Ms"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频宽度，像素；没有时为 null","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频高度，像素；没有时为 null","title":"Height"}},"required":["video_url","duration_ms","width","height"],"title":"NoteDetailVideo","type":"object"},"PgyAuthorSummary":{"additionalProperties":false,"properties":{"user_id":{"description":"作者 user_id","minLength":1,"title":"User Id","type":"string"},"name":{"description":"作者名称","title":"Name","type":"string"},"avatar_url":{"description":"作者头像链接","minLength":1,"title":"Avatar Url","type":"string"},"profile_url":{"description":"作者主页链接","minLength":1,"title":"Profile Url","type":"string"}},"required":["user_id","name","avatar_url","profile_url"],"title":"PgyAuthorSummary","type":"object"},"PgyNoteImageItem":{"additionalProperties":false,"properties":{"image_url":{"description":"图片链接","minLength":1,"title":"Image Url","type":"string"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片宽度，像素；没有时为 null","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片高度，像素；没有时为 null","title":"Height"},"live_photo":{"description":"蒲公英当前未返回样本证实的 Live 图视频摘要，固定为 null","title":"Live Photo","type":"null"}},"required":["image_url","width","height","live_photo"],"title":"PgyNoteImageItem","type":"object"}},"additionalProperties":false,"properties":{"note_id":{"description":"小红书笔记 ID。必须原样使用完整 note_id；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。","title":"Note Id","type":"string"},"note_url":{"description":"note_url 是可打开笔记内容所需的完整 URL。任何使用该返回链接的场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得修改、截断、脱敏、规范化、重组，也不得用 note_id 重新拼接链接。","minLength":1,"title":"Note Url","type":"string"},"title":{"description":"蒲公英笔记标题","title":"Title","type":"string"},"note_type":{"description":"笔记类型；当前公开值固定为 image 或 video","enum":["image","video"],"title":"Note Type","type":"string","x-socialdatax-enum-labels":{"image":"图文","video":"视频"}},"content":{"description":"笔记正文","title":"Content","type":"string"},"cover_image_url":{"description":"统一封面图","minLength":1,"title":"Cover Image Url","type":"string"},"image_items":{"description":"图片结构化明细；每项都表示一张图片","items":{"$ref":"#/$defs/PgyNoteImageItem"},"title":"Image Items","type":"array"},"video":{"anyOf":[{"$ref":"#/$defs/NoteDetailVideo"},{"type":"null"}],"description":"视频摘要信息；视频笔记返回对象，图文笔记为 null"},"publish_time":{"description":"发布时间，秒级 Unix 时间戳","title":"Publish Time","type":"integer"},"update_time":{"description":"更新时间，秒级 Unix 时间戳","title":"Update Time","type":"integer"},"exposure_count":{"description":"笔记曝光量","title":"Exposure Count","type":"integer"},"read_count":{"description":"笔记阅读量","title":"Read Count","type":"integer"},"like_count":{"description":"点赞数","title":"Like Count","type":"integer"},"collect_count":{"description":"收藏数","title":"Collect Count","type":"integer"},"comment_count":{"description":"评论数","title":"Comment Count","type":"integer"},"share_count":{"description":"分享数","title":"Share Count","type":"integer"},"author":{"$ref":"#/$defs/PgyAuthorSummary","description":"作者信息；详情页不返回小红书号"},"picture_price":{"description":"图文笔记报价","title":"Picture Price","type":"number"},"video_price":{"description":"视频笔记报价","title":"Video Price","type":"number"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["note_id","note_url","title","note_type","content","cover_image_url","image_items","video","publish_time","update_time","exposure_count","read_count","like_count","collect_count","comment_count","share_count","author","picture_price","video_price","points"],"title":"PgyNoteDetailData","type":"object"},"example":{"note_id":"69e71b110000000022029e5e","note_url":"https://www.xiaohongshu.com/explore/69e71b110000000022029e5e?xsec_token=MBPpYmgkjRzcWEXOsJtmi8jLzAoMgQHfeBuLbeLK8f3Js=&xsec_source=pc_pgy","title":"塌屁股你的兵来了！五一出游穿哪条提臀裤啊","note_type":"image","content":"五一准备出去旅游，买了好多漂亮衣服打算狠狠出片！","cover_image_url":"http://ci.xiaohongshu.com/1040g2sg31v7c8et7igkg5pu2bve2nmn1jvn0ri8?imageView2/2/w/1080/format/jpg","image_items":[{"image_url":"http://ci.xiaohongshu.com/1040g2sg31v7c8et7igkg5pu2bve2nmn1jvn0ri8?imageView2/2/w/1080/format/jpg","width":2856,"height":5712,"live_photo":null}],"video":null,"publish_time":1776753951,"update_time":1777019348,"exposure_count":1492415,"read_count":233465,"like_count":5477,"collect_count":1222,"comment_count":22,"share_count":419,"author":{"user_id":"67c25fdc000000000a03dae1","name":"小微微💞","avatar_url":"https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31vjv8bct2i4g5pu2bve2nmn127ariag?imageView2/2/w/120/format/jpg","profile_url":"https://www.xiaohongshu.com/user/profile/67c25fdc000000000a03dae1"},"picture_price":150.0,"video_price":150.0,"points":{"cost":20,"balance":980}}},"related_mcp_tools":["xhs_pgy_get_note_detail_by_note_id","xhs_pgy_get_note_detail_by_note_url"]},{"operation_id":"xhs_get_user_info","platform_id":"xhs","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/xhs/user/info","summary":"读取小红书用户资料","description":"按用户 ID 或主页链接读取创作者公开资料、认证信息和公开互动规模。","tags":["用户资料","小红书"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"小红书用户 user_id。用户已提供完整 user_id 时原样使用，否则可从笔记搜索结果、商品评价、商品评价回复、笔记详情、标签页笔记列表、用户信息或用户发帖列表的 user_id/author.user_id 复制；如果只有主页链接，请使用 profile_url 入口；不要传小红书号、昵称或主页名称","title":"User Id"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Profile Url","description":"小红书用户主页链接。"}},"title":"InternalUserInfoRequest","type":"object"},"example":{"user_id":"67c25fdc000000000a03dae1"}},"response":{"content_type":"application/json","schema":{"properties":{"user_id":{"description":"用户 user_id","title":"User Id","type":"string"},"name":{"description":"用户名称","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户头像链接；没有头像链接时为 null","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户主页链接；没有主页链接时为 null","title":"Profile Url"},"red_id":{"description":"用户公开小红书号；没有小红书号时为空字符串","title":"Red Id","type":"string"},"bio":{"description":"用户个人简介（biography）；没有简介时为空字符串","title":"Bio","type":"string"},"verified":{"description":"是否已认证","title":"Verified","type":"boolean"},"verification_category":{"description":"认证补充信息；可能是行业类目或认证主体名称；未认证或没有认证信息时为空字符串","title":"Verification Category","type":"string"},"is_professional_account":{"description":"是否为专业号","title":"Is Professional Account","type":"boolean"},"verification_name":{"description":"认证主体名称；没有认证主体时为空字符串","title":"Verification Name","type":"string"},"is_enterprise_account":{"description":"是否为企业账号","title":"Is Enterprise Account","type":"boolean"},"profile_tags":{"description":"主页头部标签名称列表；没有标签时为空数组","items":{"type":"string"},"title":"Profile Tags","type":"array"},"follower_count":{"description":"粉丝数","title":"Follower Count","type":"integer"},"following_count":{"description":"关注数","title":"Following Count","type":"integer"},"posted_note_count":{"description":"已发布笔记数","title":"Posted Note Count","type":"integer"},"received_like_count":{"description":"用户内容累计收到的点赞数","title":"Received Like Count","type":"integer"},"received_collect_count":{"description":"用户内容累计被收藏数","title":"Received Collect Count","type":"integer"},"ip_location":{"description":"用户 IP 属地；没有 IP 属地时为空字符串","title":"Ip Location","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["user_id","name","avatar_url","profile_url","red_id","bio","verified","verification_category","is_professional_account","verification_name","is_enterprise_account","profile_tags","follower_count","following_count","posted_note_count","received_like_count","received_collect_count","ip_location","points"],"title":"UserInfoData","type":"object"},"example":{"user_id":"67c25fdc000000000a03dae1","name":"露营研究员","avatar_url":"https://example.invalid/avatar.webp","profile_url":"https://www.xiaohongshu.com/user/profile/67c25fdc000000000a03dae1","red_id":"camp-001","bio":"记录露营和户外装备。","verified":true,"verification_category":"户外","is_professional_account":true,"verification_name":"户外样例企业有限公司","is_enterprise_account":true,"profile_tags":["户外","品牌主理人"],"follower_count":12000,"following_count":80,"posted_note_count":128,"received_like_count":300000,"received_collect_count":90000,"ip_location":"上海","points":{"cost":10,"balance":990}}},"related_mcp_tools":["xhs_get_user_info_by_user_id","xhs_get_user_info_by_profile_url"]},{"operation_id":"xhs_get_user_posted_notes","platform_id":"xhs","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/xhs/user/note/list","summary":"读取小红书用户笔记列表","description":"按用户 ID 或主页链接读取创作者已发布笔记摘要列表，支持分页令牌。","tags":["用户内容","小红书"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"小红书用户 user_id。用户已提供完整 user_id 时原样使用，否则可从笔记搜索结果、商品评价、商品评价回复、笔记详情、标签页笔记列表、用户信息或用户发帖列表的 user_id/author.user_id 复制；如果只有主页链接，请使用 profile_url 入口；不要传小红书号、昵称或主页名称","title":"User Id"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Profile Url","description":"小红书用户主页链接。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌；只能用于同一用户的发帖列表，不能跨用户复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"}},"title":"InternalUserPostedNotesRequest","type":"object"},"example":{"user_id":"67c25fdc000000000a03dae1","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"BaseAuthorSummary":{"additionalProperties":false,"properties":{"user_id":{"description":"作者 user_id","title":"User Id","type":"string"},"name":{"description":"作者名称","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者头像链接；没有头像链接时为 null","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者主页链接；没有主页链接时为 null","title":"Profile Url"}},"required":["user_id","name","avatar_url","profile_url"],"title":"BaseAuthorSummary","type":"object"},"UserPostedNoteItem":{"additionalProperties":false,"properties":{"note_id":{"description":"小红书笔记 ID。必须原样使用完整 note_id；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。","title":"Note Id","type":"string"},"note_url":{"description":"笔记页面地址，不包含访问参数；可直接传给笔记详情、评论或口播转文字接口继续使用。","minLength":1,"title":"Note Url","type":"string"},"note_type":{"description":"笔记类型；当前公开值固定为 image 或 video","enum":["image","video"],"title":"Note Type","type":"string","x-socialdatax-enum-labels":{"image":"图文","video":"视频"}},"title":{"description":"笔记标题","title":"Title","type":"string"},"summary":{"description":"笔记摘要；不是全文","title":"Summary","type":"string"},"cover_image_url":{"description":"统一封面图","title":"Cover Image Url","type":"string"},"like_count":{"description":"点赞数","title":"Like Count","type":"integer"},"collect_count":{"description":"收藏数","title":"Collect Count","type":"integer"},"comment_count":{"description":"评论数","title":"Comment Count","type":"integer"},"share_count":{"description":"分享数","title":"Share Count","type":"integer"},"publish_time":{"description":"发布时间，秒级 Unix 时间戳","title":"Publish Time","type":"integer"},"update_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"更新时间，秒级 Unix 时间戳；没有有效更新时间时为 null","title":"Update Time"},"video":{"anyOf":[{"$ref":"#/$defs/UserPostedNoteVideo"},{"type":"null"}],"description":"视频摘要信息；仅视频笔记返回对象，图文为 null"},"author":{"$ref":"#/$defs/BaseAuthorSummary","description":"作者信息；用户发帖列表不返回小红书号"},"is_pinned":{"description":"是否为置顶笔记","title":"Is Pinned","type":"boolean"}},"required":["note_id","note_url","note_type","title","summary","cover_image_url","like_count","collect_count","comment_count","share_count","publish_time","update_time","video","author","is_pinned"],"title":"UserPostedNoteItem","type":"object"},"UserPostedNoteVideo":{"additionalProperties":false,"properties":{"video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"视频链接；没有视频链接时为 null","title":"Video Url"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频原始时长，单位毫秒；没有时长时为 null","title":"Duration Ms"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频宽度，像素；没有时为 null","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频高度，像素；没有时为 null","title":"Height"}},"required":["video_url","duration_ms","width","height"],"title":"UserPostedNoteVideo","type":"object"}},"additionalProperties":false,"properties":{"items":{"description":"当前页用户发帖摘要列表","items":{"$ref":"#/$defs/UserPostedNoteItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一用户的发帖列表，不能跨用户复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"UserPostedNotesResult","type":"object"},"example":{"items":[{"note_id":"69e71b110000000022029e5e","note_url":"https://www.xiaohongshu.com/explore/69e71b110000000022029e5e","note_type":"image","title":"露营装备清单","summary":"适合周末出行的装备组合。","cover_image_url":"https://example.invalid/cover.webp","like_count":120,"collect_count":35,"comment_count":18,"share_count":4,"publish_time":1714316800,"update_time":null,"video":null,"author":{"user_id":"67c25fdc000000000a03dae1","name":"露营研究员","avatar_url":"https://example.invalid/avatar.webp","profile_url":"https://www.xiaohongshu.com/user/profile/67c25fdc000000000a03dae1"},"is_pinned":false}],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["xhs_get_user_posted_notes_by_user_id","xhs_get_user_posted_notes_by_profile_url"]},{"operation_id":"xhs_get_note_comments","platform_id":"xhs","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/xhs/note/comment/list","summary":"读取小红书笔记一级评论","description":"按笔记 ID、笔记链接、短链接或分享文案读取公开一级评论，可通过 sort_type 设置评论排序，返回评论作者、内容类型、互动指标和下一页分页令牌。当前笔记不支持请求的排序时返回业务错误码 2001，并通过 available_sort_types 给出可用的公开排序值。","tags":["评论","小红书"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"note_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"小红书笔记 ID。已有完整 note_id 时原样使用，否则可从笔记搜索结果、笔记详情、评论、标签页笔记列表或用户发帖列表复制；不得截断、缩写或只传前缀","title":"Note Id"},"note_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Note Url","description":"小红书笔记链接、短链接或分享文案。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌；只能用于同一笔记和 sort_type 的一级评论列表，不能跨笔记或 sort_type 复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"},"sort_type":{"default":"default","description":"评论排序方式，可选：default（默认/综合排序）、time_descending（最新评论优先）、like_count_descending（点赞最多优先）","enum":["default","time_descending","like_count_descending"],"title":"Sort Type","type":"string","x-socialdatax-enum-labels":{"default":"默认/综合排序","time_descending":"最新评论优先","like_count_descending":"点赞最多优先"}}},"title":"InternalNoteCommentsRequest","type":"object"},"example":{"note_id":"69e71b110000000022029e5e","page_token":"","sort_type":"default"}},"response":{"content_type":"application/json","schema":{"$defs":{"AuthorSummary":{"properties":{"user_id":{"description":"作者 user_id","title":"User Id","type":"string"},"name":{"description":"作者名称","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者头像链接；没有头像链接时为 null","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者主页链接；没有主页链接时为 null","title":"Profile Url"},"red_id":{"description":"作者公开小红书号；没有小红书号时为空字符串","title":"Red Id","type":"string"}},"required":["user_id","name","avatar_url","profile_url","red_id"],"title":"AuthorSummary","type":"object"},"CommentImageItem":{"properties":{"image_url":{"description":"评论图片链接","title":"Image Url","type":"string"}},"required":["image_url"],"title":"CommentImageItem","type":"object"},"CommentMentionedUser":{"properties":{"user_id":{"description":"被 @ 用户的 user_id；没有用户 ID 时为空字符串","title":"User Id","type":"string"},"name":{"description":"被 @ 用户名称；没有用户名称时为空字符串","title":"Name","type":"string"}},"required":["user_id","name"],"title":"CommentMentionedUser","type":"object"},"CommentVoiceInfo":{"properties":{"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"语音时长，单位毫秒；没有时长时为 null","title":"Duration Ms"}},"required":["duration_ms"],"title":"CommentVoiceInfo","type":"object"},"NoteCommentItem":{"properties":{"comment_id":{"description":"评论 ID","title":"Comment Id","type":"string"},"note_id":{"description":"小红书笔记 ID。必须原样使用完整 note_id；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。","title":"Note Id","type":"string"},"content":{"description":"评论内容","title":"Content","type":"string"},"content_type":{"description":"评论内容类型，可选：text（文字）、image（图片）、voice（语音）","enum":["text","image","voice"],"title":"Content Type","type":"string","x-socialdatax-enum-labels":{"text":"文字","image":"图片","voice":"语音"}},"image_items":{"description":"评论图片列表；无图片时为空数组","items":{"$ref":"#/$defs/CommentImageItem"},"title":"Image Items","type":"array"},"voice_info":{"anyOf":[{"$ref":"#/$defs/CommentVoiceInfo"},{"type":"null"}],"description":"语音评论时长信息；非语音评论时为 null"},"voice_duration_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"兼容字段：语音评论时长，单位秒；非语音评论或没有时长时为 null","title":"Voice Duration Seconds"},"mentioned_users":{"description":"评论正文中 @ 到的用户列表；无 @ 时为空数组","items":{"$ref":"#/$defs/CommentMentionedUser"},"title":"Mentioned Users","type":"array"},"publish_time":{"description":"评论发布时间，秒级 Unix 时间戳","title":"Publish Time","type":"integer"},"like_count":{"description":"评论点赞数","title":"Like Count","type":"integer"},"reply_count":{"description":"评论回复数","title":"Reply Count","type":"integer"},"parent_comment_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"父评论 ID；一级评论通常为空","title":"Parent Comment Id"},"is_pinned":{"description":"评论是否置顶","title":"Is Pinned","type":"boolean"},"is_author_comment":{"description":"是否为笔记作者本人发布的评论","title":"Is Author Comment","type":"boolean"},"ip_location":{"description":"评论发布时的 IP 属地","title":"Ip Location","type":"string"},"author":{"$ref":"#/$defs/AuthorSummary","description":"评论作者信息"}},"required":["comment_id","note_id","content","content_type","image_items","voice_info","voice_duration_seconds","mentioned_users","publish_time","like_count","reply_count","parent_comment_id","is_pinned","is_author_comment","ip_location","author"],"title":"NoteCommentItem","type":"object"}},"properties":{"items":{"description":"当前页一级评论列表","items":{"$ref":"#/$defs/NoteCommentItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一笔记和 sort_type 的一级评论列表，不能跨笔记或 sort_type 复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。","title":"Next Page Token","type":"string"},"comment_count":{"description":"整篇笔记的总评论数，含一级评论与回复；不是当前页 items 数量","title":"Comment Count","type":"integer"},"top_level_comment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"整篇笔记的一级评论总数，不含回复；不是当前页 items 数量；无法获取时为 null","title":"Top Level Comment Count"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","comment_count","top_level_comment_count","points"],"title":"NoteCommentsResult","type":"object"},"example":{"items":[{"comment_id":"69e85611000000001401c821","note_id":"69e71b110000000022029e5e","content":"这个清单很实用。","content_type":"text","image_items":[],"voice_info":null,"voice_duration_seconds":null,"mentioned_users":[],"publish_time":1714316900,"like_count":8,"reply_count":2,"parent_comment_id":null,"is_pinned":false,"is_author_comment":false,"ip_location":"河南","author":{"user_id":"ae33373e21b0ef7d235fa646c95b7","name":"D.","avatar_url":"https://example.invalid/comment-avatar.webp","profile_url":null,"red_id":"8181415338"}}],"next_page_token":"","comment_count":18,"top_level_comment_count":12,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["xhs_get_note_comments_by_note_id","xhs_get_note_comments_by_note_url"]},{"operation_id":"xhs_get_note_sub_comments","platform_id":"xhs","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/xhs/note/comment/sub/list","summary":"读取小红书笔记二级评论","description":"按笔记 ID 和一级评论 ID 读取公开回复列表，返回评论结构和下一页分页令牌。","tags":["评论","小红书"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"note_id":{"description":"小红书笔记 ID。已有完整 note_id 时原样使用，否则可从笔记搜索结果、笔记详情、评论、标签页笔记列表或用户发帖列表复制；不得截断、缩写或只传前缀","title":"Note Id","type":"string"},"comment_id":{"title":"Comment Id","type":"string","description":"一级评论 ID。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌；只能用于同一 note_id 和 comment_id 的二级评论列表，不能跨笔记或一级评论复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"}},"required":["note_id","comment_id"],"title":"InternalNoteSubCommentsRequest","type":"object"},"example":{"note_id":"69e71b110000000022029e5e","comment_id":"69e85611000000001401c821","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"AuthorSummary":{"properties":{"user_id":{"description":"作者 user_id","title":"User Id","type":"string"},"name":{"description":"作者名称","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者头像链接；没有头像链接时为 null","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者主页链接；没有主页链接时为 null","title":"Profile Url"},"red_id":{"description":"作者公开小红书号；没有小红书号时为空字符串","title":"Red Id","type":"string"}},"required":["user_id","name","avatar_url","profile_url","red_id"],"title":"AuthorSummary","type":"object"},"CommentImageItem":{"properties":{"image_url":{"description":"评论图片链接","title":"Image Url","type":"string"}},"required":["image_url"],"title":"CommentImageItem","type":"object"},"CommentMentionedUser":{"properties":{"user_id":{"description":"被 @ 用户的 user_id；没有用户 ID 时为空字符串","title":"User Id","type":"string"},"name":{"description":"被 @ 用户名称；没有用户名称时为空字符串","title":"Name","type":"string"}},"required":["user_id","name"],"title":"CommentMentionedUser","type":"object"},"CommentVoiceInfo":{"properties":{"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"语音时长，单位毫秒；没有时长时为 null","title":"Duration Ms"}},"required":["duration_ms"],"title":"CommentVoiceInfo","type":"object"},"NoteCommentItem":{"properties":{"comment_id":{"description":"评论 ID","title":"Comment Id","type":"string"},"note_id":{"description":"小红书笔记 ID。必须原样使用完整 note_id；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。","title":"Note Id","type":"string"},"content":{"description":"评论内容","title":"Content","type":"string"},"content_type":{"description":"评论内容类型，可选：text（文字）、image（图片）、voice（语音）","enum":["text","image","voice"],"title":"Content Type","type":"string","x-socialdatax-enum-labels":{"text":"文字","image":"图片","voice":"语音"}},"image_items":{"description":"评论图片列表；无图片时为空数组","items":{"$ref":"#/$defs/CommentImageItem"},"title":"Image Items","type":"array"},"voice_info":{"anyOf":[{"$ref":"#/$defs/CommentVoiceInfo"},{"type":"null"}],"description":"语音评论时长信息；非语音评论时为 null"},"voice_duration_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"兼容字段：语音评论时长，单位秒；非语音评论或没有时长时为 null","title":"Voice Duration Seconds"},"mentioned_users":{"description":"评论正文中 @ 到的用户列表；无 @ 时为空数组","items":{"$ref":"#/$defs/CommentMentionedUser"},"title":"Mentioned Users","type":"array"},"publish_time":{"description":"评论发布时间，秒级 Unix 时间戳","title":"Publish Time","type":"integer"},"like_count":{"description":"评论点赞数","title":"Like Count","type":"integer"},"reply_count":{"description":"评论回复数","title":"Reply Count","type":"integer"},"parent_comment_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"父评论 ID；一级评论通常为空","title":"Parent Comment Id"},"is_pinned":{"description":"评论是否置顶","title":"Is Pinned","type":"boolean"},"is_author_comment":{"description":"是否为笔记作者本人发布的评论","title":"Is Author Comment","type":"boolean"},"ip_location":{"description":"评论发布时的 IP 属地","title":"Ip Location","type":"string"},"author":{"$ref":"#/$defs/AuthorSummary","description":"评论作者信息"}},"required":["comment_id","note_id","content","content_type","image_items","voice_info","voice_duration_seconds","mentioned_users","publish_time","like_count","reply_count","parent_comment_id","is_pinned","is_author_comment","ip_location","author"],"title":"NoteCommentItem","type":"object"}},"properties":{"items":{"description":"当前页二级评论列表","items":{"$ref":"#/$defs/NoteCommentItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一 note_id 和 comment_id 的二级评论列表，不能跨笔记或一级评论复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"NoteSubCommentsResult","type":"object"},"example":{"items":[{"comment_id":"69e829450000000014018c13","note_id":"69e71b110000000022029e5e","content":"同感，收藏了。","content_type":"text","image_items":[],"voice_info":null,"voice_duration_seconds":null,"mentioned_users":[],"publish_time":1714317000,"like_count":2,"reply_count":0,"parent_comment_id":"69e85611000000001401c821","is_pinned":false,"is_author_comment":false,"ip_location":"湖北","author":{"user_id":"ac6b05ef915d2f2b1bfb67c176475","name":"小微微💞","avatar_url":"https://example.invalid/comment-avatar-2.webp","profile_url":null,"red_id":"26752930781"}}],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["xhs_get_note_sub_comments_by_comment_id"]},{"operation_id":"xhs_get_topic_notes_by_page_id","platform_id":"xhs","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/xhs/topic/note/list","summary":"读取小红书标签页笔记列表","description":"按标签页链接 topic_url 或标签页 page_id 读取笔记列表，支持 page_token 与 sort_type，返回下一页分页令牌、总笔记数和总用户数。","tags":["标签页笔记","小红书"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"page_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"小红书标签页 page_id。","title":"Page Id"},"topic_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"小红书话题页链接、短链接或分享文案。支持以下形式：1) xiaohongshu.com/topic/normal/... 话题页长链；2) xhslink.com / xhslink.cn / xhsurl.com / xhsurl.cn 短链接；3) 包含上述任一链接的完整分享文案。","title":"Topic Url"},"page_token":{"default":"","description":"分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌，只绑定当前标签页和排序链路，不能跨 page_id 或排序复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。","title":"Page Token","type":"string"},"sort_type":{"default":"hot","description":"标签页笔记排序方式，可选：hot（最热，默认）、time_descending（最新）","enum":["hot","time_descending"],"title":"Sort Type","type":"string","x-socialdatax-enum-labels":{"hot":"最热","time_descending":"最新"}}},"title":"InternalTopicNotesRequest","type":"object"},"example":{"topic_url":"https://www.xiaohongshu.com/topic/normal/60e27aef15d4f70001dd8d7b","page_token":"","sort_type":"hot"}},"response":{"content_type":"application/json","schema":{"$defs":{"BaseAuthorSummary":{"additionalProperties":false,"properties":{"user_id":{"description":"作者 user_id","title":"User Id","type":"string"},"name":{"description":"作者名称","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者头像链接；没有头像链接时为 null","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者主页链接；没有主页链接时为 null","title":"Profile Url"}},"required":["user_id","name","avatar_url","profile_url"],"title":"BaseAuthorSummary","type":"object"},"SearchNoteVideo":{"additionalProperties":false,"properties":{"video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"视频链接；没有视频链接时为 null","title":"Video Url"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频原始时长，单位毫秒；没有时长时为 null","title":"Duration Ms"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频宽度，像素；没有时为 null","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频高度，像素；没有时为 null","title":"Height"}},"required":["video_url","duration_ms","width","height"],"title":"SearchNoteVideo","type":"object"},"TopicNoteImageItem":{"additionalProperties":false,"properties":{"image_url":{"description":"图片链接","title":"Image Url","type":"string"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片宽度，像素；没有时为 null","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片高度，像素；没有时为 null","title":"Height"}},"required":["image_url","width","height"],"title":"TopicNoteImageItem","type":"object"},"TopicNoteItem":{"additionalProperties":false,"properties":{"note_id":{"description":"小红书笔记 ID。必须原样使用完整 note_id；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。","title":"Note Id","type":"string"},"note_type":{"description":"笔记类型；当前公开值固定为 image 或 video","enum":["image","video"],"title":"Note Type","type":"string","x-socialdatax-enum-labels":{"image":"图文","video":"视频"}},"title":{"description":"笔记标题","title":"Title","type":"string"},"cover_image_url":{"description":"统一封面图","title":"Cover Image Url","type":"string"},"image_items":{"description":"图片列表；无图片时为空数组","items":{"$ref":"#/$defs/TopicNoteImageItem"},"title":"Image Items","type":"array"},"video":{"anyOf":[{"$ref":"#/$defs/SearchNoteVideo"},{"type":"null"}],"description":"视频摘要信息；视频笔记有可用视频摘要时返回对象，图文或无可用视频摘要时为 null"},"like_count":{"description":"点赞数","title":"Like Count","type":"integer"},"publish_time":{"description":"发布时间，秒级 Unix 时间戳","title":"Publish Time","type":"integer"},"author":{"$ref":"#/$defs/BaseAuthorSummary","description":"作者信息"}},"required":["note_id","note_type","title","cover_image_url","image_items","video","like_count","publish_time","author"],"title":"TopicNoteItem","type":"object"}},"additionalProperties":false,"properties":{"items":{"description":"标签页笔记列表","items":{"$ref":"#/$defs/TopicNoteItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；非空表示可尝试请求下一页，为空表示当前没有可继续的下一页令牌。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只绑定当前标签页和排序链路，不能跨 page_id 或排序复用；items 为空时不要单独据此判断结束；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。","title":"Next Page Token","type":"string"},"total_note_count":{"description":"标签页笔记总数","title":"Total Note Count","type":"integer"},"total_user_count":{"description":"标签页涉及用户总数","title":"Total User Count","type":"integer"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","total_note_count","total_user_count","points"],"title":"TopicNotesResult","type":"object"},"example":{"items":[{"note_id":"69e71b110000000022029e5e","note_type":"image","title":"露营地咖啡装备怎么带更省事","cover_image_url":"https://example.invalid/topic-cover.webp","image_items":[{"image_url":"https://example.invalid/topic-image.webp","width":1280,"height":1706}],"video":null,"like_count":120,"publish_time":1714316800,"author":{"user_id":"67c25fdc000000000a03dae1","name":"露营研究员","avatar_url":"https://example.invalid/avatar.webp","profile_url":"https://www.xiaohongshu.com/user/profile/67c25fdc000000000a03dae1"}}],"next_page_token":"opaque-topic-page-token","total_note_count":128,"total_user_count":96,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["xhs_get_topic_notes_by_topic_url","xhs_get_topic_notes_by_page_id"]}]},{"surface":"mcp","status":"available","endpoint":"https://mcp.socialdatax.com/xhs/mcp","authentication":{"required":true},"capabilities_resource":"xhs://guides/tool-capabilities","related_http_operation_ids":["xhs_get_search_hot_list","xhs_search_suggestions","xhs_search_notes","xhs_search_products","xhs_get_product_detail","xhs_get_product_reviews","xhs_get_note_detail","xhs_pgy_get_note_detail","xhs_get_user_info","xhs_get_user_posted_notes","xhs_get_note_comments","xhs_get_note_sub_comments","xhs_get_topic_notes_by_page_id"]}]},{"platform_id":"douyin","label":"抖音","english_label":"Douyin","status":"available","surfaces":[{"surface":"http","status":"available","base_path":"/socialdatax/api/v1/douyin","description":"公开 Douyin HTTP API 提供热榜、作品、评论和用户相关核心接口。","operations":[{"operation_id":"douyin_get_hot_search_list","platform_id":"douyin","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/douyin/hot/search/list","summary":"读取抖音主热榜","description":"读取抖音主热榜，返回排名、热点标题、分类标签、热度值、浏览量和封面图。","tags":["内容搜索","搜索热榜","抖音"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{},"title":"InternalHotSearchListRequest","type":"object"},"example":{}},"response":{"content_type":"application/json","schema":{"$defs":{"DouyinHotSearchItemData":{"properties":{"rank":{"description":"主热榜排名","title":"Rank","type":"integer"},"keyword":{"description":"热点标题或热榜词","title":"Keyword","type":"string"},"tag":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"热点分类标签；当前不可用时为 null","title":"Tag"},"hot_value":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"热度值；当前不可用时为 null","title":"Hot Value"},"view_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"浏览量；当前不可用时为 null","title":"View Count"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"热点封面图；当前不可用时为 null","title":"Cover Image Url"}},"required":["rank","keyword","tag","hot_value","view_count","cover_image_url"],"title":"DouyinHotSearchItemData","type":"object"}},"properties":{"hot_items":{"description":"抖音主热榜条目","items":{"$ref":"#/$defs/DouyinHotSearchItemData"},"title":"Hot Items","type":"array"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["hot_items","points"],"title":"DouyinHotSearchResult","type":"object"},"example":{"hot_items":[{"rank":1,"keyword":"露营","tag":"话题互动","hot_value":12214394,"view_count":61663400,"cover_image_url":"https://example.invalid/cover.webp"}],"points":{"cost":10,"balance":990}}},"related_mcp_tools":["douyin_get_hot_search_list"]},{"operation_id":"douyin_search_videos","platform_id":"douyin","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/douyin/video/search","summary":"搜索抖音作品","description":"按关键词和筛选条件搜索公开抖音作品，返回视频或图文作品摘要和下一页分页令牌。","tags":["内容搜索","抖音"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"keyword":{"title":"Keyword","type":"string","description":"搜索关键词。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"分页令牌。首次请求留空；继续翻页时使用上一次返回的 next_page_token。只能用于同一搜索链路，不能跨能力、关键词或筛选条件复用。"},"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"],"title":"Sort Type","type":"string","x-socialdatax-enum-labels":{"general":"综合","time_descending":"最新发布优先","like_count_descending":"最多点赞优先"}},"publish_time_range":{"default":"all","enum":["all","day","week","half_year"],"title":"Publish Time Range","type":"string","description":"发布时间范围筛选。","x-socialdatax-enum-labels":{"all":"不限","day":"一天内","week":"一周内","half_year":"半年内"}},"duration_range":{"default":"all","enum":["all","under_1_minute","one_to_five_minutes","over_5_minutes"],"title":"Duration Range","type":"string","description":"视频时长筛选。","x-socialdatax-enum-labels":{"all":"不限","under_1_minute":"1 分钟以下","one_to_five_minutes":"1-5 分钟","over_5_minutes":"5 分钟以上"}},"content_type":{"default":"all","enum":["all","video","image"],"title":"Content Type","type":"string","description":"内容形式筛选。","x-socialdatax-enum-labels":{"all":"不限","video":"视频","image":"图文"}}},"required":["keyword"],"title":"PublicSearchVideosRequest","type":"object"},"example":{"keyword":"露营","page_token":"","sort_type":"general","publish_time_range":"all","duration_range":"all","content_type":"all"}},"response":{"content_type":"application/json","schema":{"$defs":{"DouyinDetailImageData":{"properties":{"url":{"description":"图片展示资源链接；用于查看或分析图片内容","title":"Url","type":"string"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片宽度，像素；当前不可用时为 null","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片高度，像素；当前不可用时为 null","title":"Height"},"live_photo":{"anyOf":[{"$ref":"#/$defs/DouyinDetailLivePhotoData"},{"type":"null"}],"description":"图片动效视频资源；普通静态图片为 null，不表示作品主视频或背景音乐"}},"required":["url","width","height","live_photo"],"title":"DouyinDetailImageData","type":"object"},"DouyinDetailLivePhotoData":{"properties":{"play_url":{"description":"图片动效视频资源链接；用于还原图文作品中单张图片的动态效果，通常为 mp4","title":"Play Url","type":"string"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片动效视频资源时长，毫秒；当前不可用时为 null","title":"Duration Ms"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片动效视频资源宽度，像素；当前不可用时为 null","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片动效视频资源高度，像素；当前不可用时为 null","title":"Height"},"format":{"description":"图片动效视频资源格式，例如 mp4","title":"Format","type":"string"}},"required":["play_url","duration_ms","width","height","format"],"title":"DouyinDetailLivePhotoData","type":"object"},"DouyinDetailVideoData":{"properties":{"play_url":{"description":"抖音平台播放器资源链接；视频作品通常为 mp4，图文作品可能为音频播放资源；不同于作品页面或分享链接，不用于查询作品详情或评论","title":"Play Url","type":"string"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"播放器资源时长，毫秒；当前不可用时为 null","title":"Duration Ms"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"播放器资源宽度，像素；当前不可用时为 null","title":"Width"},"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","x-socialdatax-enum-labels":{"video":"视频","audio":"音频","unknown":"未知"}}},"required":["play_url","duration_ms","width","height","media_type"],"title":"DouyinDetailVideoData","type":"object"},"DouyinSearchItemData":{"properties":{"aweme_id":{"description":"作品 aweme_id","title":"Aweme Id","type":"string"},"content_type":{"description":"作品类型：video 表示视频，image 表示图文","enum":["video","image"],"title":"Content Type","type":"string","x-socialdatax-enum-labels":{"video":"视频","image":"图文"}},"description":{"description":"作品文案","title":"Description","type":"string"},"publish_time":{"description":"作品发布时间，秒级 Unix 时间戳","title":"Publish Time","type":"integer"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"封面图链接；当前不可用时为 null","title":"Cover Image Url"},"images":{"description":"图文图片资源列表；图文作品按顺序返回所有图片，视频作品为空数组","items":{"$ref":"#/$defs/DouyinDetailImageData"},"title":"Images","type":"array"},"video":{"anyOf":[{"$ref":"#/$defs/DouyinDetailVideoData"},{"type":"null"}],"description":"作品播放器资源；视频作品通常为视频，图文作品可能为音频播放资源"},"share_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作品页面或分享链接；可继续按 url 查询作品详情或评论；当前不可用时为 null","title":"Share Url"},"topic_tags":{"description":"作品话题标签列表；无话题标签时为空数组","items":{"$ref":"#/$defs/DouyinTopicTagData"},"title":"Topic Tags","type":"array"},"author":{"$ref":"#/$defs/DouyinUserSummaryData","description":"作品作者信息"},"like_count":{"description":"点赞数","title":"Like Count","type":"integer"},"comment_count":{"description":"评论数","title":"Comment Count","type":"integer"},"collect_count":{"description":"收藏数","title":"Collect Count","type":"integer"},"share_count":{"description":"分享数","title":"Share Count","type":"integer"}},"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"},"DouyinTopicTagData":{"additionalProperties":false,"properties":{"name":{"description":"话题标签名称","title":"Name","type":"string"},"id":{"description":"话题标签 ID；当前不可用时为空字符串","title":"Id","type":"string"}},"required":["name","id"],"title":"DouyinTopicTagData","type":"object"},"DouyinUserSummaryData":{"properties":{"user_id":{"description":"用户 user_id；当前不可用时为空字符串","title":"User Id","type":"string"},"sec_user_id":{"description":"用户 sec_user_id；当前不可用时为空字符串","title":"Sec User Id","type":"string"},"name":{"description":"用户昵称","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户头像链接；当前不可用时为 null","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户主页链接；当前不可用时为 null","title":"Profile Url"},"bio":{"description":"用户简介；当前不可用时为空字符串","title":"Bio","type":"string"},"verification_label":{"description":"用户认证文案；当前不可用时为空字符串","title":"Verification Label","type":"string"},"verified":{"description":"用户是否为认证账号","title":"Verified","type":"boolean"},"follower_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"粉丝数；当前不可用时为 null","title":"Follower Count"},"following_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"关注数；当前不可用时为 null","title":"Following Count"},"received_like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"用户内容累计收到的点赞数；当前不可用时为 null","title":"Received Like Count"}},"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"}},"properties":{"items":{"description":"当前页搜索结果中的作品列表","items":{"$ref":"#/$defs/DouyinSearchItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。只能用于同一搜索链路，不能跨能力、关键词或筛选条件复用。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"DouyinSearchResult","type":"object"},"example":{"items":[{"aweme_id":"7648208200076573925","content_type":"video","description":"我的露营入坑全过程 从露营小白到装备齐全，坑越来越大。你们是不是也正在入坑？\n#露营\n#露营装备 \n#露营入坑 \n#户外露营\n#露营报告","publish_time":1780737239,"cover_image_url":"https://example.invalid/cover.webp","images":[],"video":{"play_url":"https://example.invalid/douyin-video.mp4","duration_ms":289334,"width":1080,"height":1920,"media_type":"video"},"share_url":"https://www.douyin.com/video/7648208200076573925","topic_tags":[{"name":"露营","id":"1580532647418893"},{"name":"露营装备","id":"1629063161894920"},{"name":"露营入坑","id":"1725909323877464"},{"name":"户外露营","id":"1601409194763277"},{"name":"露营报告","id":"1706866801920072"}],"author":{"user_id":"1234567890","sec_user_id":"MS4wLjABAAAAVbcQXT1UykaJ9ceFzkeTICuowUGwD57JWzQTd5UjN2A","name":"社媒研究员","avatar_url":"https://example.invalid/avatar.webp","profile_url":"https://www.douyin.com/user/MS4wLjABAAAAVbcQXT1UykaJ9ceFzkeTICuowUGwD57JWzQTd5UjN2A","bio":"记录内容趋势和创作者案例。","verification_label":"","verified":false,"follower_count":12000,"following_count":80,"received_like_count":300000},"like_count":51740,"comment_count":6089,"collect_count":5483,"share_count":75290}],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["douyin_search_videos"]},{"operation_id":"douyin_search_users","platform_id":"douyin","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/douyin/user/search","summary":"搜索抖音用户","description":"按昵称、抖音号、账号名或达人名称搜索公开抖音用户，可按粉丝数量和认证类型筛选，返回用户摘要和下一页分页令牌。","tags":["用户搜索","抖音"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"keyword":{"description":"搜索词，可传昵称、抖音号、账号名、达人名称或创作者/博主名称；不用于搜索作品；不要传作品链接、用户主页链接、sec_user_id 或 page_token。","title":"Keyword","type":"string"},"page_token":{"default":"","description":"分页令牌。首次请求留空；继续翻页时使用上一次返回的完整 next_page_token。只能用于同一用户搜索链路，不能跨关键词或筛选条件复用。","title":"Page Token","type":"string"},"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 万以上）。","enum":["all","under_1k","1k_to_10k","10k_to_100k","100k_to_1m","over_1m"],"title":"Follower Count Range","type":"string"},"user_type":{"default":"all","description":"用户类型筛选，可选：all（不限，默认）、regular_user（普通用户）、enterprise_verified（企业认证）、individual_verified（个人认证）。","enum":["all","regular_user","enterprise_verified","individual_verified"],"title":"User Type","type":"string"}},"required":["keyword"],"title":"PublicSearchUsersRequest","type":"object"},"example":{"keyword":"露营","page_token":"","follower_count_range":"all","user_type":"all"}},"response":{"content_type":"application/json","schema":{"$defs":{"DouyinUserSearchItemData":{"properties":{"user_id":{"description":"用户 user_id；当前不可用时为空字符串","title":"User Id","type":"string"},"sec_user_id":{"description":"用户 sec_user_id；当前不可用时为空字符串","title":"Sec User Id","type":"string"},"name":{"description":"用户昵称","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户头像链接；当前不可用时为 null","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户主页链接；当前不可用时为 null","title":"Profile Url"},"bio":{"description":"用户简介；当前不可用时为空字符串","title":"Bio","type":"string"},"verification_label":{"description":"用户认证文案；当前不可用时为空字符串","title":"Verification Label","type":"string"},"verified":{"description":"用户是否为认证账号","title":"Verified","type":"boolean"},"follower_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"粉丝数；当前不可用时为 null","title":"Follower Count"},"following_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"关注数；当前不可用时为 null","title":"Following Count"},"received_like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"用户内容累计收到的点赞数；当前不可用时为 null","title":"Received Like Count"},"douyin_id":{"description":"用户主页展示的抖音号；当前不可用时为空字符串","title":"Douyin Id","type":"string"},"posted_content_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"用户已发布作品数量，包含视频、图文等作品；当前不可用时为 null","title":"Posted Content Count"}},"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"}},"properties":{"items":{"description":"当前页用户搜索结果列表","items":{"$ref":"#/$defs/DouyinUserSearchItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"DouyinUserSearchResult","type":"object"},"example":{"items":[{"user_id":"1234567890","sec_user_id":"MS4wLjABAAAAVbcQXT1UykaJ9ceFzkeTICuowUGwD57JWzQTd5UjN2A","douyin_id":"socialdatax-camping","name":"露营研究员","avatar_url":"https://example.invalid/avatar.webp","profile_url":"https://www.douyin.com/user/MS4wLjABAAAAVbcQXT1UykaJ9ceFzkeTICuowUGwD57JWzQTd5UjN2A","bio":"分享露营装备、路线和户外生活。","verification_label":"","verified":false,"follower_count":12000,"following_count":80,"received_like_count":300000,"posted_content_count":128}],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["douyin_search_users"]},{"operation_id":"douyin_search_products","platform_id":"douyin","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/douyin/product/search","summary":"搜索抖音商品","description":"按关键词搜索抖音全局搜索中的商品，支持稳定的排序、价格、物流服务、卖点和抖音旗舰筛选；返回包含商品 ID、SKU ID、价格、店铺和卡片来源的归一化商品列表与不透明分页令牌。该能力对应首页搜索进入商品页，不表示商城频道内完整搜索链路。","tags":["商品搜索","抖音"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"keyword":{"title":"Keyword","type":"string","description":"抖音商品搜索词，必填，去除首尾空白后不能为空；可传关键词或短语，例如“iPhone 16”或“露营桌”；keyword 只传搜索词，不要传商品链接、抖音平台对象 ID（如 sku_id、promotion_id、aweme_id、sec_user_id）或 page_token；不要把价格、排序或服务条件拼进 keyword，请使用对应筛选参数。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入。只能用于相同关键词、排序和筛选条件的商品搜索；翻页时 keyword、sort_type、min_price、max_price 及全部筛选参数必须与上一页保持一致。需要修改任一条件时，清空 page_token 后从第一页重新搜索。"},"sort_type":{"default":"general","enum":["general","sales_descending","price_ascending","price_descending"],"title":"Sort Type","type":"string","description":"商品排序：general（综合，默认）、sales_descending（销量降序）、price_ascending（价格升序）、price_descending（价格降序）。","x-socialdatax-enum-labels":{"general":"综合"}},"min_price":{"anyOf":[{"exclusiveMinimum":0,"type":"integer"},{"type":"null"}],"default":null,"title":"Min Price","description":"最低价格，正整数，单位：元；必须大于 0，不传表示不限；与 max_price 同时传入时不得大于 max_price。"},"max_price":{"anyOf":[{"exclusiveMinimum":0,"type":"integer"},{"type":"null"}],"default":null,"title":"Max Price","description":"最高价格，正整数，单位：元；必须大于 0，不传表示不限；与 min_price 同时传入时不得小于 min_price。"},"only_live":{"default":false,"title":"Only Live","type":"boolean","description":"true 时仅返回当前正在直播的商品（抖音原生筛选“直播中”）；false 表示不限（默认）。"},"dispatch_within_24h":{"default":false,"title":"Dispatch Within 24H","type":"boolean","description":"true 时仅返回支持 24 小时内发货的商品；false 表示不限（默认）。"},"shipping_insurance":{"default":false,"title":"Shipping Insurance","type":"boolean","description":"true 时仅返回支持运费险的商品；false 表示不限（默认）。"},"seven_day_return":{"default":false,"title":"Seven Day Return","type":"boolean","description":"true 时仅返回支持 7 天无理由退货的商品；false 表示不限（默认）。"},"selling_point":{"default":"all","enum":["all","high_sales","high_rating"],"title":"Selling Point","type":"string","description":"卖点筛选：all（不限，默认）、high_sales（月销过万）、high_rating（好评多）。"},"official_store":{"default":false,"title":"Official Store","type":"boolean","description":"true 时仅返回带“抖音旗舰”标识的商品；false 表示不限（默认）。"}},"required":["keyword"],"title":"PublicMallProductSearchRequest","type":"object"},"example":{"keyword":"露营","page_token":"","sort_type":"general","selling_point":"all"}},"response":{"content_type":"application/json","schema":{"$defs":{"DouyinMallSearchItemData":{"properties":{"product_id":{"description":"商品 ID；不要与当前商品卡对应的 sku_id 混用","title":"Product Id","type":"string"},"sku_id":{"description":"当前商品卡对应的规格 SKU ID","title":"Sku Id","type":"string"},"title":{"description":"商品标题","title":"Title","type":"string"},"image_url":{"description":"商品主图链接","title":"Image Url","type":"string"},"price":{"description":"商品卡展示价格，单位：元","title":"Price","type":"number"},"shop_id":{"description":"店铺 ID","title":"Shop Id","type":"string"},"card_type":{"description":"商品卡类型：product（普通商品）、video（视频商品）、live（直播商品）","enum":["product","video","live"],"title":"Card Type","type":"string"},"video_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"视频商品卡关联的视频 ID；card_type 不是 video 时为 null","title":"Video Id"},"live_room_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"直播商品卡关联的直播间 ID；card_type 不是 live 时为 null","title":"Live Room Id"}},"required":["product_id","sku_id","title","image_url","price","shop_id","card_type","video_id","live_room_id"],"title":"DouyinMallSearchItemData","type":"object"}},"properties":{"items":{"description":"当前页商品列表","items":{"$ref":"#/$defs/DouyinMallSearchItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"DouyinMallSearchResult","type":"object"},"example":{"items":[{"product_id":"3809228538935115995","sku_id":"3648420065728514","title":"DICHUN夏季小个子森系吊带碎花连衣裙两件套新款清冷系禅意衣服","image_url":"https://p3-aio.ecombdimg.com/obj/ecom-shop-material/jpeg_m_7c0004cb9ec0cd00aa0689d8bdb78afc_sx_520717_www1440-1928","price":308.0,"shop_id":"213374261","card_type":"product","video_id":null,"live_room_id":null},{"product_id":"3774502057764061666","sku_id":"3551662306714370","title":"Apple iPhone 17 Pro","image_url":"https://p26-item.ecombdimg.com/img/ecom-shop-material/jpeg_m_29ffd3b1d4e8e563526d0199226a3f3b_sx_104248_www1280-1280~tplv-5mmsx3fupr-resize:480:480.jpeg?biz_tag=ecom_search&s=PackSource_EcomSearch&sc=ecom_hybrid","price":8499.0,"shop_id":"233228908","card_type":"video","video_id":"7579235510779006208","live_room_id":null},{"product_id":"3675842076119007495","sku_id":"3400912136844802","title":"YSL圣罗兰彩妆套装恒久粉底液+粉饼定妆遮瑕控油 礼物 正品","image_url":"https://p26-item.ecombdimg.com/img/ecom-shop-material/jpeg_m_89f50b1254d41b4000ace82fb3431abf_sx_453652_www800-800~tplv-5mmsx3fupr-resize:480:480.jpeg?biz_tag=ecom_search&s=PackSource_EcomSearch&sc=ecom_hybrid","price":1266.0,"shop_id":"71868871","card_type":"live","video_id":null,"live_room_id":"7677738876055636771"}],"next_page_token":"opaque-douyin-product-search-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["douyin_search_products"]},{"operation_id":"douyin_get_video_detail","platform_id":"douyin","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/douyin/video/detail","summary":"读取抖音作品详情","description":"按 aweme_id 或作品链接读取公开抖音作品详情，返回文案、媒体资源、互动指标、音乐和作者信息。","tags":["内容详情","抖音"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"aweme_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Aweme Id","description":"抖音作品的数字 aweme_id；不要传作品链接、分享文案或带引号的字符串。"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Url","description":"抖音作品页面链接、作品短链接或包含作品链接的分享文案。"}},"title":"InternalVideoDetailRequest","type":"object"},"example":{"aweme_id":"7648208200076573925"}},"response":{"content_type":"application/json","schema":{"$defs":{"DouyinAuthorData":{"properties":{"user_id":{"description":"用户 user_id；当前不可用时为空字符串","title":"User Id","type":"string"},"sec_user_id":{"description":"用户 sec_user_id；当前不可用时为空字符串","title":"Sec User Id","type":"string"},"name":{"description":"用户昵称","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户头像链接；当前不可用时为 null","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户主页链接；当前不可用时为 null","title":"Profile Url"},"bio":{"description":"用户简介；当前不可用时为空字符串","title":"Bio","type":"string"},"verification_label":{"description":"用户认证文案；当前不可用时为空字符串","title":"Verification Label","type":"string"},"verified":{"description":"用户是否为认证账号","title":"Verified","type":"boolean"},"follower_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"粉丝数；当前不可用时为 null","title":"Follower Count"},"following_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"关注数；当前不可用时为 null","title":"Following Count"},"received_like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"用户内容累计收到的点赞数；当前不可用时为 null","title":"Received Like Count"},"douyin_id":{"description":"用户主页展示的抖音号；当前不可用时为空字符串","title":"Douyin Id","type":"string"}},"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"},"DouyinDetailImageData":{"properties":{"url":{"description":"图片展示资源链接；用于查看或分析图片内容","title":"Url","type":"string"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片宽度，像素；当前不可用时为 null","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片高度，像素；当前不可用时为 null","title":"Height"},"live_photo":{"anyOf":[{"$ref":"#/$defs/DouyinDetailLivePhotoData"},{"type":"null"}],"description":"图片动效视频资源；普通静态图片为 null，不表示作品主视频或背景音乐"}},"required":["url","width","height","live_photo"],"title":"DouyinDetailImageData","type":"object"},"DouyinDetailLivePhotoData":{"properties":{"play_url":{"description":"图片动效视频资源链接；用于还原图文作品中单张图片的动态效果，通常为 mp4","title":"Play Url","type":"string"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片动效视频资源时长，毫秒；当前不可用时为 null","title":"Duration Ms"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片动效视频资源宽度，像素；当前不可用时为 null","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片动效视频资源高度，像素；当前不可用时为 null","title":"Height"},"format":{"description":"图片动效视频资源格式，例如 mp4","title":"Format","type":"string"}},"required":["play_url","duration_ms","width","height","format"],"title":"DouyinDetailLivePhotoData","type":"object"},"DouyinDetailMusicData":{"properties":{"title":{"description":"作品绑定音乐或原声标题；当前不可用时为空字符串","title":"Title","type":"string"},"author":{"description":"音乐或原声作者；当前不可用时为空字符串","title":"Author","type":"string"},"play_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"音乐或原声播放链接；当前不可用时为 null","title":"Play Url"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"音乐或原声时长，毫秒；当前不可用时为 null","title":"Duration Ms"}},"required":["title","author","play_url","duration_ms"],"title":"DouyinDetailMusicData","type":"object"},"DouyinDetailVideoData":{"properties":{"play_url":{"description":"抖音平台播放器资源链接；视频作品通常为 mp4，图文作品可能为音频播放资源；不同于作品页面或分享链接，不用于查询作品详情或评论","title":"Play Url","type":"string"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"播放器资源时长，毫秒；当前不可用时为 null","title":"Duration Ms"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"播放器资源宽度，像素；当前不可用时为 null","title":"Width"},"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","x-socialdatax-enum-labels":{"video":"视频","audio":"音频","unknown":"未知"}}},"required":["play_url","duration_ms","width","height","media_type"],"title":"DouyinDetailVideoData","type":"object"},"DouyinMentionedUserData":{"properties":{"user_id":{"description":"被 @ 用户的 user_id","title":"User Id","type":"string"},"sec_user_id":{"description":"被 @ 用户的 sec_user_id；当前不可用时为空字符串","title":"Sec User Id","type":"string"},"name":{"description":"被 @ 用户昵称；当前不可用时为空字符串","title":"Name","type":"string"},"start":{"description":"@ 文本在原文中的起始位置","title":"Start","type":"integer"},"end":{"description":"@ 文本在原文中的结束位置","title":"End","type":"integer"}},"required":["user_id","sec_user_id","name","start","end"],"title":"DouyinMentionedUserData","type":"object"},"DouyinTopicTagData":{"additionalProperties":false,"properties":{"name":{"description":"话题标签名称","title":"Name","type":"string"},"id":{"description":"话题标签 ID；当前不可用时为空字符串","title":"Id","type":"string"}},"required":["name","id"],"title":"DouyinTopicTagData","type":"object"}},"properties":{"aweme_id":{"description":"作品 aweme_id","title":"Aweme Id","type":"string"},"content_type":{"description":"作品类型：video 表示视频，image 表示图文，unknown 表示未知","enum":["video","image","unknown"],"title":"Content Type","type":"string","x-socialdatax-enum-labels":{"video":"视频","image":"图文","unknown":"未知"}},"description":{"description":"作品文案","title":"Description","type":"string"},"publish_time":{"description":"作品发布时间，秒级 Unix 时间戳","title":"Publish Time","type":"integer"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作品封面图链接；当前不可用时为 null","title":"Cover Image Url"},"images":{"description":"作品图片展示资源列表；图文作品按顺序返回所有图片，视频作品为空数组","items":{"$ref":"#/$defs/DouyinDetailImageData"},"title":"Images","type":"array"},"video":{"anyOf":[{"$ref":"#/$defs/DouyinDetailVideoData"},{"type":"null"}],"description":"抖音平台播放器资源；视频作品为视频播放资源，图文作品可能为音频播放资源；无法可靠识别时为 null"},"music":{"anyOf":[{"$ref":"#/$defs/DouyinDetailMusicData"},{"type":"null"}],"description":"作品绑定音乐或原声资产；不表示视频播放时需要额外叠加播放；当前不可用时为 null"},"share_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作品页面/分享链接；可作为按 url 查询作品详情或评论时的输入；当前不可用时为 null","title":"Share Url"},"mentioned_users":{"description":"作品正文中 @ 到的用户列表；无 @ 时为空数组","items":{"$ref":"#/$defs/DouyinMentionedUserData"},"title":"Mentioned Users","type":"array"},"topic_tags":{"description":"作品话题标签列表；无话题标签时为空数组","items":{"$ref":"#/$defs/DouyinTopicTagData"},"title":"Topic Tags","type":"array"},"like_count":{"description":"作品点赞数","title":"Like Count","type":"integer"},"comment_count":{"description":"作品评论数","title":"Comment Count","type":"integer"},"collect_count":{"description":"作品收藏数","title":"Collect Count","type":"integer"},"share_count":{"description":"作品分享数","title":"Share Count","type":"integer"},"author":{"$ref":"#/$defs/DouyinAuthorData","description":"作品作者信息"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"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":"DouyinVideoDetailData","type":"object"},"example":{"aweme_id":"7648208200076573925","content_type":"video","description":"我的露营入坑全过程 从露营小白到装备齐全，坑越来越大。你们是不是也正在入坑？\n#露营\n#露营装备 \n#露营入坑 \n#户外露营\n#露营报告","publish_time":1780737239,"cover_image_url":"https://example.invalid/cover.webp","images":[],"video":{"play_url":"https://example.invalid/douyin-video.mp4","duration_ms":289334,"width":1080,"height":1920,"media_type":"video"},"share_url":"https://www.douyin.com/video/7648208200076573925","topic_tags":[{"name":"露营","id":"1580532647418893"},{"name":"露营装备","id":"1629063161894920"},{"name":"露营入坑","id":"1725909323877464"},{"name":"户外露营","id":"1601409194763277"},{"name":"露营报告","id":"1706866801920072"}],"author":{"user_id":"1234567890","sec_user_id":"MS4wLjABAAAAVbcQXT1UykaJ9ceFzkeTICuowUGwD57JWzQTd5UjN2A","douyin_id":"socialdatax-demo","name":"社媒研究员","avatar_url":"https://example.invalid/avatar.webp","profile_url":"https://www.douyin.com/user/MS4wLjABAAAAVbcQXT1UykaJ9ceFzkeTICuowUGwD57JWzQTd5UjN2A","bio":"记录内容趋势和创作者案例。","verification_label":"","verified":false,"follower_count":12000,"following_count":80,"received_like_count":300000},"like_count":51740,"comment_count":6089,"collect_count":5483,"share_count":75290,"mentioned_users":[],"music":{"title":"原声","author":"社媒研究员","play_url":"https://example.invalid/music.mp3","duration_ms":5000},"points":{"cost":10,"balance":990}}},"related_mcp_tools":["douyin_get_video_detail_by_aweme_id","douyin_get_video_detail_by_url"]},{"operation_id":"douyin_get_video_comments","platform_id":"douyin","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/douyin/video/comment/list","summary":"读取抖音作品一级评论","description":"按 aweme_id、作品链接、短链接或分享文案读取公开抖音作品一级评论，返回评论作者、内容类型、互动指标和下一页分页令牌。","tags":["评论","抖音"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"aweme_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Aweme Id","description":"抖音作品的数字 aweme_id；不要传作品链接、分享文案或带引号的字符串。"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Url","description":"抖音作品页面链接、作品短链接或包含作品链接的分享文案。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"分页令牌。首次请求留空；继续翻页时使用上一次返回的 next_page_token。"},"count":{"default":50,"minimum":1,"title":"Count","type":"integer"}},"title":"InternalVideoCommentsRequest","type":"object"},"example":{"aweme_id":"7648208200076573925","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"DouyinCommentAuthorData":{"properties":{"user_id":{"description":"评论作者 user_id；当前不可用时为空字符串","title":"User Id","type":"string"},"sec_user_id":{"description":"评论作者 sec_user_id；当前不可用时为空字符串","title":"Sec User Id","type":"string"},"douyin_id":{"description":"评论作者主页展示的抖音号；当前不可用时为空字符串","title":"Douyin Id","type":"string"},"name":{"description":"评论作者昵称","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"评论作者头像链接；当前不可用时为 null","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"评论作者主页链接；当前不可用时为 null","title":"Profile Url"},"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"},"DouyinCommentItem":{"properties":{"comment_id":{"description":"当前一级评论 ID","title":"Comment Id","type":"string"},"aweme_id":{"description":"作品 aweme_id","title":"Aweme 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","x-socialdatax-enum-labels":{"text":"文字","image":"图片","unknown":"未知","sticker":"表情或动图"}},"create_time":{"description":"评论发布时间，秒级 Unix 时间戳","title":"Create Time","type":"integer"},"like_count":{"description":"评论点赞数","title":"Like Count","type":"integer"},"reply_count":{"description":"评论回复数","title":"Reply Count","type":"integer"},"ip_location":{"description":"评论 IP 属地；当前不可用时为空字符串","title":"Ip Location","type":"string"},"image_urls":{"description":"评论图片链接列表；无图片时为空数组","items":{"type":"string"},"title":"Image Urls","type":"array"},"sticker":{"anyOf":[{"$ref":"#/$defs/DouyinCommentStickerData"},{"type":"null"}],"description":"评论表情或动图资源；无表情或动图时为 null"},"is_hot":{"description":"是否为热评","title":"Is Hot","type":"boolean"},"is_folded":{"description":"评论是否折叠","title":"Is Folded","type":"boolean"},"mentioned_users":{"description":"当前一级评论正文中 @ 到的用户列表；无 @ 时为空数组","items":{"$ref":"#/$defs/DouyinMentionedUserData"},"title":"Mentioned Users","type":"array"},"author":{"$ref":"#/$defs/DouyinCommentAuthorData","description":"评论作者信息"}},"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"},"DouyinCommentStickerData":{"properties":{"static_url":{"description":"表情或动图的静态预览图链接；不可用时为空字符串","title":"Static Url","type":"string"},"animated_url":{"description":"表情或动图的动态资源链接；不可用时为空字符串","title":"Animated Url","type":"string"}},"required":["static_url","animated_url"],"title":"DouyinCommentStickerData","type":"object"},"DouyinMentionedUserData":{"properties":{"user_id":{"description":"被 @ 用户的 user_id","title":"User Id","type":"string"},"sec_user_id":{"description":"被 @ 用户的 sec_user_id；当前不可用时为空字符串","title":"Sec User Id","type":"string"},"name":{"description":"被 @ 用户昵称；当前不可用时为空字符串","title":"Name","type":"string"},"start":{"description":"@ 文本在原文中的起始位置","title":"Start","type":"integer"},"end":{"description":"@ 文本在原文中的结束位置","title":"End","type":"integer"}},"required":["user_id","sec_user_id","name","start","end"],"title":"DouyinMentionedUserData","type":"object"}},"properties":{"items":{"description":"当前页一级评论列表","items":{"$ref":"#/$defs/DouyinCommentItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。","title":"Next Page Token","type":"string"},"comment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"作品评论总量；当前不可用时为 null","title":"Comment Count"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","comment_count","points"],"title":"DouyinVideoCommentsResult","type":"object"},"example":{"items":[{"comment_id":"7648330123242324788","aweme_id":"7648208200076573925","content":"这套露营装备清单很实用。","content_type":"text","create_time":1776935604,"like_count":91,"reply_count":8,"ip_location":"河北","image_urls":[],"sticker":null,"is_hot":true,"is_folded":false,"mentioned_users":[],"author":{"user_id":"2304997881289384","sec_user_id":"MS4wLjABAAAALynj49NNn56hWtVWVcPsfDfNnpMSC-LwECb-ChhQd4lRlQwduE3zeDvy4aj3YTyF","douyin_id":"a9246","name":"露营爱好者","avatar_url":"https://example.invalid/comment-avatar.webp","profile_url":"https://www.douyin.com/user/MS4wLjABAAAALynj49NNn56hWtVWVcPsfDfNnpMSC-LwECb-ChhQd4lRlQwduE3zeDvy4aj3YTyF","verification_label":"","verified":false}}],"next_page_token":"","comment_count":18,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["douyin_get_video_comments_by_aweme_id","douyin_get_video_comments_by_url"]},{"operation_id":"douyin_get_video_comment_replies","platform_id":"douyin","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/douyin/video/comment/reply/list","summary":"读取抖音评论回复","description":"按 aweme_id 和一级评论 ID 读取公开回复列表，返回评论结构和下一页分页令牌。","tags":["评论","抖音"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"aweme_id":{"title":"Aweme Id","type":"string","description":"抖音作品的数字 aweme_id；不要传作品链接、分享文案或带引号的字符串。"},"comment_id":{"title":"Comment Id","type":"string","description":"一级评论 ID。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"分页令牌。首次请求留空；继续翻页时使用上一次返回的 next_page_token。"}},"required":["aweme_id","comment_id"],"title":"InternalVideoCommentRepliesRequest","type":"object"},"example":{"aweme_id":"7648208200076573925","comment_id":"7648330123242324788","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"DouyinCommentAuthorData":{"properties":{"user_id":{"description":"评论作者 user_id；当前不可用时为空字符串","title":"User Id","type":"string"},"sec_user_id":{"description":"评论作者 sec_user_id；当前不可用时为空字符串","title":"Sec User Id","type":"string"},"douyin_id":{"description":"评论作者主页展示的抖音号；当前不可用时为空字符串","title":"Douyin Id","type":"string"},"name":{"description":"评论作者昵称","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"评论作者头像链接；当前不可用时为 null","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"评论作者主页链接；当前不可用时为 null","title":"Profile Url"},"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"},"DouyinCommentReplyItem":{"properties":{"comment_id":{"description":"当前评论回复自身 ID；不是读取回复时输入的一级评论 comment_id","title":"Comment Id","type":"string"},"aweme_id":{"description":"作品 aweme_id","title":"Aweme 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","x-socialdatax-enum-labels":{"text":"文字","image":"图片","unknown":"未知","sticker":"表情或动图"}},"create_time":{"description":"评论发布时间，秒级 Unix 时间戳","title":"Create Time","type":"integer"},"like_count":{"description":"评论点赞数","title":"Like Count","type":"integer"},"reply_count":{"description":"评论回复数","title":"Reply Count","type":"integer"},"ip_location":{"description":"评论 IP 属地；当前不可用时为空字符串","title":"Ip Location","type":"string"},"image_urls":{"description":"评论图片链接列表；无图片时为空数组","items":{"type":"string"},"title":"Image Urls","type":"array"},"sticker":{"anyOf":[{"$ref":"#/$defs/DouyinCommentStickerData"},{"type":"null"}],"description":"评论表情或动图资源；无表情或动图时为 null"},"is_hot":{"description":"是否为热评","title":"Is Hot","type":"boolean"},"is_folded":{"description":"评论是否折叠","title":"Is Folded","type":"boolean"},"author":{"$ref":"#/$defs/DouyinCommentAuthorData","description":"评论作者信息"}},"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"},"DouyinCommentStickerData":{"properties":{"static_url":{"description":"表情或动图的静态预览图链接；不可用时为空字符串","title":"Static Url","type":"string"},"animated_url":{"description":"表情或动图的动态资源链接；不可用时为空字符串","title":"Animated Url","type":"string"}},"required":["static_url","animated_url"],"title":"DouyinCommentStickerData","type":"object"}},"properties":{"items":{"description":"当前页评论回复列表","items":{"$ref":"#/$defs/DouyinCommentReplyItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。","title":"Next Page Token","type":"string"},"comment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该一级评论下的回复总量；当前不可用时为 null","title":"Comment Count"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","comment_count","points"],"title":"DouyinVideoCommentRepliesResult","type":"object"},"example":{"items":[{"comment_id":"7648884998297568037","aweme_id":"7648208200076573925","content":"想问下这套预算多少？","content_type":"text","create_time":1780894819,"like_count":7,"reply_count":0,"ip_location":"辽宁","image_urls":[],"sticker":null,"is_hot":false,"is_folded":false,"author":{"user_id":"93369089720","sec_user_id":"MS4wLjABAAAA95j6csjbjOqr1GOaVkelq3VBIn1R76TPruLZe-UvXqk","douyin_id":"364778165","name":"岩岩爱睡觉","avatar_url":"https://example.invalid/comment-avatar.webp","profile_url":"https://www.douyin.com/user/MS4wLjABAAAA95j6csjbjOqr1GOaVkelq3VBIn1R76TPruLZe-UvXqk","verification_label":"","verified":false}}],"next_page_token":"","comment_count":10,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["douyin_get_video_comment_replies_by_comment_id"]},{"operation_id":"douyin_get_user_info","platform_id":"douyin","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/douyin/user/info","summary":"读取抖音用户资料","description":"按 sec_user_id 或主页链接读取创作者公开资料、认证信息、公开互动规模和直播状态摘要；MCP 另提供按抖音号 douyin_id 查询资料的入口。","tags":["用户资料","抖音"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"sec_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Sec User Id","description":"抖音用户 sec_user_id，不透明标识；请传实际字段值，可从结果中的 sec_user_id 或 author.sec_user_id 复用；不要传公开抖音号 douyin_id、字段名或占位文本；只有主页链接时使用 profile_url 入口"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Profile Url","description":"抖音用户主页链接、用户短链接或用户分享文案；不要传作品链接。已知 sec_user_id 时优先使用 ID 入口。"}},"title":"InternalUserInfoRequest","type":"object"},"example":{"sec_user_id":"MS4wLjABAAAAVbcQXT1UykaJ9ceFzkeTICuowUGwD57JWzQTd5UjN2A"}},"response":{"content_type":"application/json","schema":{"$defs":{"DouyinUserLiveInfoData":{"properties":{"is_live":{"description":"用户当前是否正在直播","title":"Is Live","type":"boolean"},"room_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"直播间 ID；当前不可用时为 null","title":"Room Id"},"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"}},"required":["is_live","room_id","live_url","online_user_count"],"title":"DouyinUserLiveInfoData","type":"object"}},"properties":{"user_id":{"description":"用户 user_id；当前不可用时为空字符串","title":"User Id","type":"string"},"sec_user_id":{"description":"用户 sec_user_id；当前不可用时为空字符串","title":"Sec User Id","type":"string"},"name":{"description":"用户昵称","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户头像链接；当前不可用时为 null","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户主页链接；当前不可用时为 null","title":"Profile Url"},"bio":{"description":"用户简介；当前不可用时为空字符串","title":"Bio","type":"string"},"verification_label":{"description":"用户认证文案；当前不可用时为空字符串","title":"Verification Label","type":"string"},"verified":{"description":"用户是否为认证账号","title":"Verified","type":"boolean"},"follower_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"粉丝数；当前不可用时为 null","title":"Follower Count"},"following_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"关注数；当前不可用时为 null","title":"Following Count"},"received_like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"用户内容累计收到的点赞数；当前不可用时为 null","title":"Received Like Count"},"douyin_id":{"description":"用户主页展示的抖音号；当前不可用时为空字符串","title":"Douyin Id","type":"string"},"ip_location":{"description":"IP 属地；当前不可用时为空字符串","title":"Ip Location","type":"string"},"gender":{"description":"性别：male 表示男，female 表示女，unknown 表示未知","enum":["male","female","unknown"],"title":"Gender","type":"string","x-socialdatax-enum-labels":{"male":"男","female":"女","unknown":"未知"}},"posted_content_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"用户已发布作品数量，包含视频、图文等作品；当前不可用时为 null","title":"Posted Content Count"},"live_info":{"anyOf":[{"$ref":"#/$defs/DouyinUserLiveInfoData"},{"type":"null"}],"description":"用户直播状态摘要；用户当前未直播时为 null"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"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"},"example":{"user_id":"1234567890","sec_user_id":"MS4wLjABAAAAVbcQXT1UykaJ9ceFzkeTICuowUGwD57JWzQTd5UjN2A","douyin_id":"socialdatax-demo","name":"社媒研究员","avatar_url":"https://example.invalid/avatar.webp","profile_url":"https://www.douyin.com/user/MS4wLjABAAAAVbcQXT1UykaJ9ceFzkeTICuowUGwD57JWzQTd5UjN2A","bio":"记录内容趋势和创作者案例。","verification_label":"","verified":false,"follower_count":12000,"following_count":80,"received_like_count":300000,"ip_location":"上海","gender":"unknown","posted_content_count":128,"live_info":null,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["douyin_get_user_info_by_sec_user_id","douyin_get_user_info_by_douyin_id","douyin_get_user_info_by_profile_url"]},{"operation_id":"douyin_get_user_posted_videos","platform_id":"douyin","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/douyin/user/video/list","summary":"读取抖音用户作品列表","description":"按 sec_user_id 或主页链接读取创作者已发布作品摘要列表，支持分页令牌。","tags":["用户内容","抖音"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"sec_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Sec User Id","description":"抖音用户 sec_user_id，不透明标识；请传实际字段值，可从结果中的 sec_user_id 或 author.sec_user_id 复用；不要传公开抖音号 douyin_id、字段名或占位文本；只有主页链接时使用 profile_url 入口"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Profile Url","description":"抖音用户主页链接、用户短链接或用户分享文案；不要传作品链接。已知 sec_user_id 时优先使用 ID 入口。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"分页令牌。首次请求留空；继续翻页时使用上一次返回的 next_page_token。"}},"title":"InternalUserPostedVideosRequest","type":"object"},"example":{"sec_user_id":"MS4wLjABAAAAVbcQXT1UykaJ9ceFzkeTICuowUGwD57JWzQTd5UjN2A","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"DouyinAuthorData":{"properties":{"user_id":{"description":"用户 user_id；当前不可用时为空字符串","title":"User Id","type":"string"},"sec_user_id":{"description":"用户 sec_user_id；当前不可用时为空字符串","title":"Sec User Id","type":"string"},"name":{"description":"用户昵称","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户头像链接；当前不可用时为 null","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户主页链接；当前不可用时为 null","title":"Profile Url"},"bio":{"description":"用户简介；当前不可用时为空字符串","title":"Bio","type":"string"},"verification_label":{"description":"用户认证文案；当前不可用时为空字符串","title":"Verification Label","type":"string"},"verified":{"description":"用户是否为认证账号","title":"Verified","type":"boolean"},"follower_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"粉丝数；当前不可用时为 null","title":"Follower Count"},"following_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"关注数；当前不可用时为 null","title":"Following Count"},"received_like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"用户内容累计收到的点赞数；当前不可用时为 null","title":"Received Like Count"},"douyin_id":{"description":"用户主页展示的抖音号；当前不可用时为空字符串","title":"Douyin Id","type":"string"}},"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"},"DouyinDetailImageData":{"properties":{"url":{"description":"图片展示资源链接；用于查看或分析图片内容","title":"Url","type":"string"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片宽度，像素；当前不可用时为 null","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片高度，像素；当前不可用时为 null","title":"Height"},"live_photo":{"anyOf":[{"$ref":"#/$defs/DouyinDetailLivePhotoData"},{"type":"null"}],"description":"图片动效视频资源；普通静态图片为 null，不表示作品主视频或背景音乐"}},"required":["url","width","height","live_photo"],"title":"DouyinDetailImageData","type":"object"},"DouyinDetailLivePhotoData":{"properties":{"play_url":{"description":"图片动效视频资源链接；用于还原图文作品中单张图片的动态效果，通常为 mp4","title":"Play Url","type":"string"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片动效视频资源时长，毫秒；当前不可用时为 null","title":"Duration Ms"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片动效视频资源宽度，像素；当前不可用时为 null","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片动效视频资源高度，像素；当前不可用时为 null","title":"Height"},"format":{"description":"图片动效视频资源格式，例如 mp4","title":"Format","type":"string"}},"required":["play_url","duration_ms","width","height","format"],"title":"DouyinDetailLivePhotoData","type":"object"},"DouyinDetailVideoData":{"properties":{"play_url":{"description":"抖音平台播放器资源链接；视频作品通常为 mp4，图文作品可能为音频播放资源；不同于作品页面或分享链接，不用于查询作品详情或评论","title":"Play Url","type":"string"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"播放器资源时长，毫秒；当前不可用时为 null","title":"Duration Ms"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"播放器资源宽度，像素；当前不可用时为 null","title":"Width"},"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","x-socialdatax-enum-labels":{"video":"视频","audio":"音频","unknown":"未知"}}},"required":["play_url","duration_ms","width","height","media_type"],"title":"DouyinDetailVideoData","type":"object"},"DouyinTopicTagData":{"additionalProperties":false,"properties":{"name":{"description":"话题标签名称","title":"Name","type":"string"},"id":{"description":"话题标签 ID；当前不可用时为空字符串","title":"Id","type":"string"}},"required":["name","id"],"title":"DouyinTopicTagData","type":"object"},"DouyinUserPostedItemData":{"properties":{"aweme_id":{"description":"作品 aweme_id","title":"Aweme Id","type":"string"},"content_type":{"description":"作品类型：video 表示视频，image 表示图文，unknown 表示未知","enum":["video","image","unknown"],"title":"Content Type","type":"string","x-socialdatax-enum-labels":{"video":"视频","image":"图文","unknown":"未知"}},"description":{"description":"作品文案","title":"Description","type":"string"},"publish_time":{"description":"作品发布时间，秒级 Unix 时间戳","title":"Publish Time","type":"integer"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"封面图链接；当前不可用时为 null","title":"Cover Image Url"},"images":{"description":"图文图片资源列表；图文作品按顺序返回所有图片，视频作品为空数组","items":{"$ref":"#/$defs/DouyinDetailImageData"},"title":"Images","type":"array"},"video":{"anyOf":[{"$ref":"#/$defs/DouyinDetailVideoData"},{"type":"null"}],"description":"作品播放器资源；视频作品通常为视频，图文作品可能为音频播放资源"},"share_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作品页面或分享链接；可继续按 url 查询作品详情或评论；当前不可用时为 null","title":"Share Url"},"topic_tags":{"description":"作品话题标签列表；无话题标签时为空数组","items":{"$ref":"#/$defs/DouyinTopicTagData"},"title":"Topic Tags","type":"array"},"author":{"$ref":"#/$defs/DouyinAuthorData","description":"作品作者信息"},"like_count":{"description":"点赞数","title":"Like Count","type":"integer"},"comment_count":{"description":"评论数","title":"Comment Count","type":"integer"},"collect_count":{"description":"收藏数","title":"Collect Count","type":"integer"},"share_count":{"description":"分享数","title":"Share Count","type":"integer"}},"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"}},"properties":{"items":{"description":"当前页作品列表","items":{"$ref":"#/$defs/DouyinUserPostedItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"DouyinUserPostedResult","type":"object"},"example":{"items":[{"aweme_id":"7648208200076573925","content_type":"video","description":"我的露营入坑全过程 从露营小白到装备齐全，坑越来越大。你们是不是也正在入坑？\n#露营\n#露营装备 \n#露营入坑 \n#户外露营\n#露营报告","publish_time":1780737239,"cover_image_url":"https://example.invalid/cover.webp","images":[],"video":{"play_url":"https://example.invalid/douyin-video.mp4","duration_ms":289334,"width":1080,"height":1920,"media_type":"video"},"share_url":"https://www.douyin.com/video/7648208200076573925","topic_tags":[{"name":"露营","id":"1580532647418893"},{"name":"露营装备","id":"1629063161894920"},{"name":"露营入坑","id":"1725909323877464"},{"name":"户外露营","id":"1601409194763277"},{"name":"露营报告","id":"1706866801920072"}],"author":{"user_id":"1234567890","sec_user_id":"MS4wLjABAAAAVbcQXT1UykaJ9ceFzkeTICuowUGwD57JWzQTd5UjN2A","douyin_id":"socialdatax-demo","name":"社媒研究员","avatar_url":"https://example.invalid/avatar.webp","profile_url":"https://www.douyin.com/user/MS4wLjABAAAAVbcQXT1UykaJ9ceFzkeTICuowUGwD57JWzQTd5UjN2A","bio":"记录内容趋势和创作者案例。","verification_label":"","verified":false,"follower_count":12000,"following_count":80,"received_like_count":300000},"like_count":51740,"comment_count":6089,"collect_count":5483,"share_count":75290}],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["douyin_get_user_posted_videos_by_sec_user_id","douyin_get_user_posted_videos_by_profile_url"]},{"operation_id":"douyin_get_user_series","platform_id":"douyin","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/douyin/user/series/list","summary":"读取抖音用户短剧列表","description":"按 sec_user_id 或主页链接读取创作者短剧列表，支持分页令牌。","tags":["用户内容","抖音"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"sec_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Sec User Id","description":"抖音用户 sec_user_id，不透明标识；请传实际字段值，可从结果中的 sec_user_id 或 author.sec_user_id 复用；不要传公开抖音号 douyin_id、字段名或占位文本；只有主页链接时使用 profile_url 入口"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Profile Url","description":"抖音用户主页链接、用户短链接或用户分享文案；不要传作品链接。已知 sec_user_id 时优先使用 ID 入口。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"分页令牌。首次请求留空；继续翻页时使用上一次返回的 next_page_token。"}},"title":"InternalUserSeriesRequest","type":"object"},"example":{"sec_user_id":"MS4wLjABAAAAeTw694TE8HsvvitqbV3ot9pqHh6n6MThBKz2pECOOn4","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"DouyinAuthorData":{"properties":{"user_id":{"description":"用户 user_id；当前不可用时为空字符串","title":"User Id","type":"string"},"sec_user_id":{"description":"用户 sec_user_id；当前不可用时为空字符串","title":"Sec User Id","type":"string"},"name":{"description":"用户昵称","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户头像链接；当前不可用时为 null","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户主页链接；当前不可用时为 null","title":"Profile Url"},"bio":{"description":"用户简介；当前不可用时为空字符串","title":"Bio","type":"string"},"verification_label":{"description":"用户认证文案；当前不可用时为空字符串","title":"Verification Label","type":"string"},"verified":{"description":"用户是否为认证账号","title":"Verified","type":"boolean"},"follower_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"粉丝数；当前不可用时为 null","title":"Follower Count"},"following_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"关注数；当前不可用时为 null","title":"Following Count"},"received_like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"用户内容累计收到的点赞数；当前不可用时为 null","title":"Received Like Count"},"douyin_id":{"description":"用户主页展示的抖音号；当前不可用时为空字符串","title":"Douyin Id","type":"string"}},"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"},"DouyinSeriesItemData":{"properties":{"series_id":{"description":"短剧 ID","title":"Series Id","type":"string"},"title":{"description":"短剧标题","title":"Title","type":"string"},"description":{"description":"短剧简介；当前不可用时为空字符串","title":"Description","type":"string"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"短剧封面图链接；当前不可用时为 null","title":"Cover Image Url"},"share_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"短剧页面或分享链接；当前不可用时为 null","title":"Share Url"},"create_time":{"description":"短剧创建时间，秒级 Unix 时间戳","title":"Create Time","type":"integer"},"update_time":{"description":"短剧更新时间，秒级 Unix 时间戳","title":"Update Time","type":"integer"},"play_count":{"description":"播放数","title":"Play Count","type":"integer"},"collect_count":{"description":"收藏数","title":"Collect Count","type":"integer"},"total_episode_count":{"description":"总集数","title":"Total Episode Count","type":"integer"},"updated_episode_count":{"description":"已更新到的集数","title":"Updated Episode Count","type":"integer"},"author":{"$ref":"#/$defs/DouyinAuthorData","description":"短剧作者信息"}},"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"}},"properties":{"items":{"description":"当前页短剧列表","items":{"$ref":"#/$defs/DouyinSeriesItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"DouyinUserSeriesResult","type":"object"},"example":{"items":[{"series_id":"7586639947990468642","title":"短剧 · 断悬案，平匪患，叫我八岁小青天","description":"李图前世是经验丰富的老刑侦，破过无数大案，一不小心，居然穿越到了古代，成为了一个年仅八岁的九品芝麻官。","cover_image_url":"https://example.invalid/series-cover.webp","share_url":"https://www.iesdouyin.com/share/playlet/detail/7586639947990468642/","create_time":1766402262,"update_time":1775268426,"play_count":1000,"collect_count":20,"total_episode_count":78,"updated_episode_count":53,"author":{"user_id":"1234567890","sec_user_id":"MS4wLjABAAAAeTw694TE8HsvvitqbV3ot9pqHh6n6MThBKz2pECOOn4","douyin_id":"socialdatax-demo","name":"龙帅短剧","avatar_url":"https://example.invalid/avatar.webp","profile_url":"https://www.douyin.com/user/MS4wLjABAAAAeTw694TE8HsvvitqbV3ot9pqHh6n6MThBKz2pECOOn4","bio":"上门退婚被当乞丐羞辱，转身让豪门跪着把婚书粘好！","verification_label":"","verified":false,"follower_count":12000,"following_count":80,"received_like_count":300000}}],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["douyin_get_user_series_by_sec_user_id","douyin_get_user_series_by_profile_url"]}]},{"surface":"mcp","status":"available","endpoint":"https://mcp.socialdatax.com/douyin/mcp","authentication":{"required":true},"capabilities_resource":"douyin://guides/tool-capabilities","related_http_operation_ids":["douyin_get_hot_search_list","douyin_search_videos","douyin_search_users","douyin_search_products","douyin_get_video_detail","douyin_get_video_comments","douyin_get_video_comment_replies","douyin_get_user_info","douyin_get_user_posted_videos","douyin_get_user_series"]}]},{"platform_id":"tiktok","label":"TikTok","english_label":"TikTok","status":"available","surfaces":[{"surface":"http","status":"available","base_path":"/socialdatax/api/v1/tiktok","description":"公开 TikTok HTTP API 提供作品搜索、作品详情、作品一级评论、评论回复、作者信息和用户作品列表；搜索可返回视频和图片作品，支持 content_type 筛选和 page_token 分页；详情按搜索结果 share_url 或作品页面链接读取；评论可按 post_id 或作品页面链接读取，回复按 post_id、一级评论 comment_id 与 page_token 分页读取；作者信息和用户作品列表可按 tiktok_id 或用户主页链接读取。","operations":[{"operation_id":"tiktok_search_posts","platform_id":"tiktok","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/tiktok/post/search","summary":"搜索 TikTok 作品","description":"按关键词搜索 TikTok 公开作品，可返回视频和图片作品，可用 content_type 筛选作品类型，过滤用户卡片等非作品结果，并返回当前搜索链路的下一页分页令牌。","tags":["作品搜索","视频作品","图片作品","TikTok"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"keyword":{"description":"搜索词，可传关键词或短语，例如品牌名、话题、人物名或产品名；不要传作品链接、用户主页链接、post_id、tiktok_id 或 page_token。","title":"Keyword","type":"string"},"page_token":{"default":"","description":"分页令牌。首页传空字符串；next_page_token 为空字符串表示没有更多结果。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；它是不透明令牌，不能修改、截断、脱敏、格式化、重组，也不能跨关键词、筛选条件或不同请求链路复用。","title":"Page Token","type":"string"},"content_type":{"default":"all","description":"作品类型筛选：all 不限作品类型，可返回视频和图片作品；video 只返回视频作品；image 只返回图片作品。继续翻页时必须保持同一 content_type。","enum":["all","video","image"],"title":"Content Type","type":"string","x-socialdatax-enum-labels":{"all":"不限作品类型","video":"视频作品","image":"图片作品"}}},"required":["keyword"],"title":"TikTokPostSearchRequest","type":"object"},"example":{"keyword":"camping","content_type":"all","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"TikTokPostSearchAuthorData":{"properties":{"user_id":{"description":"TikTok 用户 ID；长数字字符串，原样保留，不要转为数字；当前不可用时为空字符串；仅作为作者数字标识返回，不要用它代替 author.tiktok_id 或 author.profile_url","title":"User Id","type":"string"},"tiktok_id":{"description":"TikTok 号，即用户主页 @ 后的标识；当前不可用时为空字符串，为空时不要作为用户标识使用","title":"Tiktok Id","type":"string"},"name":{"description":"用户昵称；当前不可用时为空字符串","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户头像资源链接；可能随时间失效；当前不可用时为 null；不作为用户标识使用","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户主页链接；当前不可用时为 null","title":"Profile Url"},"bio":{"description":"用户简介；当前不可用时为空字符串","title":"Bio","type":"string"},"verified":{"description":"用户是否为认证账号；false 表示未认证或当前不可用","title":"Verified","type":"boolean"}},"required":["user_id","tiktok_id","name","avatar_url","profile_url","bio","verified"],"title":"TikTokPostSearchAuthorData","type":"object"},"TikTokPostSearchImageData":{"properties":{"url":{"description":"图片资源链接；可能随时间失效；不是作品页面链接","title":"Url","type":"string"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片宽度，像素；当前不可用时为 null","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片高度，像素；当前不可用时为 null","title":"Height"}},"required":["url","width","height"],"title":"TikTokPostSearchImageData","type":"object"},"TikTokPostSearchItemData":{"properties":{"post_id":{"description":"TikTok 作品 ID；长数字字符串，原样保留，不要转为数字；content_type=video 的 post_id 标识视频作品；content_type=image 的 post_id 标识图片作品，不能作为视频作品 ID 使用","title":"Post Id","type":"string"},"content_type":{"description":"作品类型：video 表示视频作品，image 表示图片作品","enum":["video","image"],"title":"Content Type","type":"string","x-socialdatax-enum-labels":{"video":"视频作品","image":"图片作品"}},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作品标题；图片作品可能有标题，视频作品或当前不可用时为 null","title":"Title"},"description":{"description":"作品文案；没有文案或当前不可用时为空字符串","title":"Description","type":"string"},"publish_time":{"description":"发布时间，秒级 Unix 时间戳；当前不可用时为 0","title":"Publish Time","type":"integer"},"share_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"TikTok 作品页面链接；视频作品为视频页面链接，图片作品为图片作品页面链接；不要把 content_type=image 的 share_url 当作视频页面链接；当前不可用时为 null","title":"Share Url"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作品封面图片资源链接；可能随时间失效；不是作品页面链接或播放资源链接；当前不可用时为 null","title":"Cover Image Url"},"video":{"anyOf":[{"$ref":"#/$defs/TikTokPostSearchVideoData"},{"type":"null"}],"description":"视频播放资源；图片作品或当前不可用时为 null"},"images":{"description":"图片作品的图片资源列表；视频作品为空数组","items":{"$ref":"#/$defs/TikTokPostSearchImageData"},"title":"Images","type":"array"},"music":{"anyOf":[{"$ref":"#/$defs/TikTokPostSearchMusicData"},{"type":"null"}],"description":"作品音乐；当前不可用时为 null"},"topic_tags":{"description":"作品话题标签列表；name 不含 #；topic_id 当前仅作为结果标识返回，不要用 topic_id 代替话题名称","items":{"$ref":"#/$defs/TikTokTopicTagData"},"title":"Topic Tags","type":"array"},"author":{"$ref":"#/$defs/TikTokPostSearchAuthorData","description":"作品作者信息"},"play_count":{"description":"播放/浏览数；当前不可用时为 0","title":"Play Count","type":"integer"},"like_count":{"description":"点赞数；当前不可用时为 0","title":"Like Count","type":"integer"},"comment_count":{"description":"评论数；当前不可用时为 0","title":"Comment Count","type":"integer"},"collect_count":{"description":"收藏数；当前不可用时为 0","title":"Collect Count","type":"integer"},"share_count":{"description":"分享数；当前不可用时为 0","title":"Share Count","type":"integer"}},"required":["post_id","content_type","title","description","publish_time","share_url","cover_image_url","video","images","music","topic_tags","author","play_count","like_count","comment_count","collect_count","share_count"],"title":"TikTokPostSearchItemData","type":"object"},"TikTokPostSearchMusicData":{"properties":{"music_id":{"description":"音乐 ID；长数字字符串，原样保留，不要转为数字；当前仅作为作品音乐标识返回","title":"Music Id","type":"string"},"title":{"description":"音乐标题；当前不可用时为空字符串","title":"Title","type":"string"},"author":{"description":"音乐作者；当前不可用时为空字符串","title":"Author","type":"string"},"play_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"音乐播放资源链接；可能随时间失效；当前不可用时为 null；不要把 play_url 当作音乐 ID 使用","title":"Play Url"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"音乐时长，毫秒；当前不可用时为 null","title":"Duration Ms"}},"required":["music_id","title","author","play_url","duration_ms"],"title":"TikTokPostSearchMusicData","type":"object"},"TikTokPostSearchVideoData":{"properties":{"play_url":{"description":"视频播放资源链接；不是作品页面链接；可能随时间失效；如果不可用，外层 video 为 null","title":"Play Url","type":"string"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频时长，毫秒；当前不可用时为 null","title":"Duration Ms"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频宽度，像素；当前不可用时为 null","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频高度，像素；当前不可用时为 null","title":"Height"}},"required":["play_url","duration_ms","width","height"],"title":"TikTokPostSearchVideoData","type":"object"},"TikTokTopicTagData":{"properties":{"topic_id":{"description":"话题标签 ID；当前不可用时为空字符串","title":"Topic Id","type":"string"},"name":{"description":"话题标签名称","title":"Name","type":"string"}},"required":["topic_id","name"],"title":"TikTokTopicTagData","type":"object"}},"properties":{"items":{"description":"当前页 TikTok 作品搜索结果，已过滤用户卡片等非作品结果；当前页可能为空，是否继续翻页以 next_page_token 是否为空为准","items":{"$ref":"#/$defs/TikTokPostSearchItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"分页令牌。首页传空字符串；next_page_token 为空字符串表示没有更多结果。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；它是不透明令牌，不能修改、截断、脱敏、格式化、重组，也不能跨关键词、筛选条件或不同请求链路复用。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"TikTokPostSearchResult","type":"object"},"example":{"items":[{"post_id":"7663928331536026911","content_type":"video","title":null,"description":"Weekend camping gear checklist and campsite setup tips ⛺ #camping #outdoor","publish_time":1784397388,"share_url":"https://www.tiktok.com/@campinglife/video/7663928331536026911","cover_image_url":"https://example.invalid/cover.jpeg","video":{"play_url":"https://example.invalid/video.mp4","duration_ms":38000,"width":720,"height":1280},"images":[],"music":{"music_id":"7663928300263312159","title":"original sound","author":"Camping Life","play_url":"https://example.invalid/music.mp3","duration_ms":38000},"topic_tags":[{"topic_id":"12744","name":"camping"},{"topic_id":"7131","name":"gear"},{"topic_id":"4288486","name":"outdoor"}],"author":{"user_id":"134941634731003904","tiktok_id":"campinglife","name":"Camping Life","avatar_url":"https://example.invalid/avatar.jpeg","profile_url":"https://www.tiktok.com/@campinglife","bio":"Weekend camping routes, gear checklists and outdoor tips.","verified":true},"play_count":528700,"like_count":63100,"comment_count":610,"collect_count":2286,"share_count":1633},{"post_id":"7659631064435969310","content_type":"image","title":"Campsite setup inspiration 🌴🔥","description":"#camping #outdoor","publish_time":1783396846,"share_url":"https://www.tiktok.com/@outdoorideas/photo/7659631064435969310","cover_image_url":"https://example.invalid/image-cover.jpeg","video":null,"images":[{"url":"https://example.invalid/image-1.jpeg","width":1600,"height":2000},{"url":"https://example.invalid/image-2.jpeg","width":1668,"height":2084}],"music":{"music_id":"7532547317401569296","title":"Campfire Morning","author":"Outdoor Ideas","play_url":"https://example.invalid/music.mp3","duration_ms":172000},"topic_tags":[{"topic_id":"4862173","name":"camping"},{"topic_id":"3953","name":"campsite"},{"topic_id":"29658","name":"outdoor"}],"author":{"user_id":"6663294979903422470","tiktok_id":"outdoorideas","name":"Outdoor Ideas","avatar_url":"https://example.invalid/outdoor-avatar.jpeg","profile_url":"https://www.tiktok.com/@outdoorideas","bio":"Camping setups and outdoor inspiration.","verified":true},"play_count":456900,"like_count":70400,"comment_count":351,"collect_count":2301,"share_count":2741}],"next_page_token":"opaque-tiktok-post-search-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["tiktok_search_posts"]},{"operation_id":"tiktok_get_post_detail","platform_id":"tiktok","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/tiktok/post/detail","summary":"读取 TikTok 作品详情","description":"按 tiktok_search_posts 返回的 share_url，或 TikTok 作品页面链接读取作品详情；视频和图片作品均返回作者、媒体、互动和话题信息。","tags":["详情","作品","TikTok"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"url":{"description":"TikTok 作品页面链接，例如 https://www.tiktok.com/@user/video/123 或 https://www.tiktok.com/@user/photo/123；视频和图片作品均可返回详情，不要用 post_id 代替 url","title":"Url","type":"string"}},"required":["url"],"title":"TikTokPostDetailRequest","type":"object"},"example":{"url":"https://www.tiktok.com/@teamtrump/video/7640149043431214350"}},"response":{"content_type":"application/json","schema":{"$defs":{"TikTokPostSearchAuthorData":{"properties":{"user_id":{"description":"TikTok 用户 ID；长数字字符串，原样保留，不要转为数字；当前不可用时为空字符串；仅作为作者数字标识返回，不要用它代替 author.tiktok_id 或 author.profile_url","title":"User Id","type":"string"},"tiktok_id":{"description":"TikTok 号，即用户主页 @ 后的标识；当前不可用时为空字符串，为空时不要作为用户标识使用","title":"Tiktok Id","type":"string"},"name":{"description":"用户昵称；当前不可用时为空字符串","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户头像资源链接；可能随时间失效；当前不可用时为 null；不作为用户标识使用","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户主页链接；当前不可用时为 null","title":"Profile Url"},"bio":{"description":"用户简介；当前不可用时为空字符串","title":"Bio","type":"string"},"verified":{"description":"用户是否为认证账号；false 表示未认证或当前不可用","title":"Verified","type":"boolean"}},"required":["user_id","tiktok_id","name","avatar_url","profile_url","bio","verified"],"title":"TikTokPostSearchAuthorData","type":"object"},"TikTokPostSearchImageData":{"properties":{"url":{"description":"图片资源链接；可能随时间失效；不是作品页面链接","title":"Url","type":"string"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片宽度，像素；当前不可用时为 null","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片高度，像素；当前不可用时为 null","title":"Height"}},"required":["url","width","height"],"title":"TikTokPostSearchImageData","type":"object"},"TikTokPostSearchMusicData":{"properties":{"music_id":{"description":"音乐 ID；长数字字符串，原样保留，不要转为数字；当前仅作为作品音乐标识返回","title":"Music Id","type":"string"},"title":{"description":"音乐标题；当前不可用时为空字符串","title":"Title","type":"string"},"author":{"description":"音乐作者；当前不可用时为空字符串","title":"Author","type":"string"},"play_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"音乐播放资源链接；可能随时间失效；当前不可用时为 null；不要把 play_url 当作音乐 ID 使用","title":"Play Url"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"音乐时长，毫秒；当前不可用时为 null","title":"Duration Ms"}},"required":["music_id","title","author","play_url","duration_ms"],"title":"TikTokPostSearchMusicData","type":"object"},"TikTokPostSearchVideoData":{"properties":{"play_url":{"description":"视频播放资源链接；不是作品页面链接；可能随时间失效；如果不可用，外层 video 为 null","title":"Play Url","type":"string"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频时长，毫秒；当前不可用时为 null","title":"Duration Ms"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频宽度，像素；当前不可用时为 null","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频高度，像素；当前不可用时为 null","title":"Height"}},"required":["play_url","duration_ms","width","height"],"title":"TikTokPostSearchVideoData","type":"object"},"TikTokTopicTagData":{"properties":{"topic_id":{"description":"话题标签 ID；当前不可用时为空字符串","title":"Topic Id","type":"string"},"name":{"description":"话题标签名称","title":"Name","type":"string"}},"required":["topic_id","name"],"title":"TikTokTopicTagData","type":"object"}},"properties":{"post_id":{"description":"TikTok 作品 ID；长数字字符串，原样保留，不要转为数字；content_type=video 时标识视频作品；content_type=image 的 post_id 标识图片作品，不能作为视频作品 ID 使用","title":"Post Id","type":"string"},"content_type":{"description":"作品类型：video 表示视频作品，image 表示图片作品","enum":["video","image"],"title":"Content Type","type":"string","x-socialdatax-enum-labels":{"video":"视频作品","image":"图片作品"}},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作品标题；图片作品可能有标题，视频作品或当前不可用时为 null","title":"Title"},"description":{"description":"作品文案；没有文案或当前不可用时为空字符串","title":"Description","type":"string"},"publish_time":{"description":"发布时间，秒级 Unix 时间戳；当前不可用时为 0","title":"Publish Time","type":"integer"},"share_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"TikTok 作品页面链接；视频作品为视频页面链接，图片作品为图片作品页面链接；不要把 content_type=image 的 share_url 当作视频页面链接；当前不可用时为 null","title":"Share Url"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作品封面图片资源链接；可能随时间失效；不是作品页面链接或播放资源链接；当前不可用时为 null","title":"Cover Image Url"},"video":{"anyOf":[{"$ref":"#/$defs/TikTokPostSearchVideoData"},{"type":"null"}],"description":"视频播放资源；图片作品或当前不可用时为 null"},"images":{"description":"图片作品的图片资源列表；视频作品为空数组","items":{"$ref":"#/$defs/TikTokPostSearchImageData"},"title":"Images","type":"array"},"music":{"anyOf":[{"$ref":"#/$defs/TikTokPostSearchMusicData"},{"type":"null"}],"description":"作品音乐；当前不可用时为 null"},"topic_tags":{"description":"作品话题标签列表；name 不含 #；topic_id 当前仅作为结果标识返回，不要用 topic_id 代替话题名称","items":{"$ref":"#/$defs/TikTokTopicTagData"},"title":"Topic Tags","type":"array"},"author":{"$ref":"#/$defs/TikTokPostSearchAuthorData","description":"作品作者信息"},"play_count":{"description":"播放/浏览数；当前不可用时为 0","title":"Play Count","type":"integer"},"like_count":{"description":"点赞数；当前不可用时为 0","title":"Like Count","type":"integer"},"comment_count":{"description":"评论数；当前不可用时为 0","title":"Comment Count","type":"integer"},"collect_count":{"description":"收藏数；当前不可用时为 0","title":"Collect Count","type":"integer"},"share_count":{"description":"分享数；当前不可用时为 0","title":"Share Count","type":"integer"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["post_id","content_type","title","description","publish_time","share_url","cover_image_url","video","images","music","topic_tags","author","play_count","like_count","comment_count","collect_count","share_count","points"],"title":"TikTokPostDetailData","type":"object"},"example":{"post_id":"7640149043431214350","content_type":"video","title":null,"description":"Nice place! #donaldtrump #china #fyp","publish_time":1778860855,"share_url":"https://www.tiktok.com/@teamtrump/video/7640149043431214350","cover_image_url":"https://example.invalid/video-cover.jpeg","video":{"play_url":"https://example.invalid/video.mp4","duration_ms":8000,"width":720,"height":1280},"images":[],"music":{"music_id":"7420633921946782469","title":"INTERESTELLAR","author":"Kore Blanco","play_url":null,"duration_ms":73000},"topic_tags":[{"topic_id":"28492","name":"donaldtrump"},{"topic_id":"5873","name":"china"},{"topic_id":"229207","name":"fyp"}],"author":{"user_id":"7365161718782395438","tiktok_id":"teamtrump","name":"Team Trump","avatar_url":null,"profile_url":"https://www.tiktok.com/@teamtrump","bio":"The official TikTok page for the Trump Campaign","verified":true},"play_count":4800000,"like_count":121100,"comment_count":2740,"collect_count":6752,"share_count":3073,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["tiktok_get_post_detail_by_url"]},{"operation_id":"tiktok_get_post_comments","platform_id":"tiktok","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/tiktok/post/comment/list","summary":"读取 TikTok 作品一级评论","description":"按作品 post_id 或 TikTok 作品页面链接读取公开一级评论，必须且只能传其中一个；返回评论作者、图片附件、互动指标和下一页分页令牌。","tags":["评论","TikTok"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"post_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"TikTok 作品 post_id；用户已提供时直接使用，否则可使用 tiktok_search_posts 返回的 content_type=video 或 image 的 post_id；读取评论回复时也可使用评论列表 items[*].post_id；长数字字符串，原样传入，不要转为数字","title":"Post Id"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"TikTok 作品页面链接；可直接使用 tiktok_search_posts 返回的 content_type=video 或 image 的 share_url","title":"Url"},"page_token":{"default":"","description":"分页令牌。首页传空字符串；next_page_token 为空字符串表示没有更多结果。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；它是不透明令牌，不能修改、截断、脱敏、格式化、重组，也不能跨关键词、筛选条件或不同请求链路复用。","title":"Page Token","type":"string"}},"title":"TikTokPostCommentsRequest","type":"object"},"example":{"post_id":"7640149043431214350","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"TikTokCommentAuthorData":{"properties":{"user_id":{"description":"评论作者 user_id；当前不可用时为空字符串","title":"User Id","type":"string"},"tiktok_id":{"description":"评论作者 TikTok 号，即用户主页 @ 后的标识；当前不可用时为空字符串","title":"Tiktok Id","type":"string"},"name":{"description":"评论作者昵称；当前不可用时为空字符串","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"评论作者头像链接；当前不可用时为 null","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"评论作者主页链接；当前不可用时为 null","title":"Profile Url"}},"required":["user_id","tiktok_id","name","avatar_url","profile_url"],"title":"TikTokCommentAuthorData","type":"object"},"TikTokCommentItemData":{"properties":{"comment_id":{"description":"一级评论 ID；可作为评论回复工具 tiktok_get_post_comment_replies 的 comment_id 输入","title":"Comment Id","type":"string"},"post_id":{"description":"TikTok 作品 post_id；可和同一项 comment_id 一起读取评论回复；长数字字符串，原样保留，不要转为数字","title":"Post Id","type":"string"},"content":{"description":"评论内容；带图片附件的评论可能为空字符串","title":"Content","type":"string"},"publish_time":{"description":"评论发布时间，秒级 Unix 时间戳；当前不可用时为 0","title":"Publish Time","type":"integer"},"like_count":{"description":"评论点赞数","title":"Like Count","type":"integer"},"reply_count":{"description":"评论回复数","title":"Reply Count","type":"integer"},"image_urls":{"description":"评论图片链接列表；无图片时为空数组","items":{"type":"string"},"title":"Image Urls","type":"array"},"author":{"$ref":"#/$defs/TikTokCommentAuthorData","description":"评论作者信息"}},"required":["comment_id","post_id","content","publish_time","like_count","reply_count","image_urls","author"],"title":"TikTokCommentItemData","type":"object"}},"properties":{"items":{"description":"当前页一级评论列表","items":{"$ref":"#/$defs/TikTokCommentItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"分页令牌。首页传空字符串；next_page_token 为空字符串表示没有更多结果。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；它是不透明令牌，不能修改、截断、脱敏、格式化、重组，也不能跨关键词、筛选条件或不同请求链路复用。","title":"Next Page Token","type":"string"},"comment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"作品评论总量；当前不可用时为 null","title":"Comment Count"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","comment_count","points"],"title":"TikTokPostCommentsResult","type":"object"},"example":{"items":[{"comment_id":"7640183598754906901","post_id":"7640149043431214350","content":"China is so beautiful","publish_time":1778868881,"like_count":2445,"reply_count":83,"image_urls":[],"author":{"user_id":"7246053518283375622","tiktok_id":"amandabrettcrypto","name":"amandabrettcrypto","avatar_url":"https://example.invalid/avatar.jpeg","profile_url":"https://www.tiktok.com/@amandabrettcrypto"}}],"next_page_token":"opaque-tiktok-post-comments-page-token","comment_count":2712,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["tiktok_get_post_comments_by_post_id","tiktok_get_post_comments_by_url"]},{"operation_id":"tiktok_get_post_comment_replies","platform_id":"tiktok","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/tiktok/post/comment/reply/list","summary":"读取 TikTok 评论回复","description":"按同一作品 post_id 和一级评论 comment_id 读取评论回复，支持分页。回复项的 parent_comment_id 表示所属一级评论，reply_to_comment_id 只在回复某条二级评论时返回；直接回复一级评论时为 null。","tags":["评论回复","TikTok"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"post_id":{"description":"TikTok 作品 post_id；用户已提供时直接使用，否则可使用 tiktok_search_posts 返回的 content_type=video 或 image 的 post_id；读取评论回复时也可使用评论列表 items[*].post_id；长数字字符串，原样传入，不要转为数字","title":"Post Id","type":"string"},"comment_id":{"description":"TikTok 一级评论的数字 comment_id；用户已提供时直接使用，否则来自评论列表 items[*].comment_id；长数字字符串，原样传入，不要转为数字","title":"Comment Id","type":"string"},"page_token":{"default":"","description":"分页令牌。首页传空字符串；next_page_token 为空字符串表示没有更多结果。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；它是不透明令牌，不能修改、截断、脱敏、格式化、重组，也不能跨关键词、筛选条件或不同请求链路复用。","title":"Page Token","type":"string"}},"required":["post_id","comment_id"],"title":"TikTokPostCommentRepliesRequest","type":"object"},"example":{"post_id":"7640149043431214350","comment_id":"7640183598754906901","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"TikTokCommentAuthorData":{"properties":{"user_id":{"description":"评论作者 user_id；当前不可用时为空字符串","title":"User Id","type":"string"},"tiktok_id":{"description":"评论作者 TikTok 号，即用户主页 @ 后的标识；当前不可用时为空字符串","title":"Tiktok Id","type":"string"},"name":{"description":"评论作者昵称；当前不可用时为空字符串","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"评论作者头像链接；当前不可用时为 null","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"评论作者主页链接；当前不可用时为 null","title":"Profile Url"}},"required":["user_id","tiktok_id","name","avatar_url","profile_url"],"title":"TikTokCommentAuthorData","type":"object"},"TikTokCommentReplyItemData":{"properties":{"comment_id":{"description":"评论回复自身的 comment_id；不是输入里的一级评论 comment_id；不要作为评论回复入口","title":"Comment Id","type":"string"},"post_id":{"description":"TikTok 作品 post_id；长数字字符串，原样保留，不要转为数字","title":"Post Id","type":"string"},"parent_comment_id":{"description":"所属一级评论 ID；等于本次读取回复时传入的一级评论 comment_id","title":"Parent Comment Id","type":"string"},"reply_to_comment_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"被回复的二级评论 ID；直接回复一级评论时为 null","title":"Reply To Comment Id"},"content":{"description":"评论回复内容；带图片附件的评论回复可能为空字符串","title":"Content","type":"string"},"publish_time":{"description":"评论回复发布时间，秒级 Unix 时间戳；当前不可用时为 0","title":"Publish Time","type":"integer"},"like_count":{"description":"评论回复点赞数","title":"Like Count","type":"integer"},"image_urls":{"description":"评论回复图片链接列表；无图片时为空数组","items":{"type":"string"},"title":"Image Urls","type":"array"},"author":{"$ref":"#/$defs/TikTokCommentAuthorData","description":"评论回复作者信息"}},"required":["comment_id","post_id","parent_comment_id","reply_to_comment_id","content","publish_time","like_count","image_urls","author"],"title":"TikTokCommentReplyItemData","type":"object"}},"properties":{"items":{"description":"当前页评论回复列表","items":{"$ref":"#/$defs/TikTokCommentReplyItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"分页令牌。首页传空字符串；next_page_token 为空字符串表示没有更多结果。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；它是不透明令牌，不能修改、截断、脱敏、格式化、重组，也不能跨关键词、筛选条件或不同请求链路复用。","title":"Next Page Token","type":"string"},"reply_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该一级评论的回复总量；当前不可用时为 null","title":"Reply Count"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","reply_count","points"],"title":"TikTokPostCommentRepliesResult","type":"object"},"example":{"items":[{"comment_id":"7640239580138717966","post_id":"7640149043431214350","parent_comment_id":"7640183598754906901","reply_to_comment_id":null,"content":"Welcome","publish_time":1778881925,"like_count":71,"image_urls":[],"author":{"user_id":"7640236131136783374","tiktok_id":"simin96","name":"Simin","avatar_url":"https://example.invalid/avatar.jpeg","profile_url":"https://www.tiktok.com/@simin96"}}],"next_page_token":"opaque-tiktok-post-comment-replies-page-token","reply_count":102,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["tiktok_get_post_comment_replies"]},{"operation_id":"tiktok_get_user_info","platform_id":"tiktok","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/tiktok/user/info","summary":"读取 TikTok 用户资料","description":"按 TikTok 号或用户主页链接读取公开资料和互动统计，必须且只能传其中一个。","tags":["用户信息","creator profiles","TikTok"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"description":"请求体必须且只能传 tiktok_id 或 profile_url 其中一个。","properties":{"tiktok_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"TikTok 号，即用户主页 @ 后的标识；可直接使用搜索、详情、评论或评论回复结果中 author.tiktok_id 的值；不要带 @，不要传用户主页链接","title":"Tiktok Id"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"TikTok 用户主页链接，例如 https://www.tiktok.com/@teamtrump","title":"Profile Url"}},"title":"TikTokUserInfoRequest","type":"object"},"example":{"tiktok_id":"teamtrump"}},"response":{"content_type":"application/json","schema":{"properties":{"user_id":{"description":"TikTok 用户 ID；长数字字符串，原样保留，不要转为数字；当前不可用时为空字符串；不要用它代替 tiktok_id 或 profile_url","title":"User Id","type":"string"},"tiktok_id":{"description":"TikTok 号，即用户主页 @ 后的标识；当前不可用时为空字符串，为空时不要作为用户标识使用","title":"Tiktok Id","type":"string"},"name":{"description":"用户昵称；当前不可用时为空字符串","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户头像链接；当前不可用时为 null","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户主页链接；当前不可用时为 null","title":"Profile Url"},"bio":{"description":"用户简介；当前不可用时为空字符串","title":"Bio","type":"string"},"verified":{"description":"用户是否为认证账号","title":"Verified","type":"boolean"},"private_account":{"description":"用户账号是否为私密账号","title":"Private Account","type":"boolean"},"follower_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"粉丝数；当前不可用时为 null","title":"Follower Count"},"following_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"关注数；当前不可用时为 null","title":"Following Count"},"received_like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"用户作品累计获赞数；当前不可用时为 null","title":"Received Like Count"},"posted_content_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"用户已发布作品数；当前不可用时为 null","title":"Posted Content Count"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["user_id","tiktok_id","name","avatar_url","profile_url","bio","verified","private_account","follower_count","following_count","received_like_count","posted_content_count","points"],"title":"TikTokUserInfoData","type":"object"},"example":{"user_id":"7365161718782395438","tiktok_id":"teamtrump","name":"Team Trump","avatar_url":null,"profile_url":"https://www.tiktok.com/@teamtrump","bio":"The official TikTok page for the Trump Campaign","verified":true,"private_account":false,"follower_count":13900000,"following_count":2,"received_like_count":375500000,"posted_content_count":1236,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["tiktok_get_user_info_by_tiktok_id","tiktok_get_user_info_by_profile_url"]},{"operation_id":"tiktok_get_user_posts","platform_id":"tiktok","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/tiktok/user/post/list","summary":"读取 TikTok 用户作品","description":"按 TikTok 号或用户主页链接读取公开作品列表，必须且只能传其中一个；返回作品列表项和下一页分页令牌。","tags":["用户作品","creator posts","视频列表","TikTok"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"description":"请求体必须且只能传 tiktok_id 或 profile_url 其中一个。","properties":{"tiktok_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"TikTok 号，即用户主页 @ 后的标识；可直接使用搜索、详情、评论或评论回复结果中 author.tiktok_id 的值；不要带 @，不要传用户主页链接","title":"Tiktok Id"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"TikTok 用户主页链接，例如 https://www.tiktok.com/@teamtrump","title":"Profile Url"},"page_token":{"default":"","description":"分页令牌。首页传空字符串；next_page_token 为空字符串表示没有更多结果。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；它是不透明令牌，不能修改、截断、脱敏、格式化、重组，也不能跨关键词、筛选条件或不同请求链路复用。","title":"Page Token","type":"string"}},"title":"TikTokUserPostsRequest","type":"object"},"example":{"tiktok_id":"iamurhope","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"TikTokPostSearchAuthorData":{"properties":{"user_id":{"description":"TikTok 用户 ID；长数字字符串，原样保留，不要转为数字；当前不可用时为空字符串；仅作为作者数字标识返回，不要用它代替 author.tiktok_id 或 author.profile_url","title":"User Id","type":"string"},"tiktok_id":{"description":"TikTok 号，即用户主页 @ 后的标识；当前不可用时为空字符串，为空时不要作为用户标识使用","title":"Tiktok Id","type":"string"},"name":{"description":"用户昵称；当前不可用时为空字符串","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户头像资源链接；可能随时间失效；当前不可用时为 null；不作为用户标识使用","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户主页链接；当前不可用时为 null","title":"Profile Url"},"bio":{"description":"用户简介；当前不可用时为空字符串","title":"Bio","type":"string"},"verified":{"description":"用户是否为认证账号；false 表示未认证或当前不可用","title":"Verified","type":"boolean"}},"required":["user_id","tiktok_id","name","avatar_url","profile_url","bio","verified"],"title":"TikTokPostSearchAuthorData","type":"object"},"TikTokTopicTagData":{"properties":{"topic_id":{"description":"话题标签 ID；当前不可用时为空字符串","title":"Topic Id","type":"string"},"name":{"description":"话题标签名称","title":"Name","type":"string"}},"required":["topic_id","name"],"title":"TikTokTopicTagData","type":"object"},"TikTokUserPostItemData":{"properties":{"post_id":{"description":"TikTok 作品 post_id；长数字字符串，原样保留，不要转为数字","title":"Post Id","type":"string"},"description":{"description":"作品文案","title":"Description","type":"string"},"publish_time":{"description":"发布时间，秒级 Unix 时间戳","title":"Publish Time","type":"integer"},"share_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作品页面链接；当前不可用时为 null","title":"Share Url"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作品封面图片资源链接；可能随时间失效；不是作品页面链接或播放资源链接；当前不可用时为 null","title":"Cover Image Url"},"play_count":{"description":"播放数","title":"Play Count","type":"integer"},"like_count":{"description":"点赞数","title":"Like Count","type":"integer"},"comment_count":{"description":"评论数","title":"Comment Count","type":"integer"},"collect_count":{"description":"收藏数","title":"Collect Count","type":"integer"},"share_count":{"description":"分享数","title":"Share Count","type":"integer"},"author":{"$ref":"#/$defs/TikTokPostSearchAuthorData","description":"作者信息"},"video":{"anyOf":[{"$ref":"#/$defs/TikTokUserPostVideoData"},{"type":"null"}],"description":"视频资源；当前不可用时为 null"},"music":{"anyOf":[{"$ref":"#/$defs/TikTokUserPostMusicData"},{"type":"null"}],"description":"作品音乐；当前不可用时为 null"},"topic_tags":{"description":"作品话题标签列表","items":{"$ref":"#/$defs/TikTokTopicTagData"},"title":"Topic Tags","type":"array"}},"required":["post_id","description","publish_time","share_url","cover_image_url","play_count","like_count","comment_count","collect_count","share_count","author","video","music","topic_tags"],"title":"TikTokUserPostItemData","type":"object"},"TikTokUserPostMusicData":{"properties":{"music_id":{"description":"音乐 ID；长数字字符串，原样保留，不要转为数字；当前仅作为作品音乐标识返回","title":"Music Id","type":"string"},"title":{"description":"音乐标题；当前不可用时为空字符串","title":"Title","type":"string"},"author":{"description":"音乐作者；当前不可用时为空字符串","title":"Author","type":"string"},"play_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"音乐播放资源链接；可能随时间失效；当前不可用时为 null；不要把 play_url 当作音乐 ID 使用","title":"Play Url"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"音乐时长，毫秒；当前不可用时为 null","title":"Duration Ms"}},"required":["music_id","title","author","play_url","duration_ms"],"title":"TikTokUserPostMusicData","type":"object"},"TikTokUserPostVideoData":{"properties":{"play_url":{"description":"视频播放资源链接；不是作品页面链接；可能随时间失效；如果不可用，外层 video 为 null","title":"Play Url","type":"string"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频时长，毫秒；当前不可用时为 null","title":"Duration Ms"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频宽度，像素；当前不可用时为 null","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频高度，像素；当前不可用时为 null","title":"Height"}},"required":["play_url","duration_ms","width","height"],"title":"TikTokUserPostVideoData","type":"object"}},"properties":{"items":{"description":"当前页用户作品列表","items":{"$ref":"#/$defs/TikTokUserPostItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"分页令牌。首页传空字符串；next_page_token 为空字符串表示没有更多结果。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；它是不透明令牌，不能修改、截断、脱敏、格式化、重组，也不能跨关键词、筛选条件或不同请求链路复用。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"TikTokUserPostsResult","type":"object"},"example":{"items":[],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["tiktok_get_user_posts_by_tiktok_id","tiktok_get_user_posts_by_profile_url"]}]},{"surface":"mcp","status":"available","endpoint":"https://mcp.socialdatax.com/tiktok/mcp","authentication":{"required":true},"capabilities_resource":"tiktok://guides/tool-capabilities","related_http_operation_ids":["tiktok_search_posts","tiktok_get_post_detail","tiktok_get_post_comments","tiktok_get_post_comment_replies","tiktok_get_user_info","tiktok_get_user_posts"]}]},{"platform_id":"kuaishou","label":"快手","english_label":"Kuaishou / Kwai","status":"available","surfaces":[{"surface":"http","status":"available","base_path":"/socialdatax/api/v1/kuaishou","description":"公开快手 HTTP API 提供热榜、作品、评论和用户相关核心接口。","operations":[{"operation_id":"kuaishou_get_hot_search_list","platform_id":"kuaishou","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/kuaishou/hot/search/list","summary":"读取快手短视频热榜","description":"读取快手短视频热榜，返回排名、热点标题、热度值和封面图；当前不支持翻页。","tags":["内容搜索","搜索热榜","快手"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{},"title":"InternalHotSearchListRequest","type":"object"},"example":{}},"response":{"content_type":"application/json","schema":{"$defs":{"KuaishouHotSearchItemData":{"properties":{"rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"快手短视频热榜排名；当前不可用时为 null。","title":"Rank"},"keyword":{"description":"热点标题或热榜词。","title":"Keyword","type":"string"},"hot_value":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"热度值；当前不可用时为 null。","title":"Hot Value"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"热点封面图；当前不可用时为 null。","title":"Cover Image Url"}},"required":["rank","keyword","hot_value","cover_image_url"],"title":"KuaishouHotSearchItemData","type":"object"}},"properties":{"items":{"description":"快手短视频热榜条目。","items":{"$ref":"#/$defs/KuaishouHotSearchItemData"},"title":"Items","type":"array"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","points"],"title":"KuaishouHotSearchResult","type":"object"},"example":{"items":[{"rank":1,"keyword":"超强厄尔尼诺要来了","hot_value":13141000,"cover_image_url":"https://example.invalid/hot-cover.webp"}],"points":{"cost":10,"balance":990}}},"related_mcp_tools":["kuaishou_get_hot_search_list"]},{"operation_id":"kuaishou_search_videos","platform_id":"kuaishou","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/kuaishou/video/search","summary":"搜索快手作品","description":"按关键词搜索公开快手作品，返回作品摘要和下一页分页令牌。","tags":["内容搜索","快手"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"keyword":{"title":"Keyword","type":"string","description":"搜索快手作品的搜索词，可传关键词或短语，例如品牌名、话题、人物名或产品名；不要传作品链接，也不要传用户主页链接、photo_id、user_id 或 page_token。已有作品链接或 photo_id 时改用需要快手作品 URL/photo_id 的入口；已有用户主页链接或非空 user_id 时改用需要快手用户主页 URL/user_id 的入口。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"搜索分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一搜索分页链路和同一关键词，不能跨能力、关键词或搜索链路复用。"}},"required":["keyword"],"title":"InternalSearchVideosRequest","type":"object"},"example":{"keyword":"露营","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"KuaishouListVideoData":{"properties":{"play_url":{"description":"返回 video 对象时为可播放 MP4 资源链接；不是作品分享页链接。复用或分享作品时使用 share_url。","title":"Play Url","type":"string"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频时长，毫秒；不可用时为 null。","title":"Duration Ms"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频宽度，像素；不可用时为 null。","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频高度，像素；不可用时为 null。","title":"Height"}},"required":["play_url","duration_ms","width","height"],"title":"KuaishouListVideoData","type":"object"},"KuaishouSearchItemData":{"properties":{"photo_id":{"description":"快手作品 photo_id；可作为后续需要快手作品 photo_id 的工具输入。","title":"Photo Id","type":"string"},"content_type":{"const":"video","description":"作品内容类型；当前搜索和用户作品列表固定返回 video。","title":"Content Type","type":"string"},"description":{"description":"作者发布文本/作品文案，可能包含话题标签；不可用时为空字符串。","title":"Description","type":"string"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"封面图资源链接；不是作品分享页或播放资源链接；不可用时为 null。","title":"Cover Image Url"},"video":{"anyOf":[{"$ref":"#/$defs/KuaishouListVideoData"},{"type":"null"}],"description":"播放资源；无可播放 play_url 时为 null。"},"share_url":{"description":"作品分享页链接；不是播放资源或封面资源链接；可作为后续需要快手作品 URL 的工具输入。","title":"Share Url","type":"string"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"点赞数；不可用时为 null。","title":"Like Count"},"view_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"播放数；不可用时为 null。","title":"View Count"},"collect_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"收藏数；不可用时为 null。","title":"Collect Count"},"topic_tags":{"description":"作品话题标签列表；无标签时为空数组。","items":{"$ref":"#/$defs/KuaishouTopicTagData"},"title":"Topic Tags","type":"array"},"author":{"$ref":"#/$defs/KuaishouUserSummaryData","description":"作品作者信息。"}},"required":["photo_id","content_type","description","publish_time","cover_image_url","video","share_url","like_count","view_count","collect_count","topic_tags","author"],"title":"KuaishouSearchItemData","type":"object"},"KuaishouTopicTagData":{"additionalProperties":false,"properties":{"name":{"description":"话题标签名称。","title":"Name","type":"string"}},"required":["name"],"title":"KuaishouTopicTagData","type":"object"},"KuaishouUserSummaryData":{"properties":{"user_id":{"description":"快手用户 user_id；非空时可作为后续需要快手用户 user_id 的工具输入；为空字符串时不要作为后续 user_id 输入。","title":"User Id","type":"string"},"name":{"description":"用户名称。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"快手用户主页链接；不是作品分享页链接；可作为后续需要快手用户主页 URL 的工具输入；查询用户作品列表时需确认同一用户结果包含非空 user_id；不可用时为 null。","title":"Profile Url"}},"required":["user_id","name","avatar_url","profile_url"],"title":"KuaishouUserSummaryData","type":"object"}},"properties":{"items":{"description":"当前页作品结果列表。","items":{"$ref":"#/$defs/KuaishouSearchItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论或搜索链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"KuaishouSearchResult","type":"object"},"example":{"items":[{"photo_id":"3xniwdyfhv6wbwu","content_type":"video","description":"更新的是星期六的视频，娃没上学 #户外露营 #记录真实生活 #美食 #露营过夜","publish_time":1779791024,"cover_image_url":"https://example.invalid/cover.webp","video":{"play_url":"https://example.invalid/play.mp4","duration_ms":427716,"width":1080,"height":1920},"share_url":"https://www.kuaishou.com/short-video/3xniwdyfhv6wbwu","like_count":5515,"view_count":685435,"collect_count":0,"topic_tags":[],"author":{"user_id":"3xvwmftxfazybgi","name":"暴躁花花","avatar_url":"https://example.invalid/avatar.webp","profile_url":"https://www.kuaishou.com/profile/3xvwmftxfazybgi"}}],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["kuaishou_search_videos"]},{"operation_id":"kuaishou_search_users","platform_id":"kuaishou","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/kuaishou/user/search","summary":"搜索快手用户","description":"按关键词搜索公开快手用户，返回用户摘要和下一页分页令牌。","tags":["内容搜索","快手"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"keyword":{"title":"Keyword","type":"string","description":"搜索快手用户的搜索词，可传关键词或短语，例如人物名、账号名、品牌名或机构名；不要传作品链接，也不要传用户主页链接、photo_id、user_id 或 page_token。已有用户主页链接或非空 user_id 时改用需要快手用户主页 URL/user_id 的入口。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"用户搜索分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一用户搜索分页链路和同一关键词，不能跨能力、关键词或搜索链路复用。"}},"required":["keyword"],"title":"InternalSearchUsersRequest","type":"object"},"example":{"keyword":"露营","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"KuaishouUserSearchItemData":{"properties":{"user_id":{"description":"快手用户 user_id；非空时可作为后续需要快手用户 user_id 的工具输入；为空字符串时不要作为后续 user_id 输入。","title":"User Id","type":"string"},"name":{"description":"用户名称。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"快手用户主页链接；不是作品分享页链接；可作为后续需要快手用户主页 URL 的工具输入；查询用户作品列表时需确认同一用户结果包含非空 user_id；不可用时为 null。","title":"Profile Url"},"bio":{"description":"用户简介；不可用时为空字符串。","title":"Bio","type":"string"},"verified":{"description":"是否为认证账号。","title":"Verified","type":"boolean"}},"required":["user_id","name","avatar_url","profile_url","bio","verified"],"title":"KuaishouUserSearchItemData","type":"object"}},"properties":{"items":{"description":"当前页用户结果列表。","items":{"$ref":"#/$defs/KuaishouUserSearchItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论或搜索链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"KuaishouUserSearchResult","type":"object"},"example":{"items":[{"user_id":"3xvwmftxfazybgi","name":"暴躁花花","avatar_url":"https://example.invalid/avatar.webp","profile_url":"https://www.kuaishou.com/profile/3xvwmftxfazybgi","bio":"记录户外露营和真实生活","verified":false}],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["kuaishou_search_users"]},{"operation_id":"kuaishou_get_video_detail","platform_id":"kuaishou","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/kuaishou/video/detail","summary":"读取快手作品详情","description":"按 photo_id 或作品链接读取公开快手作品详情，返回文案、媒体资源、互动指标和作者信息。","tags":["内容详情","快手"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"photo_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Photo Id","description":"快手作品 photo_id；用户已提供时直接使用，否则可从包含 photo_id 的快手作品结果中复用。"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Url","description":"快手作品页链接、短链接或分享文案；不要传用户主页链接。如果上一步结果已返回 photo_id，可直接使用 photo_id 入口。"}},"title":"InternalVideoDetailRequest","type":"object"},"example":{"photo_id":"3x8cbgjq2fkrhic"}},"response":{"content_type":"application/json","schema":{"$defs":{"KuaishouDetailVideoData":{"properties":{"play_url":{"description":"返回 video 对象时为可播放 MP4 资源链接；不是作品分享页链接。复用或分享作品时使用 share_url。","title":"Play Url","type":"string"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频时长，毫秒；不可用时为 null。","title":"Duration Ms"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频宽度，像素；不可用时为 null。","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频高度，像素；不可用时为 null。","title":"Height"}},"required":["play_url","duration_ms","width","height"],"title":"KuaishouDetailVideoData","type":"object"},"KuaishouImageData":{"properties":{"url":{"description":"图片展示资源链接；用于查看或分析图片内容。","title":"Url","type":"string"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片宽度，像素；不可用时为 null。","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片高度，像素；不可用时为 null。","title":"Height"}},"required":["url","width","height"],"title":"KuaishouImageData","type":"object"},"KuaishouTopicTagData":{"additionalProperties":false,"properties":{"name":{"description":"话题标签名称。","title":"Name","type":"string"}},"required":["name"],"title":"KuaishouTopicTagData","type":"object"},"KuaishouUserSummaryData":{"properties":{"user_id":{"description":"快手用户 user_id；非空时可作为后续需要快手用户 user_id 的工具输入；为空字符串时不要作为后续 user_id 输入。","title":"User Id","type":"string"},"name":{"description":"用户名称。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"快手用户主页链接；不是作品分享页链接；可作为后续需要快手用户主页 URL 的工具输入；查询用户作品列表时需确认同一用户结果包含非空 user_id；不可用时为 null。","title":"Profile Url"}},"required":["user_id","name","avatar_url","profile_url"],"title":"KuaishouUserSummaryData","type":"object"}},"properties":{"photo_id":{"description":"快手作品 photo_id；可作为后续需要快手作品 photo_id 的工具输入。","title":"Photo Id","type":"string"},"content_type":{"description":"作品内容类型；video 表示视频，image 表示图片或图集。","enum":["video","image"],"title":"Content Type","type":"string","x-socialdatax-enum-labels":{"image":"图片","video":"视频"}},"description":{"description":"作者发布文本/作品文案，可能包含话题标签；不可用时为空字符串。","title":"Description","type":"string"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"封面图资源链接；不是作品分享页或播放资源链接；不可用时为 null。","title":"Cover Image Url"},"images":{"description":"图片或图集作品按顺序返回图片列表；视频作品为空数组。","items":{"$ref":"#/$defs/KuaishouImageData"},"title":"Images","type":"array"},"video":{"anyOf":[{"$ref":"#/$defs/KuaishouDetailVideoData"},{"type":"null"}],"description":"播放资源；视频作品返回播放资源，非视频作品为 null。"},"share_url":{"description":"作品分享页链接；不是播放资源或封面资源链接；可作为后续需要快手作品 URL 的工具输入。","title":"Share Url","type":"string"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"点赞数；不可用时为 null。","title":"Like Count"},"comment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论数；不可用时为 null。","title":"Comment Count"},"view_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"播放数；不可用时为 null。","title":"View Count"},"collect_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"收藏数；不可用时为 null。","title":"Collect Count"},"share_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"分享数；不可用时为 null。","title":"Share Count"},"topic_tags":{"description":"作品话题标签列表；无标签时为空数组。","items":{"$ref":"#/$defs/KuaishouTopicTagData"},"title":"Topic Tags","type":"array"},"author":{"$ref":"#/$defs/KuaishouUserSummaryData","description":"作品作者信息。"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["photo_id","content_type","description","publish_time","cover_image_url","images","video","share_url","like_count","comment_count","view_count","collect_count","share_count","topic_tags","author","points"],"title":"KuaishouVideoDetailData","type":"object"},"example":{"photo_id":"3x8cbgjq2fkrhic","content_type":"video","description":"隐私安全一定要重视#避雷 #老铁财富密码 #知识播种计划 #内容启发分享计划","publish_time":1767627034,"cover_image_url":"https://example.invalid/cover.webp","images":[],"video":{"play_url":"https://example.invalid/play.mp4","duration_ms":58533,"width":1080,"height":1920},"share_url":"https://www.kuaishou.com/short-video/3x8cbgjq2fkrhic","like_count":2173,"comment_count":null,"view_count":92000,"collect_count":null,"share_count":null,"topic_tags":[{"name":"老铁财富密码"},{"name":"内容启发分享计划"},{"name":"避雷"},{"name":"知识播种计划"}],"author":{"user_id":"3x5ijbmydjhrcng","name":"沈阳大飞","avatar_url":"https://example.invalid/avatar.webp","profile_url":"https://www.kuaishou.com/profile/3x5ijbmydjhrcng"},"points":{"cost":10,"balance":990}}},"related_mcp_tools":["kuaishou_get_video_detail_by_url","kuaishou_get_video_detail_by_photo_id"]},{"operation_id":"kuaishou_get_video_comments","platform_id":"kuaishou","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/kuaishou/video/comment/list","summary":"读取快手作品一级评论","description":"按 photo_id、作品链接、短链接或分享文案读取公开快手作品一级评论，返回评论作者、内容和下一页分页令牌。","tags":["评论","快手"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"photo_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Photo Id","description":"快手作品 photo_id；用户已提供时直接使用，否则可从包含 photo_id 的快手作品结果中复用。"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Url","description":"快手作品页链接、短链接或分享文案；不要传用户主页链接。查评论时如果手里有原始作品链接、短链接或分享文案，保留原始 URL/文案并直接使用 URL 入口。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一作品评论分页链路，不能跨能力或作品复用。"}},"title":"InternalVideoCommentsRequest","type":"object"},"example":{"url":"https://v.kuaishou.com/K3Ex91Lb","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"KuaishouCommentAuthorData":{"properties":{"user_id":{"description":"快手用户 user_id；非空时可作为后续需要快手用户 user_id 的工具输入；为空字符串时不要作为后续 user_id 输入。","title":"User Id","type":"string"},"name":{"description":"评论作者名称。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"评论作者头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"快手用户主页链接；不是作品分享页链接；可作为后续需要快手用户主页 URL 的工具输入；查询用户作品列表时需确认同一用户结果包含非空 user_id；不可用时为 null。","title":"Profile Url"}},"required":["user_id","name","avatar_url","profile_url"],"title":"KuaishouCommentAuthorData","type":"object"},"KuaishouCommentItem":{"properties":{"comment_id":{"description":"评论 ID；一级评论列表项的 comment_id 可作为后续获取该评论下回复的输入。","title":"Comment Id","type":"string"},"photo_id":{"description":"快手作品 photo_id；可作为后续需要快手作品 photo_id 的工具输入。","title":"Photo Id","type":"string"},"content":{"description":"评论内容。","title":"Content","type":"string"},"create_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Create Time"},"like_count":{"description":"评论点赞数。","title":"Like Count","type":"integer"},"has_replies":{"description":"是否有评论回复；has_replies 为 true 时，可使用该评论的 comment_id 获取该一级评论下的回复。","title":"Has Replies","type":"boolean"},"author":{"$ref":"#/$defs/KuaishouCommentAuthorData","description":"评论作者信息。"}},"required":["comment_id","photo_id","content","create_time","like_count","has_replies","author"],"title":"KuaishouCommentItem","type":"object"}},"properties":{"items":{"description":"当前页一级评论列表。","items":{"$ref":"#/$defs/KuaishouCommentItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论或搜索链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。","title":"Next Page Token","type":"string"},"comment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论总数；不可用时为 null。","title":"Comment Count"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","comment_count","points"],"title":"KuaishouVideoCommentsResult","type":"object"},"example":{"items":[{"comment_id":"1164465390856","photo_id":"3xx3gmi9i2dm6hm","content":"还会抽 注意新作品","create_time":1786282807,"like_count":2,"has_replies":true,"author":{"user_id":"4148264151","name":"余溺.","avatar_url":"https://example.invalid/comment-avatar.webp","profile_url":null}}],"next_page_token":"opaque-kuaishou-comment-page-token","comment_count":1256,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["kuaishou_get_video_comments_by_photo_id","kuaishou_get_video_comments_by_url"]},{"operation_id":"kuaishou_get_video_comment_replies","platform_id":"kuaishou","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/kuaishou/video/comment/reply/list","summary":"读取快手评论回复","description":"按 photo_id 和一级评论 ID 读取公开回复列表，返回评论结构和下一页分页令牌。","tags":["评论","快手"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"photo_id":{"title":"Photo Id","type":"string","description":"快手作品 photo_id；用户已提供时直接使用，否则可从包含 photo_id 的快手作品结果中复用。"},"comment_id":{"title":"Comment Id","type":"string","description":"一级评论 ID；用户已提供时直接使用，否则可从一级评论结果 items[].comment_id 复制；用于获取该评论下的回复；不要传回复项的 comment_id。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"回复分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一作品下同一一级评论的回复分页链路，不能跨能力、作品或评论复用。"}},"required":["photo_id","comment_id"],"title":"InternalVideoCommentRepliesRequest","type":"object"},"example":{"photo_id":"3xiiy5h354fxrky","comment_id":"1110853192412","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"KuaishouCommentAuthorData":{"properties":{"user_id":{"description":"快手用户 user_id；非空时可作为后续需要快手用户 user_id 的工具输入；为空字符串时不要作为后续 user_id 输入。","title":"User Id","type":"string"},"name":{"description":"评论作者名称。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"评论作者头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"快手用户主页链接；不是作品分享页链接；可作为后续需要快手用户主页 URL 的工具输入；查询用户作品列表时需确认同一用户结果包含非空 user_id；不可用时为 null。","title":"Profile Url"}},"required":["user_id","name","avatar_url","profile_url"],"title":"KuaishouCommentAuthorData","type":"object"},"KuaishouCommentReplyItem":{"properties":{"comment_id":{"description":"评论回复 ID；这是回复项自身的 comment_id，不要作为评论回复入口输入。","title":"Comment Id","type":"string"},"photo_id":{"description":"快手作品 photo_id；可作为后续需要快手作品 photo_id 的工具输入。","title":"Photo Id","type":"string"},"content":{"description":"评论回复内容。","title":"Content","type":"string"},"create_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论回复发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Create Time"},"like_count":{"description":"评论回复点赞数。","title":"Like Count","type":"integer"},"reply_to_user_name":{"description":"被回复用户名称；不可用时为空字符串。","title":"Reply To User Name","type":"string"},"reply_to_user_id":{"description":"被回复用户 user_id；非空时可作为后续需要快手用户 user_id 的工具输入；不可用时为空字符串，为空时不要作为后续 user_id 输入。","title":"Reply To User Id","type":"string"},"author":{"$ref":"#/$defs/KuaishouCommentAuthorData","description":"评论回复作者信息。"}},"required":["comment_id","photo_id","content","create_time","like_count","reply_to_user_name","reply_to_user_id","author"],"title":"KuaishouCommentReplyItem","type":"object"}},"properties":{"items":{"description":"当前页评论回复列表。","items":{"$ref":"#/$defs/KuaishouCommentReplyItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论或搜索链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"KuaishouVideoCommentRepliesResult","type":"object"},"example":{"items":[{"comment_id":"1114289335039","photo_id":"3xiiy5h354fxrky","content":"^_^^_^","create_time":1774285900,"like_count":0,"reply_to_user_name":"","reply_to_user_id":"","author":{"user_id":"3xgt3yx4qq4di2s","name":"毅6702","avatar_url":"https://example.invalid/comment-avatar.webp","profile_url":"https://www.kuaishou.com/profile/3xgt3yx4qq4di2s"}}],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["kuaishou_get_video_comment_replies_by_comment_id"]},{"operation_id":"kuaishou_get_user_info","platform_id":"kuaishou","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/kuaishou/user/info","summary":"读取快手用户资料","description":"按非空 user_id 或主页链接读取创作者公开资料和公开互动规模。","tags":["用户资料","快手"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"User Id","description":"快手用户非空 user_id；可从包含非空 user_id 的快手用户或作者结果中复用；如果上一步结果里的 user_id 为空字符串，不要使用 user_id 入口。"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Profile Url","description":"快手用户主页链接、短链接或分享文案；不要传作品链接。支持 live 主页或 fw/user 形式的用户主页分享链接；成功时会返回可复用的非空 user_id。如果上一步结果已返回非空 user_id，可直接使用 user_id 入口。"}},"title":"InternalUserInfoRequest","type":"object"},"example":{"user_id":"3x5ijbmydjhrcng"}},"response":{"content_type":"application/json","schema":{"properties":{"user_id":{"description":"快手用户非空 user_id；可作为后续需要快手用户 user_id 的工具输入。","title":"User Id","type":"string"},"name":{"description":"用户名称。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"快手用户主页链接；不是作品分享页链接；可作为后续需要快手用户主页 URL 的工具输入；查询用户作品列表时需确认同一用户结果包含非空 user_id；不可用时为 null。","title":"Profile Url"},"kuaishou_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"快手号；不可用时为 null。","title":"Kuaishou Id"},"bio":{"description":"用户简介；不可用时为空字符串。","title":"Bio","type":"string"},"gender":{"description":"用户性别。","enum":["male","female","unknown"],"title":"Gender","type":"string","x-socialdatax-enum-labels":{"male":"男","female":"女","unknown":"未知"}},"follower_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"粉丝数；不可用时为 null。","title":"Follower Count"},"following_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"关注数；不可用时为 null。","title":"Following Count"},"received_like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"获赞数；表示用户内容累计收到的点赞数；不可用时为 null。","title":"Received Like Count"},"posted_content_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"公开作品数；不可用时为 null。","title":"Posted Content Count"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["user_id","name","avatar_url","profile_url","kuaishou_id","bio","gender","follower_count","following_count","received_like_count","posted_content_count","points"],"title":"KuaishouUserInfoData","type":"object"},"example":{"user_id":"3x5ijbmydjhrcng","name":"沈阳大飞","avatar_url":"https://example.invalid/avatar.webp","profile_url":"https://www.kuaishou.com/profile/3x5ijbmydjhrcng","kuaishou_id":"DF777555777","bio":"科普财经避雷\n揭秘日常套路\n讲透各类骗局\n🛰️ DF777555777","gender":"male","follower_count":1534586,"following_count":25,"received_like_count":10571278,"posted_content_count":659,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["kuaishou_get_user_info_by_user_id","kuaishou_get_user_info_by_profile_url"]},{"operation_id":"kuaishou_get_user_posted_videos","platform_id":"kuaishou","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/kuaishou/user/video/list","summary":"读取快手用户作品列表","description":"按非空 user_id 或可直接解析出非空 user_id 的主页链接读取创作者已发布作品摘要列表，支持分页令牌。","tags":["用户内容","快手"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"User Id","description":"快手用户非空 user_id；可从包含非空 user_id 的快手用户或作者结果中复用；如果上一步结果里的 user_id 为空字符串，不要使用 user_id 入口。"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Profile Url","description":"快手用户主页链接、短链接或分享文案；不要传作品链接。该入口需要能直接解析出可复用 user_id 的主页链接；只有 live/fw-user 主页链接时，先调用用户资料入口，成功后使用返回的非空 user_id 查询作品列表。如果上一步结果已返回非空 user_id，可直接使用 user_id 入口。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"用户作品分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一用户作品分页链路，不能跨能力或用户复用。"}},"title":"InternalUserPostedRequest","type":"object"},"example":{"user_id":"3xn3uu4z6qqtvz4","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"KuaishouListVideoData":{"properties":{"play_url":{"description":"返回 video 对象时为可播放 MP4 资源链接；不是作品分享页链接。复用或分享作品时使用 share_url。","title":"Play Url","type":"string"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频时长，毫秒；不可用时为 null。","title":"Duration Ms"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频宽度，像素；不可用时为 null。","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频高度，像素；不可用时为 null。","title":"Height"}},"required":["play_url","duration_ms","width","height"],"title":"KuaishouListVideoData","type":"object"},"KuaishouTopicTagData":{"additionalProperties":false,"properties":{"name":{"description":"话题标签名称。","title":"Name","type":"string"}},"required":["name"],"title":"KuaishouTopicTagData","type":"object"},"KuaishouUserPostedItemData":{"properties":{"photo_id":{"description":"快手作品 photo_id；可作为后续需要快手作品 photo_id 的工具输入。","title":"Photo Id","type":"string"},"content_type":{"const":"video","description":"作品内容类型；当前搜索和用户作品列表固定返回 video。","title":"Content Type","type":"string"},"description":{"description":"作者发布文本/作品文案，可能包含话题标签；不可用时为空字符串。","title":"Description","type":"string"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"封面图资源链接；不是作品分享页或播放资源链接；不可用时为 null。","title":"Cover Image Url"},"video":{"anyOf":[{"$ref":"#/$defs/KuaishouListVideoData"},{"type":"null"}],"description":"播放资源；无可播放 play_url 时为 null。"},"share_url":{"description":"作品分享页链接；不是播放资源或封面资源链接；可作为后续需要快手作品 URL 的工具输入。","title":"Share Url","type":"string"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"点赞数；不可用时为 null。","title":"Like Count"},"view_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"播放数；不可用时为 null。","title":"View Count"},"collect_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"收藏数；不可用时为 null。","title":"Collect Count"},"topic_tags":{"description":"作品话题标签列表；无标签时为空数组。","items":{"$ref":"#/$defs/KuaishouTopicTagData"},"title":"Topic Tags","type":"array"},"author":{"$ref":"#/$defs/KuaishouUserSummaryData","description":"作品作者信息。"}},"required":["photo_id","content_type","description","publish_time","cover_image_url","video","share_url","like_count","view_count","collect_count","topic_tags","author"],"title":"KuaishouUserPostedItemData","type":"object"},"KuaishouUserSummaryData":{"properties":{"user_id":{"description":"快手用户 user_id；非空时可作为后续需要快手用户 user_id 的工具输入；为空字符串时不要作为后续 user_id 输入。","title":"User Id","type":"string"},"name":{"description":"用户名称。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"快手用户主页链接；不是作品分享页链接；可作为后续需要快手用户主页 URL 的工具输入；查询用户作品列表时需确认同一用户结果包含非空 user_id；不可用时为 null。","title":"Profile Url"}},"required":["user_id","name","avatar_url","profile_url"],"title":"KuaishouUserSummaryData","type":"object"}},"properties":{"items":{"description":"当前页该用户发布的作品列表。","items":{"$ref":"#/$defs/KuaishouUserPostedItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论或搜索链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"KuaishouUserPostedVideosResult","type":"object"},"example":{"items":[{"photo_id":"3xegjy9t5df87ss","content_type":"video","description":"他们坚守在新疆北湾与蚊共舞青春。 #本地代言官 #海米提 #海米提正能量","publish_time":1629426323,"cover_image_url":"https://example.invalid/cover.webp","video":{"play_url":"https://example.invalid/play.mp4","duration_ms":89200,"width":1080,"height":1920},"share_url":"https://www.kuaishou.com/short-video/3xegjy9t5df87ss","like_count":1403402,"view_count":28674851,"collect_count":5872,"topic_tags":[{"name":"海米提正能量"},{"name":"本地代言官"},{"name":"海米提"}],"author":{"user_id":"3xn3uu4z6qqtvz4","name":"海米提正能量","avatar_url":"https://example.invalid/avatar.webp","profile_url":"https://www.kuaishou.com/profile/3xn3uu4z6qqtvz4"}}],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["kuaishou_get_user_posted_videos_by_user_id","kuaishou_get_user_posted_videos_by_profile_url"]}]},{"surface":"mcp","status":"available","endpoint":"https://mcp.socialdatax.com/kuaishou/mcp","authentication":{"required":true},"capabilities_resource":"kuaishou://guides/tool-capabilities","related_http_operation_ids":["kuaishou_get_hot_search_list","kuaishou_search_videos","kuaishou_search_users","kuaishou_get_video_detail","kuaishou_get_video_comments","kuaishou_get_video_comment_replies","kuaishou_get_user_info","kuaishou_get_user_posted_videos"]}]},{"platform_id":"bilibili","label":"B站","english_label":"Bilibili","status":"available","surfaces":[{"surface":"http","status":"available","base_path":"/socialdatax/api/v1/bilibili","description":"公开 Bilibili HTTP API 提供视频搜索、专栏搜索、内容详情、视频下载地址、评论、赞与转发、用户资料和用户发布视频/单篇专栏/动态列表接口。","operations":[{"operation_id":"bilibili_search_videos","platform_id":"bilibili","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/bilibili/video/search","summary":"搜索 Bilibili 视频","description":"按关键词和筛选条件搜索公开 Bilibili 视频，返回视频摘要和下一页分页令牌。","tags":["内容搜索","哔哩哔哩"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"keyword":{"title":"Keyword","type":"string","description":"搜索 Bilibili 视频的搜索词，可传关键词或短语，例如品牌名、话题、人物名或产品名；不要传视频链接、专栏/动态链接、用户主页链接、BV 号、aid、专栏/动态 ID 或 page_token。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"Bilibili 视频搜索分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一关键词、排序、发布时间筛选和时长筛选的搜索链路，不能跨接口、关键词或筛选条件复用。消费多页搜索结果时，建议按 content_id 作为稳定键合并结果。"},"sort_type":{"default":"general","enum":["general","view_count_descending","time_descending","danmaku_count_descending","collect_count_descending"],"title":"Sort Type","type":"string","description":"排序方式：general=综合排序，view_count_descending=最多播放，time_descending=最新发布，danmaku_count_descending=最多弹幕，collect_count_descending=最多收藏。","x-socialdatax-enum-labels":{"general":"综合排序","view_count_descending":"最多播放","time_descending":"最新发布","danmaku_count_descending":"最多弹幕","collect_count_descending":"最多收藏"}},"publish_time_range":{"default":"all","enum":["all","day","week","half_year"],"title":"Publish Time Range","type":"string","description":"发布时间筛选：all=全部日期，day=最近一天，week=最近一周，half_year=最近半年；如需自定义日期范围，直接同时填写 publish_time_start_date 和 publish_time_end_date。","x-socialdatax-enum-labels":{"all":"全部日期","day":"最近一天","week":"最近一周","half_year":"最近半年"}},"publish_time_start_date":{"default":"","title":"Publish Time Start Date","type":"string","description":"自定义发布时间开始日期，格式 YYYY-MM-DD；需要自定义日期范围时必须和 publish_time_end_date 同时填写，且 publish_time_range 保持 all。"},"publish_time_end_date":{"default":"","title":"Publish Time End Date","type":"string","description":"自定义发布时间结束日期，格式 YYYY-MM-DD；需要自定义日期范围时必须和 publish_time_start_date 同时填写，且 publish_time_range 保持 all。"},"duration_range":{"default":"all","enum":["all","under_10_minutes","between_10_and_30_minutes","between_30_and_60_minutes","over_60_minutes"],"title":"Duration Range","type":"string","description":"视频时长筛选：all=全部时长，under_10_minutes=10分钟以下，between_10_and_30_minutes=10-30分钟，between_30_and_60_minutes=30-60分钟，over_60_minutes=60分钟以上。","x-socialdatax-enum-labels":{"all":"全部时长","under_10_minutes":"10分钟以下","between_10_and_30_minutes":"10-30分钟","between_30_and_60_minutes":"30-60分钟","over_60_minutes":"60分钟以上"}}},"required":["keyword"],"title":"InternalSearchVideosRequest","type":"object"},"example":{"keyword":"露营","page_token":"","sort_type":"general","publish_time_range":"all","publish_time_start_date":"","publish_time_end_date":"","duration_range":"all"}},"response":{"content_type":"application/json","schema":{"$defs":{"BilibiliAuthorData":{"properties":{"user_id":{"description":"B 站用户 user_id；用于标识作者或用户。","title":"User Id","type":"string"},"name":{"description":"B 站用户名称；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"B 站用户主页链接；可用于打开用户主页；不可用时为 null。","title":"Profile Url"}},"required":["user_id","name","avatar_url","profile_url"],"title":"BilibiliAuthorData","type":"object"},"BilibiliSearchVideoData":{"properties":{"content_id":{"description":"视频搜索结果的统一内容 ID，固定为视频 bvid（BV...）；可作为内容详情或内容评论接口的 content_id 字段。","title":"Content Id","type":"string"},"bvid":{"description":"B 站视频 BV 号；读取视频详情或视频评论时，优先作为 content_id 字段使用。","title":"Bvid","type":"string"},"aid":{"description":"B 站视频数字 aid，即老 AV 号的数字部分；仅作为备用视频标识。没有 bvid 时，建议拼成 av{aid} 作为 content_id 传入，避免裸数字和专栏/动态 ID 混淆。","title":"Aid","type":"string"},"title":{"description":"视频标题；不可用时为空字符串。","title":"Title","type":"string"},"description":{"description":"视频简介；不可用时为空字符串。","title":"Description","type":"string"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"duration_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频时长，单位秒；不可用时为 null。","title":"Duration Seconds"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"视频封面图链接；不可用时为 null。","title":"Cover Image Url"},"share_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"视频分享页链接；不可用时为 null。","title":"Share Url"},"view_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"播放数；不可用时为 null。","title":"View Count"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"点赞数；不可用时为 null。","title":"Like Count"},"collect_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"收藏数；不可用时为 null。","title":"Collect Count"},"comment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论数；不可用时为 null。","title":"Comment Count"},"danmaku_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"弹幕数；不可用时为 null。","title":"Danmaku Count"},"topic_tags":{"description":"标签列表；无标签时为空数组；每项只返回 name。","items":{"$ref":"#/$defs/BilibiliTopicTagData"},"title":"Topic Tags","type":"array"},"category_id":{"description":"视频分区 ID；不可用时为空字符串。","title":"Category Id","type":"string"},"category_name":{"description":"视频分区名称；不可用时为空字符串。","title":"Category Name","type":"string"},"author":{"$ref":"#/$defs/BilibiliAuthorData","description":"视频作者信息。"}},"required":["content_id","bvid","aid","title","description","publish_time","duration_seconds","cover_image_url","share_url","view_count","like_count","collect_count","comment_count","danmaku_count","topic_tags","category_id","category_name","author"],"title":"BilibiliSearchVideoData","type":"object"},"BilibiliTopicTagData":{"properties":{"name":{"description":"标签名称。","title":"Name","type":"string"}},"required":["name"],"title":"BilibiliTopicTagData","type":"object"}},"properties":{"items":{"description":"当前页视频搜索结果。","items":{"$ref":"#/$defs/BilibiliSearchVideoData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多视频搜索结果。继续获取视频搜索下一页时，必须将返回的完整 next_page_token 原样作为 page_token 传回；只能用于同一关键词、排序、发布时间筛选和时长筛选的搜索链路；消费多页搜索结果时，建议按 content_id 作为稳定键合并结果。不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容；不能跨接口、关键词或筛选条件复用。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"BilibiliSearchResult","type":"object"},"example":{"items":[{"content_id":"BV1VCVS6PEAd","bvid":"BV1VCVS6PEAd","aid":"116668525186915","title":"新手露营装备清单与营地搭建全套教程，2026最新版","description":"从零开始讲解露营装备、营地选择、帐篷搭建和户外安全注意事项。","publish_time":1780220817,"duration_seconds":55323,"cover_image_url":"https://i2.hdslb.com/bfs/archive/656b16a82c57a641b8c350c019753cef0a3acf70.jpg","share_url":"https://www.bilibili.com/video/BV1VCVS6PEAd","view_count":295504,"like_count":5310,"collect_count":19689,"comment_count":3265,"danmaku_count":570,"topic_tags":[{"name":"露营"},{"name":"露营装备"},{"name":"户外"}],"category_id":"122","category_name":"野生技能协会","author":{"user_id":"1569066411","name":"露营入门指南","avatar_url":"https://i0.hdslb.com/bfs/face/58b52976dffd9994e4d805b5dc87574fc3c95f90.jpg","profile_url":"https://space.bilibili.com/1569066411"}}],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["bilibili_search_videos"]},{"operation_id":"bilibili_search_articles","platform_id":"bilibili","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/bilibili/article/search","summary":"搜索 Bilibili 专栏","description":"按关键词、排序和分区筛选搜索公开 Bilibili 专栏文章，返回专栏摘要和下一页分页令牌。","tags":["内容搜索","哔哩哔哩"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"keyword":{"title":"Keyword","type":"string","description":"搜索 Bilibili 专栏文章的搜索词，可传关键词或短语，例如品牌名、话题、人物名或产品名；不要传视频链接、专栏/动态链接、用户主页链接、BV 号、aid、专栏/动态 ID 或 page_token。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"Bilibili 专栏搜索分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一关键词、排序方式和分区筛选的专栏搜索链路，不能跨接口、关键词或筛选条件复用。消费多页搜索结果时，建议按 content_id 作为稳定键合并结果。"},"sort_type":{"default":"general","enum":["general","time_descending","view_count_descending","like_count_descending","comment_count_descending"],"title":"Sort Type","type":"string","description":"专栏排序方式：general=综合排序，time_descending=最新发布，view_count_descending=最多点击/阅读，like_count_descending=最多喜欢，comment_count_descending=最多评论。","x-socialdatax-enum-labels":{"general":"综合排序","time_descending":"最新发布","view_count_descending":"最多点击/阅读","like_count_descending":"最多喜欢","comment_count_descending":"最多评论"}},"category":{"default":"all","enum":["all","animation","gaming","film_and_tv","lifestyle","hobbies","light_novel","technology","notes"],"title":"Category","type":"string","description":"专栏分区筛选：all=全部分区，animation=动画，gaming=游戏，film_and_tv=影视，lifestyle=生活，hobbies=兴趣，light_novel=轻小说，technology=科技，notes=笔记。","x-socialdatax-enum-labels":{"all":"全部分区","animation":"动画","gaming":"游戏","film_and_tv":"影视","lifestyle":"生活","hobbies":"兴趣","light_novel":"轻小说","technology":"科技","notes":"笔记"}}},"required":["keyword"],"title":"InternalSearchArticlesRequest","type":"object"},"example":{"keyword":"露营","page_token":"","sort_type":"general","category":"all"}},"response":{"content_type":"application/json","schema":{"$defs":{"BilibiliArticleSearchAuthorData":{"properties":{"user_id":{"description":"B 站用户 user_id；用于标识作者或用户。","title":"User Id","type":"string"},"name":{"description":"B 站用户名称；不可用时为空字符串。","title":"Name","type":"string"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"B 站用户主页链接；可用于打开用户主页；不可用时为 null。","title":"Profile Url"}},"required":["user_id","name","profile_url"],"title":"BilibiliArticleSearchAuthorData","type":"object"},"BilibiliArticleSearchItemData":{"properties":{"content_id":{"description":"专栏搜索结果的统一内容 ID，固定为 cv 加专栏数字 ID；可作为内容详情或内容评论接口的 content_id 字段。获取赞与转发时，先读取详情，再使用详情里的 post.post_id 或 post.share_url。","title":"Content Id","type":"string"},"title":{"description":"专栏标题；不可用时为空字符串。","title":"Title","type":"string"},"description":{"description":"专栏搜索摘要或正文片段，可能被平台截断；不可用时为空字符串。","title":"Description","type":"string"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"专栏封面图链接；不可用时为 null。","title":"Cover Image Url"},"image_urls":{"description":"专栏搜索结果图片链接列表；不可用时为空列表。","items":{"type":"string"},"title":"Image Urls","type":"array"},"share_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"专栏阅读页链接，通常是 https://www.bilibili.com/read/cv...；可用于打开专栏原文；不能直接用于赞与转发；如需获取赞与转发，先获取详情，再使用详情里的 post.share_url 或 post.post_id；不可用时为 null。","title":"Share Url"},"view_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"阅读数；不可用时为 null。","title":"View Count"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"点赞数；不可用时为 null。","title":"Like Count"},"comment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论数；不可用时为 null。","title":"Comment Count"},"category_id":{"description":"专栏分区 ID；不可用时为空字符串。","title":"Category Id","type":"string"},"category_name":{"description":"专栏分区名称；不可用时为空字符串。","title":"Category Name","type":"string"},"author":{"$ref":"#/$defs/BilibiliArticleSearchAuthorData","description":"专栏作者信息。"}},"required":["content_id","title","description","publish_time","cover_image_url","image_urls","share_url","view_count","like_count","comment_count","category_id","category_name","author"],"title":"BilibiliArticleSearchItemData","type":"object"}},"properties":{"items":{"description":"当前页专栏搜索结果。","items":{"$ref":"#/$defs/BilibiliArticleSearchItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多专栏搜索结果。继续获取专栏搜索下一页时，必须将返回的完整 next_page_token 原样作为 page_token 传回；只能用于同一关键词、排序方式和分区筛选的专栏搜索链路；消费多页搜索结果时，建议按 content_id 作为稳定键合并结果。不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容；不能跨接口、关键词或筛选条件复用。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"BilibiliArticleSearchResult","type":"object"},"example":{"items":[{"content_id":"cv18031679","title":"周末露营路线和装备预算整理","description":"从营地选择、露营装备到安全注意事项的经验整理。","publish_time":1660128034,"cover_image_url":"https://example.invalid/bilibili-article-cover.jpg","image_urls":["https://example.invalid/bilibili-article-cover.jpg"],"share_url":"https://www.bilibili.com/read/cv18031679","view_count":40882,"like_count":124,"comment_count":127,"category_id":"15","category_name":"日常","author":{"user_id":"1875333","name":"户外资料夹","profile_url":"https://space.bilibili.com/1875333"}}],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["bilibili_search_articles"]},{"operation_id":"bilibili_get_content_detail","platform_id":"bilibili","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/bilibili/content/detail","summary":"读取 Bilibili 内容详情","description":"按链接或内容 ID 自动识别并读取公开 Bilibili 视频、专栏或动态详情。","tags":["内容详情","哔哩哔哩"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"description":"url 和 content_id 必须且只能传一个；默认自动识别 Bilibili 视频、专栏或动态内容类型。","properties":{"url":{"default":"","title":"Url","type":"string","description":"Bilibili 视频、专栏或动态链接，t.bilibili.com 动态链接、短链接或包含链接的分享文案；读取视频详情、专栏详情或动态详情时优先传完整链接；不要传用户主页链接、BV 号、aid 或纯数字 ID。"},"content_id":{"default":"","title":"Content Id","type":"string","description":"Bilibili 内容 ID；读取视频详情时优先传 bvid（BV...）。如果只有视频 aid，建议传 av{aid}（如 av116668525186915）以明确表示视频；不建议直接传裸数字 aid，因为裸数字也可能是专栏/动态 post_id，容易混淆并会按自动识别处理。读取专栏详情时传 cv 专栏 ID（如 cv9689859）；读取动态/opus 详情时可传 /opus/{id} 或 /dynamic/{id} 路径中的数字 post_id。不要传链接或分享文案。"}},"title":"PublicBilibiliContentDetailRequest","type":"object"},"example":{"content_id":"BV1xx411c7mD"}},"response":{"content_type":"application/json","schema":{"$defs":{"BilibiliAuthorData":{"properties":{"user_id":{"description":"B 站用户 user_id；用于标识作者或用户。","title":"User Id","type":"string"},"name":{"description":"B 站用户名称；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"B 站用户主页链接；可用于打开用户主页；不可用时为 null。","title":"Profile Url"}},"required":["user_id","name","avatar_url","profile_url"],"title":"BilibiliAuthorData","type":"object"},"BilibiliImageData":{"properties":{"url":{"description":"图片链接。","title":"Url","type":"string"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片宽度，像素；不可用时为 null。","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片高度，像素；不可用时为 null。","title":"Height"}},"required":["url","width","height"],"title":"BilibiliImageData","type":"object"},"BilibiliPostDetailData":{"properties":{"post_id":{"description":"B 站专栏/动态 post_id；可作为内容详情接口的 content_id 字段，也可作为赞与转发接口的 post_id 字段。","title":"Post Id","type":"string"},"title":{"description":"标题；不可用时为空字符串。","title":"Title","type":"string"},"description":{"description":"专栏摘要或动态正文/说明；专栏全文使用 content；不可用时为空字符串。","title":"Description","type":"string"},"content":{"description":"纯文本正文全文，主要用于专栏，不包含图片位置；动态通常为空字符串；不可用时为空字符串。","title":"Content","type":"string"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"update_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"更新时间，秒级 Unix 时间戳；不可用时为 null。","title":"Update Time"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"封面图链接，通常取图片列表第一张或平台封面；不可用时为 null。","title":"Cover Image Url"},"image_urls":{"description":"图片链接列表；不表示正文中的插入位置；不可用时为空列表。","items":{"type":"string"},"title":"Image Urls","type":"array"},"images":{"description":"图片列表，包含链接及宽高；无图时为空数组。","items":{"$ref":"#/$defs/BilibiliImageData"},"title":"Images","type":"array"},"share_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"专栏/动态分享页链接；可作为赞与转发接口的 url 字段；不可用时为 null。","title":"Share Url"},"view_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"阅读数；不可用时为 null。","title":"View Count"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"点赞数；不可用时为 null。","title":"Like Count"},"collect_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"收藏数；不可用时为 null。","title":"Collect Count"},"coin_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"投币数；不可用时为 null。","title":"Coin Count"},"comment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论数；不可用时为 null。","title":"Comment Count"},"share_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"分享数；不可用时为 null。","title":"Share Count"},"category_id":{"description":"专栏分区 ID；动态通常为空字符串；不可用时为空字符串。","title":"Category Id","type":"string"},"category_name":{"description":"专栏分区名称；动态通常为空字符串；不可用时为空字符串。","title":"Category Name","type":"string"},"topic_tags":{"description":"标签列表；无标签时为空数组；每项只返回 name。","items":{"$ref":"#/$defs/BilibiliTopicTagData"},"title":"Topic Tags","type":"array"},"word_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"正文字数；不可用时为 null。","title":"Word Count"},"author":{"$ref":"#/$defs/BilibiliAuthorData","description":"作者信息。"}},"required":["post_id","title","description","content","publish_time","update_time","cover_image_url","image_urls","images","share_url","view_count","like_count","collect_count","coin_count","comment_count","share_count","category_id","category_name","topic_tags","word_count","author"],"title":"BilibiliPostDetailData","type":"object"},"BilibiliTopicTagData":{"properties":{"name":{"description":"标签名称。","title":"Name","type":"string"}},"required":["name"],"title":"BilibiliTopicTagData","type":"object"},"BilibiliVideoDetailData":{"properties":{"bvid":{"description":"B 站视频 BV 号；读取视频详情或视频评论时，优先作为 content_id 字段使用。","title":"Bvid","type":"string"},"aid":{"description":"B 站视频数字 aid，即老 AV 号的数字部分；仅作为备用视频标识。没有 bvid 时，建议拼成 av{aid} 作为 content_id 传入，避免裸数字和专栏/动态 ID 混淆。","title":"Aid","type":"string"},"title":{"description":"视频标题；不可用时为空字符串。","title":"Title","type":"string"},"description":{"description":"视频简介；不可用时为空字符串。","title":"Description","type":"string"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"视频封面图链接；不可用时为 null。","title":"Cover Image Url"},"share_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"视频分享页链接；不可用时为 null。","title":"Share Url"},"view_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"播放数；不可用时为 null。","title":"View Count"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"点赞数；不可用时为 null。","title":"Like Count"},"collect_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"收藏数；不可用时为 null。","title":"Collect Count"},"comment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论数；不可用时为 null。","title":"Comment Count"},"danmaku_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"弹幕数；不可用时为 null。","title":"Danmaku Count"},"author":{"$ref":"#/$defs/BilibiliAuthorData","description":"视频作者信息。"},"duration_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频时长，单位秒；不可用时为 null。","title":"Duration Seconds"},"page_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频分 P 数量；单 P 视频通常为 1；不可用时为 null。","title":"Page Count"},"pages":{"description":"视频分 P 列表；单 P 视频通常包含 1 项；无可用分 P 信息时为空数组。","items":{"$ref":"#/$defs/BilibiliVideoPageData"},"title":"Pages","type":"array"},"coin_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"投币数；不可用时为 null。","title":"Coin Count"},"share_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"分享数；不可用时为 null。","title":"Share Count"},"topic_tags":{"description":"标签列表；无标签时为空数组；每项只返回 name。","items":{"$ref":"#/$defs/BilibiliTopicTagData"},"title":"Topic Tags","type":"array"}},"required":["bvid","aid","title","description","publish_time","cover_image_url","share_url","view_count","like_count","collect_count","comment_count","danmaku_count","author","duration_seconds","page_count","pages","coin_count","share_count","topic_tags"],"title":"BilibiliVideoDetailData","type":"object"},"BilibiliVideoPageData":{"properties":{"page_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"分 P 序号；不可用时为 null。","title":"Page Number"},"title":{"description":"该分 P 标题；不可用时为空字符串。","title":"Title","type":"string"},"duration_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该分 P 时长，单位秒；不可用时为 null。","title":"Duration Seconds"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该分 P 画面宽度；不可用时为 null。","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该分 P 画面高度；不可用时为 null。","title":"Height"},"first_frame_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"该分 P 首帧图链接；不可用时为 null。","title":"First Frame Url"}},"required":["page_number","title","duration_seconds","width","height","first_frame_url"],"title":"BilibiliVideoPageData","type":"object"}},"properties":{"content_id":{"description":"统一内容 ID；视频固定返回 bvid（BV...）；专栏/动态固定返回 post_id，且与 post.post_id 相同。可作为内容详情或内容评论接口的 content_id 字段。","title":"Content Id","type":"string"},"content_type":{"description":"内容类型：video=视频详情；article=专栏详情；dynamic=动态详情，包含带图片的动态。","enum":["video","article","dynamic"],"title":"Content Type","type":"string","x-socialdatax-enum-labels":{"video":"视频"}},"video":{"anyOf":[{"$ref":"#/$defs/BilibiliVideoDetailData"},{"type":"null"}],"description":"视频详情；当输入解析为普通视频链接时返回，否则为 null。"},"post":{"anyOf":[{"$ref":"#/$defs/BilibiliPostDetailData"},{"type":"null"}],"description":"专栏/动态详情；当输入解析为专栏或动态链接时返回，否则为 null。"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["content_id","content_type","video","post","points"],"title":"BilibiliContentDetailData","type":"object"},"example":{"content_id":"BV1xx411c7mD","content_type":"video","video":{"bvid":"BV1xx411c7mD","aid":"123","title":"新手露营装备清单","description":"适合周末露营的帐篷、炉具和收纳建议。","publish_time":1700000000,"cover_image_url":"https://example.invalid/bilibili-cover.jpg","share_url":"https://www.bilibili.com/video/BV1xx411c7mD","view_count":100,"like_count":2,"collect_count":4,"danmaku_count":5,"author":{"user_id":"402951597","name":"露营频道","avatar_url":"https://example.invalid/avatar.jpg","profile_url":"https://space.bilibili.com/402951597"},"duration_seconds":556,"page_count":1,"pages":[{"page_number":1,"title":"新手露营装备清单","duration_seconds":556,"width":1920,"height":1080,"first_frame_url":"https://example.invalid/bilibili-first-frame.jpg"}],"coin_count":6,"comment_count":7,"share_count":8,"topic_tags":[{"name":"露营"}]},"post":null,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["bilibili_get_content_detail_by_id","bilibili_get_content_detail_by_url"]},{"operation_id":"bilibili_get_video_download_links","platform_id":"bilibili","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/bilibili/video/download-links","summary":"获取 Bilibili 视频下载地址","description":"按视频链接或分享文案获取本地下载和合并所需的 headers、轨道地址 和合并建议；多 P 视频链接会按 URL 中的 p 参数选择对应分 P。默认返回服务端当前可用的最高清晰度。","tags":["视频下载","哔哩哔哩"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"url":{"title":"Url","type":"string","description":"Bilibili 视频链接、短链接或包含视频链接的分享文案；用于获取本地下载和合并所需的地址信息。不要传用户主页链接、专栏/动态链接、BV 号或 aid。"}},"required":["url"],"title":"InternalVideoDownloadLinksRequest","type":"object"},"example":{"url":"https://www.bilibili.com/video/BV1xx411c7mD"}},"response":{"content_type":"application/json","schema":{"$defs":{"BilibiliDownloadManifestData":{"properties":{"mode":{"const":"dash","description":"下载地址模式：dash=音视频分轨。","title":"Mode","type":"string"},"tracks":{"description":"需要下载的轨道列表。","items":{"$ref":"#/$defs/BilibiliDownloadTrackData"},"title":"Tracks","type":"array"},"merge":{"$ref":"#/$defs/BilibiliDownloadMergeData","description":"本地合并建议。"}},"required":["mode","tracks","merge"],"title":"BilibiliDownloadManifestData","type":"object"},"BilibiliDownloadMergeData":{"properties":{"container":{"description":"建议合并后的容器格式。","title":"Container","type":"string"},"strategy":{"const":"ffmpeg_copy","description":"本地合并策略：ffmpeg_copy=用 ffmpeg 直接封装。","title":"Strategy","type":"string"}},"required":["container","strategy"],"title":"BilibiliDownloadMergeData","type":"object"},"BilibiliDownloadTrackData":{"properties":{"type":{"description":"轨道类型：video=视频轨；audio=音频轨。","enum":["video","audio"],"title":"Type","type":"string"},"url":{"description":"主下载地址；本地下载时需要配合 headers 使用。","title":"Url","type":"string"},"backup_urls":{"description":"备用下载地址列表；无备用地址时为空数组。","items":{"type":"string"},"title":"Backup Urls","type":"array"},"codec":{"description":"编码信息；不可用时为空字符串。","title":"Codec","type":"string"},"quality":{"description":"清晰度描述；音频轨通常为空字符串。","title":"Quality","type":"string"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频宽度；音频轨或不可用时为 null。","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频高度；音频轨或不可用时为 null。","title":"Height"},"ext":{"description":"建议保存的文件扩展名，如 m4s 或 mp4。","title":"Ext","type":"string"},"bandwidth":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"码率；不可用时为 null。","title":"Bandwidth"}},"required":["type","url","backup_urls","codec","quality","width","height","ext","bandwidth"],"title":"BilibiliDownloadTrackData","type":"object"}},"properties":{"platform":{"const":"bilibili","description":"平台标识，固定为 bilibili。","title":"Platform","type":"string"},"title":{"description":"视频标题；不可用时为空字符串。","title":"Title","type":"string"},"bvid":{"description":"B 站视频 BV 号；读取视频详情或视频评论时，优先作为 content_id 字段使用。","title":"Bvid","type":"string"},"aid":{"description":"B 站视频数字 aid，即老 AV 号的数字部分；仅作为备用视频标识。没有 bvid 时，建议拼成 av{aid} 作为 content_id 传入，避免裸数字和专栏/动态 ID 混淆。","title":"Aid","type":"string"},"cid":{"description":"本次下载地址对应的视频分 P cid。","title":"Cid","type":"string"},"page":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"本次下载地址对应的分 P 序号；不可用时为 null。","title":"Page"},"selected_quality":{"description":"服务端默认选择的清晰度描述；不可用时为空字符串。","title":"Selected Quality","type":"string"},"expires_at":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"下载地址过期时间，秒级 Unix 时间戳；无法可靠判断时为 null。","title":"Expires At"},"headers":{"additionalProperties":{"type":"string"},"description":"本地下载时建议携带的 HTTP headers，通常包含 Referer 和 User-Agent。","title":"Headers","type":"object"},"download_manifest":{"$ref":"#/$defs/BilibiliDownloadManifestData","description":"本地 CLI 下载和合并所需的 manifest。"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["platform","title","bvid","aid","cid","page","selected_quality","expires_at","headers","download_manifest","points"],"title":"BilibiliVideoDownloadLinksData","type":"object"},"example":{"platform":"bilibili","title":"新手露营装备清单","bvid":"BV1xx411c7mD","aid":"123","cid":"124866393","page":1,"selected_quality":"1080P 高清","expires_at":1784109400,"headers":{"Referer":"https://www.bilibili.com/","User-Agent":"Mozilla/5.0"},"download_manifest":{"mode":"dash","tracks":[{"type":"video","url":"https://example.invalid/video.m4s","backup_urls":[],"codec":"avc1.640028","quality":"1080P 高清","width":1920,"height":1080,"ext":"m4s","bandwidth":1800000},{"type":"audio","url":"https://example.invalid/audio.m4s","backup_urls":[],"codec":"mp4a.40.2","quality":"","width":null,"height":null,"ext":"m4s","bandwidth":128000}],"merge":{"container":"mp4","strategy":"ffmpeg_copy"}},"points":{"cost":10,"balance":990}}},"related_mcp_tools":["bilibili_get_video_download_links"]},{"operation_id":"bilibili_get_content_comments","platform_id":"bilibili","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/bilibili/content/comment/list","summary":"读取 Bilibili 内容一级评论","description":"按内容 ID 或内容链接读取公开 Bilibili 视频、专栏或动态的一级评论，返回评论作者、内容、评论图片、回复入口字段和下一页分页令牌。","tags":["评论","哔哩哔哩"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"description":"url 和 content_id 必须且只能传一个；用于读取 Bilibili 视频、专栏或动态的一级评论。","properties":{"url":{"default":"","title":"Url","type":"string","description":"Bilibili 视频、专栏或动态链接，t.bilibili.com 动态链接、短链接或包含链接的分享文案；用于获取该内容的一级评论；不要传用户主页链接、BV 号、aid、纯数字 ID 或 comment_id。"},"content_id":{"default":"","title":"Content Id","type":"string","description":"Bilibili 内容 ID；用于获取一级评论。视频优先传 bvid（BV...）；如果只有视频 aid，建议传 av{aid}（如 av116668525186915）以明确表示视频评论区；不建议直接传裸数字 aid，因为裸数字也可能是专栏/动态评论区 ID。专栏可传 cv 专栏 ID（如 cv9689859），动态/opus 可传 /opus/{id} 或 /dynamic/{id} 路径中的数字 post_id。不要传 comment_object_id、comment_id、链接或分享文案。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"Bilibili 一级评论分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一内容、同一排序和同一入口的评论分页链路；content_id 入口返回的 token 只能继续用于 content_id 字段，url 入口返回的 token 只能继续用于 url 字段；不能跨接口、入口、内容或排序复用。"},"sort_type":{"default":"hot","enum":["hot","time_descending"],"title":"Sort Type","type":"string","description":"评论排序方式：hot=最热，time_descending=最新。默认 hot。","x-socialdatax-enum-labels":{"hot":"热门评论流","time_descending":"当前可返回范围内最新评论优先"}}},"title":"InternalContentCommentsRequest","type":"object"},"example":{"content_id":"BV1xx411c7mD","page_token":"","sort_type":"hot"}},"response":{"content_type":"application/json","schema":{"$defs":{"BilibiliCommentAuthorData":{"properties":{"user_id":{"description":"B 站用户 user_id；用于标识作者或用户。","title":"User Id","type":"string"},"name":{"description":"评论作者名称；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"评论作者头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"B 站用户主页链接；可用于打开用户主页；不可用时为 null。","title":"Profile Url"},"member_level":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论作者 B 站会员等级；不可用时为 null。","title":"Member Level"}},"required":["user_id","name","avatar_url","profile_url","member_level"],"title":"BilibiliCommentAuthorData","type":"object"},"BilibiliContentCommentItemData":{"properties":{"comment_id":{"description":"B 站一级评论 ID；可用于继续查询该评论回复。","title":"Comment Id","type":"string"},"comment_object_id":{"description":"被评论对象 ID；用户已提供时直接使用，否则从一级评论结果复制 comment_object_id；必须与同一条一级评论的 comment_id 和 comment_object_type 一起使用；不要自行构造。","title":"Comment Object Id","type":"string"},"comment_object_type":{"description":"被评论对象类型编号；用户已提供时直接使用，否则从一级评论结果复制 comment_object_type；必须与同一条一级评论的 comment_id 和 comment_object_id 一起使用；不要自行构造。","title":"Comment Object Type","type":"integer"},"content":{"description":"评论内容。","title":"Content","type":"string"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论点赞数；不可用时为 null。","title":"Like Count"},"reply_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"当前接口可获取的评论回复数；0 表示没有可获取回复；大于 0 时可使用该评论的 comment_id、comment_object_id 和 comment_object_type 获取回复；null 表示当前页未返回可判断的回复数，不代表一定没有回复。","title":"Reply Count"},"image_urls":{"description":"评论图片链接列表；无图片时为空数组。","items":{"type":"string"},"title":"Image Urls","type":"array"},"ip_location":{"description":"评论发布时的 IP 属地；没有时为空字符串。","title":"Ip Location","type":"string"},"author":{"$ref":"#/$defs/BilibiliCommentAuthorData","description":"评论作者信息。"}},"required":["comment_id","comment_object_id","comment_object_type","content","publish_time","like_count","reply_count","image_urls","ip_location","author"],"title":"BilibiliContentCommentItemData","type":"object"}},"properties":{"items":{"description":"当前页内容评论列表。","items":{"$ref":"#/$defs/BilibiliContentCommentItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多一级评论。继续获取一级评论下一页时，必须将返回的完整 next_page_token 原样作为 page_token 传回，并沿用本次调用入口；content_id 入口返回的 token 只能继续用于 content_id 字段，url 入口返回的 token 只能继续用于 url 字段。不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容；不能跨接口、入口、内容或排序复用。","title":"Next Page Token","type":"string"},"comment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论总数，通常包含一级评论和回复；不是当前页数量，也不等于 items 中一级评论条数；不可用时为 null。","title":"Comment Count"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","comment_count","points"],"title":"BilibiliContentCommentsResult","type":"object"},"example":{"items":[{"comment_id":"1124008638","comment_object_id":"123456789","comment_object_type":1,"content":"这个装备清单很实用，周末准备照着试一次。","publish_time":1700001200,"like_count":12,"reply_count":3,"image_urls":[],"ip_location":"上海","author":{"user_id":"18888888","name":"去山里露营","avatar_url":"https://example.invalid/comment-avatar.jpg","profile_url":"https://space.bilibili.com/18888888","member_level":5}}],"next_page_token":"","comment_count":128,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["bilibili_get_content_comments_by_id","bilibili_get_content_comments_by_url"]},{"operation_id":"bilibili_get_content_comment_replies","platform_id":"bilibili","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/bilibili/content/comment/reply/list","summary":"读取 Bilibili 评论回复","description":"按一级评论结果返回的 comment_object_id、comment_object_type 和 comment_id 读取该一级评论下的回复列表。","tags":["评论","哔哩哔哩"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"comment_object_id":{"title":"Comment Object Id","type":"string","description":"被评论对象 ID；用户已提供时直接使用，否则从一级评论结果复制 comment_object_id；必须与同一条一级评论的 comment_id 和 comment_object_type 一起使用；不要自行构造。"},"comment_object_type":{"title":"Comment Object Type","type":"integer","description":"被评论对象类型编号；用户已提供时直接使用，否则从一级评论结果复制 comment_object_type；必须与同一条一级评论的 comment_id 和 comment_object_id 一起使用；不要自行构造。"},"comment_id":{"title":"Comment Id","type":"string","description":"B 站一级评论 ID；用户已提供时直接使用，否则可从一级评论结果 items[].comment_id 复制；不要自行构造，不要传评论回复项的 comment_id。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"Bilibili 评论回复分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一内容下同一条一级评论的回复分页链路，也就是同一 comment_object_id、comment_object_type 和一级 comment_id；不能跨接口、内容或评论复用。"}},"required":["comment_object_id","comment_object_type","comment_id"],"title":"InternalContentCommentRepliesRequest","type":"object"},"example":{"comment_object_id":"123456789","comment_object_type":1,"comment_id":"1124008638","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"BilibiliCommentAuthorData":{"properties":{"user_id":{"description":"B 站用户 user_id；用于标识作者或用户。","title":"User Id","type":"string"},"name":{"description":"评论作者名称；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"评论作者头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"B 站用户主页链接；可用于打开用户主页；不可用时为 null。","title":"Profile Url"},"member_level":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论作者 B 站会员等级；不可用时为 null。","title":"Member Level"}},"required":["user_id","name","avatar_url","profile_url","member_level"],"title":"BilibiliCommentAuthorData","type":"object"},"BilibiliCommentReplyToAuthorData":{"properties":{"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"被回复用户 user_id；不可用时为 null。","title":"User Id"},"name":{"description":"被回复用户名称；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"被回复用户头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"B 站用户主页链接；可用于打开用户主页；不可用时为 null。","title":"Profile Url"}},"required":["user_id","name","avatar_url","profile_url"],"title":"BilibiliCommentReplyToAuthorData","type":"object"},"BilibiliContentCommentReplyItemData":{"properties":{"comment_id":{"description":"B 站评论回复自身 ID；不是一级评论 ID，不要作为评论回复入口输入。","title":"Comment Id","type":"string"},"parent_comment_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"被回复评论 ID；直接回复一级评论时等于调用输入中的 comment_id；不可用时为 null。","title":"Parent Comment Id"},"content":{"description":"评论回复内容。","title":"Content","type":"string"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论回复发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论回复点赞数；不可用时为 null。","title":"Like Count"},"ip_location":{"description":"评论回复发布时的 IP 属地；没有时为空字符串。","title":"Ip Location","type":"string"},"author":{"$ref":"#/$defs/BilibiliCommentAuthorData","description":"评论回复作者信息。"},"reply_to_author":{"anyOf":[{"$ref":"#/$defs/BilibiliCommentReplyToAuthorData"},{"type":"null"}],"description":"被回复用户信息；不可用时为 null。"}},"required":["comment_id","parent_comment_id","content","publish_time","like_count","ip_location","author","reply_to_author"],"title":"BilibiliContentCommentReplyItemData","type":"object"}},"properties":{"items":{"description":"当前页内容评论回复列表。","items":{"$ref":"#/$defs/BilibiliContentCommentReplyItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多评论回复。继续获取评论回复下一页时，必须将返回的完整 next_page_token 原样作为 page_token 传回；只能用于同一内容下同一条一级评论的回复分页链路，也就是同一 comment_object_id、comment_object_type 和一级 comment_id。不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容；不能跨接口、内容或评论复用。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"BilibiliContentCommentRepliesResult","type":"object"},"example":{"items":[{"comment_id":"1124008640","parent_comment_id":"1124008638","content":"建议先从一日营地开始，装备可以慢慢补。","publish_time":1700001500,"like_count":4,"ip_location":"浙江","author":{"user_id":"19999999","name":"轻量化玩家","avatar_url":"https://example.invalid/reply-avatar.jpg","profile_url":"https://space.bilibili.com/19999999","member_level":4},"reply_to_author":{"user_id":"18888888","name":"去山里露营","avatar_url":"https://example.invalid/comment-avatar.jpg","profile_url":"https://space.bilibili.com/18888888"}}],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["bilibili_get_content_comment_replies_by_comment_id"]},{"operation_id":"bilibili_get_content_likes_and_reposts","platform_id":"bilibili","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/bilibili/content/like-repost/list","summary":"读取 Bilibili 专栏/动态赞与转发","description":"按专栏/动态 post_id 或链接读取公开 Bilibili 专栏/动态的赞与转发动作记录；视频不支持该接口。","tags":["互动列表","哔哩哔哩"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"description":"post_id 和 url 必须且只能传一个；用于读取 Bilibili 专栏/动态赞与转发列表，视频不支持。","properties":{"post_id":{"default":"","title":"Post Id","type":"string","description":"Bilibili 专栏/动态 post_id；即 /opus/{id}、/dynamic/{id} 或 t.bilibili.com/{id} 路径里的数字 ID。也可以从内容详情返回的 post.post_id 复制。专栏搜索结果的 content_id=cv... 不能直接用于赞与转发；从专栏搜索结果出发时，先获取详情，再使用详情里的 post.post_id 或 post.share_url。不要传视频 BV 号、aid、cv 专栏 ID、链接或分享文案。"},"url":{"default":"","title":"Url","type":"string","description":"Bilibili 专栏/动态链接、移动端链接、t.bilibili.com 动态链接、b23.tv 短链接或包含链接的分享文案；支持 /opus/{id}、/dynamic/{id}、t.bilibili.com/{id}、t.bilibili.com/h5/dynamic/detail/{id} 等同一专栏/动态的常见 B 站链接形态。从专栏搜索结果出发时，先获取详情，再使用详情里的 post.share_url 或 post.post_id。不要传视频链接、其他链接或用户主页链接。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"Bilibili 专栏/动态赞与转发列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一专栏/动态的同一 post_id 或同一 url 赞与转发分页链路；继续翻页时必须沿用同一个入口，post_id 入口返回的 token 只能继续配合 post_id 字段使用，url 入口返回的 token 只能继续配合 url 字段使用；不能跨接口或内容复用。"}},"title":"InternalContentLikeRepostsRequest","type":"object"},"example":{"post_id":"488865671698440311","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"BilibiliAuthorData":{"properties":{"user_id":{"description":"B 站用户 user_id；用于标识作者或用户。","title":"User Id","type":"string"},"name":{"description":"B 站用户名称；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"B 站用户主页链接；可用于打开用户主页；不可用时为 null。","title":"Profile Url"}},"required":["user_id","name","avatar_url","profile_url"],"title":"BilibiliAuthorData","type":"object"},"BilibiliContentLikeRepostItemData":{"properties":{"action_type":{"description":"赞与转发动作类型：like=赞，repost=转发，unknown=暂未识别的动作类型。","enum":["like","repost","unknown"],"title":"Action Type","type":"string","x-socialdatax-enum-labels":{"like":"赞","repost":"转发","unknown":"未知动作"}},"action_text":{"description":"B 站展示的互动动作文案，仅用于展示；判断赞或转发时优先使用 action_type；不可用时为空字符串。","title":"Action Text","type":"string"},"description":{"description":"转发说明或互动补充文本；点赞通常为空字符串；不可用时为空字符串。","title":"Description","type":"string"},"user":{"$ref":"#/$defs/BilibiliAuthorData","description":"执行赞或转发动作的互动用户信息。"}},"required":["action_type","action_text","description","user"],"title":"BilibiliContentLikeRepostItemData","type":"object"}},"properties":{"post_id":{"description":"本次赞与转发列表对应的专栏/动态 post_id；可用于后续不带当前 page_token 的新查询。继续当前分页时必须沿用原入口和 next_page_token，不要用本字段切换入口。不是评论 ID、用户 ID 或 cv 专栏 ID。","title":"Post Id","type":"string"},"items":{"description":"当前页赞与转发动作记录列表，每项包含动作类型、B 站展示文案、补充说明和互动用户。","items":{"$ref":"#/$defs/BilibiliContentLikeRepostItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果。继续获取赞与转发下一页时，必须将返回的完整 next_page_token 原样作为 page_token 传回，并沿用本次调用入口；post_id 入口返回的 token 只能继续配合 post_id 字段使用，url 入口返回的 token 只能继续配合 url 字段使用。不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容；不能跨接口、入口或专栏/动态复用。","title":"Next Page Token","type":"string"},"like_repost_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"赞与转发合计总数，不是当前页数量；当前不区分赞和转发分别计数；不可用时为 null。","title":"Like Repost Count"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["post_id","items","next_page_token","like_repost_count","points"],"title":"BilibiliContentLikeRepostsResult","type":"object"},"example":{"post_id":"488865671698440311","items":[{"action_type":"repost","action_text":"转发","description":"这篇露营预算整理很适合新手。","user":{"user_id":"17777777","name":"户外资料夹","avatar_url":"https://example.invalid/reaction-avatar.jpg","profile_url":"https://space.bilibili.com/17777777"}}],"next_page_token":"","like_repost_count":90,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["bilibili_get_content_likes_and_reposts_by_post_id","bilibili_get_content_likes_and_reposts_by_url"]},{"operation_id":"bilibili_get_user_info","platform_id":"bilibili","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/bilibili/user/info","summary":"读取 Bilibili 用户资料","description":"按 user_id 或用户主页链接读取公开 Bilibili 用户资料、公开互动规模和直播状态摘要。","tags":["用户资料","哔哩哔哩"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"description":"user_id 和 profile_url 必须且只能传一个；用于读取 Bilibili 用户资料。","properties":{"user_id":{"default":"","title":"User Id","type":"string","description":"B 站用户 user_id，通常是 space.bilibili.com/{user_id} 路径里的数字 ID；可从搜索、详情、评论或用户资料结果中的 author.user_id 或 user_id 复制；不要传用户主页链接，不要传视频链接、昵称、BV 号或 aid。已有用户主页链接时改填 profile_url 字段。"},"profile_url":{"default":"","title":"Profile Url","type":"string","description":"B 站用户主页链接、短链接或分享文案；不要传 user_id，不要传视频链接、BV 号或 aid；已有 user_id 时改填 user_id 字段。"}},"title":"InternalUserInfoRequest","type":"object"},"example":{"user_id":"402951597"}},"response":{"content_type":"application/json","schema":{"$defs":{"BilibiliUserLiveInfoData":{"properties":{"room_id":{"description":"B 站直播间 ID。","title":"Room Id","type":"string"},"is_live":{"description":"直播间当前是否正在直播。","title":"Is Live","type":"boolean"},"title":{"description":"直播间标题；不可用时为空字符串。","title":"Title","type":"string"},"live_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"直播间页面链接；不可用时为 null。","title":"Live Url"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"直播间封面图链接；不可用时为 null。","title":"Cover Image Url"}},"required":["room_id","is_live","title","live_url","cover_image_url"],"title":"BilibiliUserLiveInfoData","type":"object"}},"properties":{"user_id":{"description":"B 站用户 user_id；用于标识作者或用户。","title":"User Id","type":"string"},"name":{"description":"B 站用户名称；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"B 站用户主页链接；可用于打开用户主页；不可用时为 null。","title":"Profile 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"},"posted_content_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"用户公开投稿总数，对应 B 站空间投稿页的「投稿」总数；不可用时为 null。","title":"Posted Content Count"},"posted_video_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"用户公开投稿视频数量；不可用时为 null。","title":"Posted Video Count"},"posted_image_text_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"用户公开投稿图文数量，对应 B 站空间投稿页的「图文」分类；不可用时为 null。","title":"Posted Image Text Count"},"posted_audio_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"用户公开投稿音频数量；不可用时为 null。","title":"Posted Audio Count"},"received_like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"累计获赞数；不可用时为 null。","title":"Received Like Count"},"video_view_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"累计视频播放数；不可用时为 null。","title":"Video View Count"},"gender":{"description":"用户性别：male 表示男，female 表示女，unknown 表示未知或未公开。","enum":["male","female","unknown"],"title":"Gender","type":"string","x-socialdatax-enum-labels":{"male":"男","female":"女","unknown":"未知"}},"verified":{"description":"是否有 B 站个人或机构认证。","title":"Verified","type":"boolean"},"verification_label":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"B 站认证说明；没有认证或不可用时为 null。","title":"Verification Label"},"charging_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"累计充电人数；未开通或不可用时为 null。","title":"Charging Count"},"charging_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"充电入口链接；不可用时为 null。","title":"Charging Url"},"live_info":{"anyOf":[{"$ref":"#/$defs/BilibiliUserLiveInfoData"},{"type":"null"}],"description":"用户直播状态摘要；没有直播间或不可用时为 null。"},"profile_notice":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"B 站空间公告；没有公告或不可用时为 null。","title":"Profile Notice"},"birthday":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"公开生日，通常为 MM-DD；不可用时为 null。","title":"Birthday"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["user_id","name","avatar_url","profile_url","bio","follower_count","following_count","posted_content_count","posted_video_count","posted_image_text_count","posted_audio_count","received_like_count","video_view_count","gender","verified","verification_label","charging_count","charging_url","live_info","profile_notice","birthday","points"],"title":"BilibiliUserInfoData","type":"object"},"example":{"user_id":"402951597","name":"露营频道","avatar_url":"https://example.invalid/avatar.jpg","profile_url":"https://space.bilibili.com/402951597","bio":"分享露营路线、装备体验和户外安全经验。","follower_count":120000,"following_count":86,"posted_content_count":218,"posted_video_count":170,"posted_image_text_count":42,"posted_audio_count":6,"received_like_count":560000,"video_view_count":8800000,"gender":"unknown","verified":true,"verification_label":"Bilibili 知名户外 UP 主","charging_count":128,"charging_url":"https://space.bilibili.com/402951597/charge","live_info":{"room_id":"22334455","is_live":false,"title":"露营装备答疑","live_url":"https://live.bilibili.com/22334455","cover_image_url":"https://example.invalid/live-cover.jpg"},"profile_notice":"商务合作请通过私信联系。","birthday":"05-20","points":{"cost":10,"balance":990}}},"related_mcp_tools":["bilibili_get_user_info_by_user_id","bilibili_get_user_info_by_profile_url"]},{"operation_id":"bilibili_get_user_posted_videos","platform_id":"bilibili","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/bilibili/user/video/list","summary":"读取 Bilibili 用户发布视频","description":"按 user_id 或用户主页链接读取公开 Bilibili 用户发布视频列表，返回视频摘要和下一页分页令牌。","tags":["用户内容","哔哩哔哩"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"description":"user_id 和 profile_url 必须且只能传一个；用于读取 Bilibili 用户发布视频列表。","properties":{"user_id":{"default":"","title":"User Id","type":"string","description":"B 站用户 user_id，通常是 space.bilibili.com/{user_id} 路径里的数字 ID；可从搜索、详情、评论或用户资料结果中的 author.user_id 或 user_id 复制；不要传用户主页链接，不要传视频链接、昵称、BV 号或 aid。已有用户主页链接时改填 profile_url 字段。"},"profile_url":{"default":"","title":"Profile Url","type":"string","description":"B 站用户主页链接、短链接或分享文案；不要传 user_id，不要传视频链接、BV 号或 aid；已有 user_id 时改填 user_id 字段。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"Bilibili 用户发布视频列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一用户和同一排序方式的视频列表分页链路，不能跨接口、用户或排序复用。"},"sort_type":{"default":"time_descending","enum":["time_descending","view_count_descending","collect_count_descending"],"title":"Sort Type","type":"string","description":"用户发布视频排序方式：time_descending=最新发布，view_count_descending=最多播放，collect_count_descending=最多收藏。","x-socialdatax-enum-labels":{"time_descending":"最新发布","view_count_descending":"最多播放","collect_count_descending":"最多收藏"}}},"title":"InternalUserPostedVideosRequest","type":"object"},"example":{"user_id":"402951597","page_token":"","sort_type":"time_descending"}},"response":{"content_type":"application/json","schema":{"$defs":{"BilibiliUserPostedAuthorData":{"properties":{"user_id":{"description":"B 站用户 user_id；用于标识作者或用户。","title":"User Id","type":"string"},"name":{"description":"B 站用户名称；不可用时为空字符串。","title":"Name","type":"string"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"B 站用户主页链接；可用于打开用户主页；不可用时为 null。","title":"Profile Url"}},"required":["user_id","name","profile_url"],"title":"BilibiliUserPostedAuthorData","type":"object"},"BilibiliUserPostedVideoData":{"properties":{"content_id":{"description":"可直接作为内容详情或内容评论接口的 content_id 输入；用户发布视频列表这里固定返回视频 bvid（BV...）。","title":"Content Id","type":"string"},"title":{"description":"视频标题；不可用时为空字符串。","title":"Title","type":"string"},"description":{"description":"视频简介；不可用时为空字符串。","title":"Description","type":"string"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"duration_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频时长，单位秒；不可用时为 null。","title":"Duration Seconds"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"视频封面图链接；不可用时为 null。","title":"Cover Image Url"},"share_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"视频分享页链接；不可用时为 null。","title":"Share Url"},"view_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"播放数；不可用时为 null。","title":"View Count"},"comment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论数；不可用时为 null。","title":"Comment Count"},"danmaku_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"弹幕数；不可用时为 null。","title":"Danmaku Count"},"author":{"$ref":"#/$defs/BilibiliUserPostedAuthorData","description":"视频作者信息。"}},"required":["content_id","title","description","publish_time","duration_seconds","cover_image_url","share_url","view_count","comment_count","danmaku_count","author"],"title":"BilibiliUserPostedVideoData","type":"object"}},"properties":{"items":{"description":"当前页用户发布视频列表。","items":{"$ref":"#/$defs/BilibiliUserPostedVideoData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多用户发布视频。继续获取下一页时，必须将返回的完整 next_page_token 原样作为 page_token 传回；只能用于同一用户和同一排序方式的视频列表分页链路。不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容；不能跨接口、用户或排序复用。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"BilibiliUserPostedVideosResult","type":"object"},"example":{"items":[{"content_id":"BV1xx411c7mD","title":"新手露营装备清单","description":"适合周末露营的帐篷、炉具和收纳建议。","publish_time":1700000000,"duration_seconds":556,"cover_image_url":"https://example.invalid/bilibili-cover.jpg","share_url":"https://www.bilibili.com/video/BV1xx411c7mD","view_count":100,"comment_count":7,"danmaku_count":5,"author":{"user_id":"402951597","name":"露营频道","profile_url":"https://space.bilibili.com/402951597"}}],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["bilibili_get_user_posted_videos_by_user_id","bilibili_get_user_posted_videos_by_profile_url"]},{"operation_id":"bilibili_get_user_posted_articles","platform_id":"bilibili","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/bilibili/user/article/list","summary":"读取 Bilibili 用户发布单篇专栏","description":"按 user_id 或用户主页链接读取公开 Bilibili 用户发布单篇专栏列表，返回单篇专栏摘要和下一页分页令牌。","tags":["用户内容","哔哩哔哩"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"description":"user_id 和 profile_url 必须且只能传一个；用于读取 Bilibili 用户发布单篇专栏列表。","properties":{"user_id":{"default":"","title":"User Id","type":"string","description":"B 站用户 user_id，通常是 space.bilibili.com/{user_id} 路径里的数字 ID；可从搜索、详情、评论或用户资料结果中的 author.user_id 或 user_id 复制；不要传用户主页链接，不要传视频链接、昵称、BV 号或 aid。已有用户主页链接时改填 profile_url 字段。"},"profile_url":{"default":"","title":"Profile Url","type":"string","description":"B 站用户主页链接、短链接或分享文案；不要传 user_id，不要传视频链接、BV 号或 aid；已有 user_id 时改填 user_id 字段。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"Bilibili 用户发布单篇专栏列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一用户的单篇专栏列表分页链路，不能跨接口或用户复用。"}},"title":"InternalUserPostedArticlesRequest","type":"object"},"example":{"user_id":"402951597","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"BilibiliUserPostedArticleData":{"properties":{"post_id":{"description":"B 站单篇专栏 post_id，即 /opus/{id} 路径中的数字 ID；可作为 内容详情或内容评论接口的 content_id 使用，也可作为赞与转发接口的 post_id 使用；不是 cv、BV、评论 ID。","title":"Post Id","type":"string"},"description":{"description":"单篇专栏列表页展示文本，可能是正文或摘要，可能被平台截断；不可用时为空字符串。","title":"Description","type":"string"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"单篇专栏列表页封面图片 URL；不代表完整图片列表；不可用时为 null。","title":"Cover Image Url"},"share_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"单篇专栏分享链接；不可用时为 null。","title":"Share Url"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"单篇专栏点赞数；不可用时为 null。","title":"Like Count"}},"required":["post_id","description","cover_image_url","share_url","like_count"],"title":"BilibiliUserPostedArticleData","type":"object"}},"properties":{"items":{"description":"当前页用户发布单篇专栏列表。","items":{"$ref":"#/$defs/BilibiliUserPostedArticleData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多用户发布单篇专栏。继续获取下一页时，必须将返回的完整 next_page_token 原样作为 page_token 传回；只能用于同一用户的单篇专栏列表分页链路。不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容；不能跨接口或用户复用。","title":"Next Page Token","type":"string"},"article_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"用户主页公开单篇专栏总数；不是当前页数量；不可用时为 null。","title":"Article Count"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","article_count","points"],"title":"BilibiliUserPostedArticlesResult","type":"object"},"example":{"items":[{"post_id":"488865671698440311","description":"从营地选择、露营装备到安全注意事项的经验整理。","cover_image_url":"https://example.invalid/bilibili-article-cover.jpg","share_url":"https://www.bilibili.com/opus/488865671698440311","like_count":90}],"next_page_token":"","article_count":12,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["bilibili_get_user_posted_articles_by_user_id","bilibili_get_user_posted_articles_by_profile_url"]},{"operation_id":"bilibili_get_user_posted_dynamics","platform_id":"bilibili","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/bilibili/user/dynamic/list","summary":"读取 Bilibili 用户发布动态","description":"按 user_id 或用户主页链接读取公开 Bilibili 用户发布动态列表，返回动态摘要和下一页分页令牌。","tags":["用户内容","哔哩哔哩"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"description":"user_id 和 profile_url 必须且只能传一个；用于读取 Bilibili 用户发布动态列表。","properties":{"user_id":{"default":"","title":"User Id","type":"string","description":"B 站用户 user_id，通常是 space.bilibili.com/{user_id} 路径里的数字 ID；可从搜索、详情、评论或用户资料结果中的 author.user_id 或 user_id 复制；不要传用户主页链接，不要传视频链接、昵称、BV 号或 aid。已有用户主页链接时改填 profile_url 字段。"},"profile_url":{"default":"","title":"Profile Url","type":"string","description":"B 站用户主页链接、短链接或分享文案；不要传 user_id，不要传视频链接、BV 号或 aid；已有 user_id 时改填 user_id 字段。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"Bilibili 用户发布动态列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一用户的动态列表分页链路，不能跨接口或用户复用。"}},"title":"InternalUserPostedDynamicsRequest","type":"object"},"example":{"profile_url":"https://space.bilibili.com/402951597","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"BilibiliUserPostedDynamicData":{"properties":{"post_id":{"description":"B 站动态 post_id，即 /opus/{id}、/dynamic/{id} 或 t.bilibili.com/{id} 中的数字 ID；可作为 内容详情或内容评论接口的 content_id 使用，也可作为赞与转发接口的 post_id 使用；不是 cv、BV、评论 ID。","title":"Post Id","type":"string"},"description":{"description":"动态列表页展示文本，可能是正文或摘要，可能被平台截断；不可用时为空字符串。","title":"Description","type":"string"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"动态列表页封面图片 URL；不代表完整图片列表；不可用时为 null。","title":"Cover Image Url"},"share_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"动态分享链接；不可用时为 null。","title":"Share Url"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"动态点赞数；不可用时为 null。","title":"Like Count"}},"required":["post_id","description","cover_image_url","share_url","like_count"],"title":"BilibiliUserPostedDynamicData","type":"object"}},"properties":{"items":{"description":"当前页用户发布动态列表。","items":{"$ref":"#/$defs/BilibiliUserPostedDynamicData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多用户发布动态。继续获取下一页时，必须将返回的完整 next_page_token 原样作为 page_token 传回；只能用于同一用户的动态列表分页链路。不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容；不能跨接口或用户复用。","title":"Next Page Token","type":"string"},"dynamic_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"用户主页公开动态数量；不是当前页数量；不可用时为 null。","title":"Dynamic Count"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","dynamic_count","points"],"title":"BilibiliUserPostedDynamicsResult","type":"object"},"example":{"items":[{"post_id":"1216450225607016448","description":"周末营地实拍，天气很好。","cover_image_url":"https://example.invalid/bilibili-dynamic-cover.jpg","share_url":"https://www.bilibili.com/opus/1216450225607016448","like_count":3693}],"next_page_token":"","dynamic_count":34,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["bilibili_get_user_posted_dynamics_by_user_id","bilibili_get_user_posted_dynamics_by_profile_url"]}]},{"surface":"mcp","status":"available","endpoint":"https://mcp.socialdatax.com/bilibili/mcp","authentication":{"required":true},"capabilities_resource":"bilibili://guides/tool-capabilities","related_http_operation_ids":["bilibili_search_videos","bilibili_search_articles","bilibili_get_content_detail","bilibili_get_video_download_links","bilibili_get_content_comments","bilibili_get_content_comment_replies","bilibili_get_content_likes_and_reposts","bilibili_get_user_info","bilibili_get_user_posted_videos","bilibili_get_user_posted_articles","bilibili_get_user_posted_dynamics"]}]},{"platform_id":"weibo","label":"微博","english_label":"Weibo","status":"available","surfaces":[{"surface":"http","status":"available","base_path":"/socialdatax/api/v1/weibo","description":"公开微博 HTTP API 提供热搜、帖子搜索、详情、评论、点赞、转发和用户相关核心接口。","operations":[{"operation_id":"weibo_get_hot_search_list","platform_id":"weibo","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/weibo/hot/search/list","summary":"读取微博热搜","description":"读取微博热搜列表，返回排名、标题和热度值。","tags":["内容搜索","搜索热榜","微博"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{},"title":"InternalHotSearchListRequest","type":"object"},"example":{}},"response":{"content_type":"application/json","schema":{"$defs":{"WeiboHotSearchItemData":{"properties":{"rank":{"description":"热搜排名。","title":"Rank","type":"integer"},"title":{"description":"热搜标题。","title":"Title","type":"string"},"hot_value":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"热度值；不可用时为 null。","title":"Hot Value"}},"required":["rank","title","hot_value"],"title":"WeiboHotSearchItemData","type":"object"}},"properties":{"items":{"description":"微博热搜条目列表。","items":{"$ref":"#/$defs/WeiboHotSearchItemData"},"title":"Items","type":"array"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","points"],"title":"WeiboHotSearchResult","type":"object"},"example":{"items":[{"rank":1,"title":"湖人交易","hot_value":987654}],"points":{"cost":10,"balance":990}}},"related_mcp_tools":["weibo_get_hot_search_list"]},{"operation_id":"weibo_search_posts","platform_id":"weibo","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/weibo/post/search","summary":"搜索微博帖子","description":"按关键词搜索公开微博帖子，返回结构化帖子摘要、话题标签和下一页分页令牌。","tags":["内容搜索","微博"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"keyword":{"title":"Keyword","type":"string","description":"微博帖子搜索词，可传关键词或短语；不要传帖子链接、用户主页链接、post_id、user_id 或 page_token。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"微博搜索分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌，只能用于同一关键词的微博搜索分页链路，不能跨关键词复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成。"}},"required":["keyword"],"title":"InternalPostSearchRequest","type":"object"},"example":{"keyword":"露营","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"WeiboAuthorData":{"properties":{"user_id":{"description":"微博用户 user_id；不可用时为空字符串；非空时可作为用户资料或用户帖子列表接口输入。","title":"User Id","type":"string"},"name":{"description":"微博用户名称；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"微博用户主页链接；可用于打开用户主页；不可用时为 null；需要继续查询用户资料或用户帖子列表时优先使用非空 user_id。","title":"Profile Url"}},"required":["user_id","name","avatar_url","profile_url"],"title":"WeiboAuthorData","type":"object"},"WeiboImageData":{"properties":{"url":{"description":"图片链接。","title":"Url","type":"string"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片宽度，像素；不可用时为 null。","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片高度，像素；不可用时为 null。","title":"Height"}},"required":["url","width","height"],"title":"WeiboImageData","type":"object"},"WeiboPostItemData":{"properties":{"post_id":{"description":"微博帖子长 ID，可作为详情、评论、点赞或转发接口输入；查询评论回复时需与同一条一级评论的 comment_id 同时传入。","title":"Post Id","type":"string"},"content":{"description":"微博帖子正文；不可用时为空字符串。","title":"Content","type":"string"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"post_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"微博帖子页面链接；需要打开帖子网页时优先使用此字段；不可用时为 null；不要自行拼接链接。","title":"Post Url"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"点赞数；不可用时为 null。","title":"Like Count"},"comment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论数；不可用时为 null。","title":"Comment Count"},"repost_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"转发数；不可用时为 null。","title":"Repost Count"},"play_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"帖子内视频播放数；没有视频或暂不可用时为 null，不是帖子浏览数。","title":"Play Count"},"image_urls":{"description":"图片链接列表；无图时为空数组。","items":{"type":"string"},"title":"Image Urls","type":"array"},"images":{"description":"图片列表，包含链接及宽高；无图时为空数组。","items":{"$ref":"#/$defs/WeiboImageData"},"title":"Images","type":"array"},"topic_tags":{"description":"微博帖子话题标签列表；无标签时为空数组。","items":{"$ref":"#/$defs/WeiboTopicTagData"},"title":"Topic Tags","type":"array"},"author":{"anyOf":[{"$ref":"#/$defs/WeiboAuthorData"},{"type":"null"}],"description":"帖子作者信息；不可用时为 null。"}},"required":["post_id","content","publish_time","post_url","like_count","comment_count","repost_count","play_count","image_urls","images","topic_tags","author"],"title":"WeiboPostItemData","type":"object"},"WeiboTopicTagData":{"additionalProperties":false,"properties":{"name":{"description":"话题标签名称。","title":"Name","type":"string"}},"required":["name"],"title":"WeiboTopicTagData","type":"object"}},"properties":{"items":{"description":"当前页微博帖子列表。","items":{"$ref":"#/$defs/WeiboPostItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；next_page_token 只能用于同一能力和同一分页链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"WeiboPostListResult","type":"object"},"example":{"items":[{"post_id":"5304256793935938","content":"武汉周边2H，找到了湖北小“阿勒泰”，带娃来露营。杨山河吧真的是武汉周边即免费又能玩水露营的地方。","publish_time":1780116830,"post_url":"https://weibo.com/6858679534/R1MJNgvUS","like_count":145,"comment_count":12,"repost_count":5,"play_count":null,"image_urls":["https://example.invalid/weibo-image.jpg"],"images":[{"url":"https://example.invalid/weibo-image.jpg","width":1080,"height":720}],"topic_tags":[{"name":"露营"}],"author":{"user_id":"6858679534","name":"乎然Mua_","avatar_url":"https://example.invalid/weibo-avatar.jpg","profile_url":"https://weibo.com/u/6858679534"}}],"next_page_token":"opaque-weibo-search-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["weibo_search_posts"]},{"operation_id":"weibo_get_post_detail","platform_id":"weibo","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/weibo/post/detail","summary":"读取微博帖子详情","description":"按微博帖子长 ID 或帖子链接读取公开帖子详情，返回正文、话题标签、图片、视频、互动指标和作者信息。","tags":["内容详情","微博"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"post_id":{"default":"","title":"Post Id","type":"string","description":"微博帖子长 ID；可从搜索、详情、转发或用户帖子列表结果中的 post_id 复用。"},"post_url":{"default":"","title":"Post Url","type":"string","description":"微博帖子页面链接、短链接或包含帖子链接的分享文案；不要传用户主页链接或 post_id。"}},"title":"InternalPostDetailRequest","type":"object","description":"请求体必须且只能选择一种微博帖子入口：传 post_id，或传 post_url。"},"example":{"post_id":"5303511279471092"}},"response":{"content_type":"application/json","schema":{"$defs":{"WeiboAuthorData":{"properties":{"user_id":{"description":"微博用户 user_id；不可用时为空字符串；非空时可作为用户资料或用户帖子列表接口输入。","title":"User Id","type":"string"},"name":{"description":"微博用户名称；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"微博用户主页链接；可用于打开用户主页；不可用时为 null；需要继续查询用户资料或用户帖子列表时优先使用非空 user_id。","title":"Profile Url"}},"required":["user_id","name","avatar_url","profile_url"],"title":"WeiboAuthorData","type":"object"},"WeiboImageData":{"properties":{"url":{"description":"图片链接。","title":"Url","type":"string"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片宽度，像素；不可用时为 null。","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片高度，像素；不可用时为 null。","title":"Height"}},"required":["url","width","height"],"title":"WeiboImageData","type":"object"},"WeiboTopicTagData":{"additionalProperties":false,"properties":{"name":{"description":"话题标签名称。","title":"Name","type":"string"}},"required":["name"],"title":"WeiboTopicTagData","type":"object"},"WeiboVideoData":{"properties":{"video_page_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"微博视频页面链接；不可用时为 null。","title":"Video Page Url"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"视频标题；不可用时为 null。","title":"Title"},"video_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"微博视频 ID；不可用时为 null。","title":"Video Id"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频时长，单位毫秒；不可用时为 null。","title":"Duration Ms"},"video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"视频播放链接；不可用时为 null。","title":"Video Url"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"视频封面图链接；不可用时为 null。","title":"Cover Image Url"},"orientation":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"视频方向信息；不可用时为 null。","title":"Orientation"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频像素宽度；不可用时为 null。","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频像素高度；不可用时为 null。","title":"Height"}},"required":["video_page_url","title","video_id","duration_ms","video_url","cover_image_url","orientation","width","height"],"title":"WeiboVideoData","type":"object"}},"properties":{"post_id":{"description":"微博帖子长 ID，可作为详情、评论、点赞或转发接口输入；查询评论回复时需与同一条一级评论的 comment_id 同时传入。","title":"Post Id","type":"string"},"content":{"description":"微博帖子正文；不可用时为空字符串。","title":"Content","type":"string"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"post_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"微博帖子页面链接；需要打开帖子网页时优先使用此字段；不可用时为 null；不要自行拼接链接。","title":"Post Url"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"点赞数；不可用时为 null。","title":"Like Count"},"comment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论数；不可用时为 null。","title":"Comment Count"},"repost_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"转发数；不可用时为 null。","title":"Repost Count"},"play_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"帖子内视频播放数；没有视频或暂不可用时为 null，不是帖子浏览数。","title":"Play Count"},"image_urls":{"description":"图片链接列表；无图时为空数组。","items":{"type":"string"},"title":"Image Urls","type":"array"},"images":{"description":"图片列表，包含链接及宽高；无图时为空数组。","items":{"$ref":"#/$defs/WeiboImageData"},"title":"Images","type":"array"},"topic_tags":{"description":"微博帖子话题标签列表；无标签时为空数组。","items":{"$ref":"#/$defs/WeiboTopicTagData"},"title":"Topic Tags","type":"array"},"author":{"anyOf":[{"$ref":"#/$defs/WeiboAuthorData"},{"type":"null"}],"description":"帖子作者信息；不可用时为 null。"},"video":{"anyOf":[{"$ref":"#/$defs/WeiboVideoData"},{"type":"null"}],"description":"视频信息；无视频时为 null。"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["post_id","content","publish_time","post_url","like_count","comment_count","repost_count","play_count","image_urls","images","topic_tags","author","video","points"],"title":"WeiboPostDetailData","type":"object"},"example":{"post_id":"5303511279471092","content":"露营装备清单和周末路线讨论正在升温。","publish_time":1714316800,"post_url":"https://weibo.com/1682207150/R1tllDJRy","like_count":120,"comment_count":18,"repost_count":4,"play_count":260000,"image_urls":["https://example.invalid/weibo-image.jpg"],"images":[{"url":"https://example.invalid/weibo-image.jpg","width":1080,"height":720}],"topic_tags":[{"name":"露营"}],"author":{"user_id":"1682207150","name":"露营研究所","avatar_url":"https://example.invalid/weibo-avatar.jpg","profile_url":"https://weibo.com/u/1682207150"},"video":{"video_page_url":"https://weibo.com/tv/show/1034:demo","title":"赛后采访","video_id":"1034:demo","duration_ms":12500,"video_url":"https://example.invalid/weibo-video.mp4","cover_image_url":"https://example.invalid/weibo-video-cover.jpg","orientation":"horizontal","width":1920,"height":1080},"points":{"cost":10,"balance":990}}},"related_mcp_tools":["weibo_get_post_detail_by_post_id","weibo_get_post_detail_by_post_url"]},{"operation_id":"weibo_get_post_comments","platform_id":"weibo","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/weibo/post/comment/list","summary":"读取微博帖子一级评论","description":"按微博帖子长 ID 或帖子链接读取公开一级评论，返回评论内容、图片、作者和互动信息，支持热门评论流和当前可返回范围内最新评论优先。","tags":["评论","微博"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"post_id":{"default":"","title":"Post Id","type":"string","description":"微博帖子长 ID；可从搜索、详情、转发或用户帖子列表结果中的 post_id 复用。"},"post_url":{"default":"","title":"Post Url","type":"string","description":"微博帖子页面链接、短链接或包含帖子链接的分享文案；不要传用户主页链接或 post_id。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"微博评论分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；只能用于同一帖子评论分页链路、同一 sort_type，不能跨帖子或排序方式复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"},"sort_type":{"default":"hot","title":"Sort Type","type":"string","description":"微博一级评论排序方式。hot 表示默认热门评论流；time_descending 表示当前可返回范围内最新评论优先。默认 hot。继续翻页时必须与上一页返回 next_page_token 所属的 sort_type 保持一致。","x-socialdatax-enum-labels":{"hot":"热门评论流","time_descending":"当前可返回范围内最新评论优先"}}},"title":"InternalPostCommentListRequest","type":"object","description":"首次请求必须且只能选择一种微博帖子入口：传 post_id，或传 post_url。继续翻页时仍需传同一 post_id 或 post_url，并将上一页返回的完整 next_page_token 原样作为 page_token 传回；sort_type 必须与上一页保持一致。"},"example":{"post_id":"5303511279471092","page_token":"","sort_type":"hot"}},"response":{"content_type":"application/json","schema":{"$defs":{"WeiboAuthorData":{"properties":{"user_id":{"description":"微博用户 user_id；不可用时为空字符串；非空时可作为用户资料或用户帖子列表接口输入。","title":"User Id","type":"string"},"name":{"description":"微博用户名称；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"微博用户主页链接；可用于打开用户主页；不可用时为 null；需要继续查询用户资料或用户帖子列表时优先使用非空 user_id。","title":"Profile Url"}},"required":["user_id","name","avatar_url","profile_url"],"title":"WeiboAuthorData","type":"object"},"WeiboCommentItemData":{"properties":{"post_id":{"description":"微博帖子长 ID；获取该评论下的回复时，需与同一项 comment_id 同时传入评论回复接口。","title":"Post Id","type":"string"},"comment_id":{"description":"微博一级评论 ID；可作为评论回复接口的 comment_id 输入；需与同一项 post_id 同时传入。","title":"Comment Id","type":"string"},"content":{"description":"评论内容。","title":"Content","type":"string"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论点赞数；不可用时为 null。","title":"Like Count"},"has_replies":{"description":"一级评论页当前是否显示有回复；为 true 时，可使用同一项 post_id 和 comment_id 调用评论回复接口。","title":"Has Replies","type":"boolean"},"ip_location":{"description":"评论发布时的 IP 属地；没有时为空字符串。","title":"Ip Location","type":"string"},"image_urls":{"description":"评论图片链接列表；无图片时为空数组。","items":{"type":"string"},"title":"Image Urls","type":"array"},"author":{"anyOf":[{"$ref":"#/$defs/WeiboAuthorData"},{"type":"null"}],"description":"评论作者信息；不可用时为 null。"}},"required":["post_id","comment_id","content","publish_time","like_count","has_replies","ip_location","image_urls","author"],"title":"WeiboCommentItemData","type":"object"}},"properties":{"items":{"description":"当前页一级评论列表。","items":{"$ref":"#/$defs/WeiboCommentItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；next_page_token 只能用于同一能力和同一分页链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。","title":"Next Page Token","type":"string"},"comment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"总评论数，含一级评论与回复；不是当前页 items 数量；不可用时为 null。","title":"Comment Count"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","comment_count","points"],"title":"WeiboCommentResult","type":"object"},"example":{"items":[{"post_id":"5303511279471092","comment_id":"4611693340001972","content":"这场比赛太精彩了。","publish_time":1714316900,"like_count":9,"has_replies":true,"ip_location":"浙江","image_urls":[],"author":{"user_id":"20001","name":"评论作者","avatar_url":"https://example.invalid/comment-avatar.jpg","profile_url":"https://weibo.com/u/20001"}}],"next_page_token":"opaque-weibo-comment-page-token","comment_count":1196,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["weibo_get_post_comments_by_post_id","weibo_get_post_comments_by_post_url"]},{"operation_id":"weibo_get_post_comment_replies","platform_id":"weibo","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/weibo/post/comment/reply/list","summary":"读取微博评论回复","description":"按微博帖子长 ID 和一级评论 ID 读取公开评论回复列表，返回回复内容、图片、作者和下一页分页令牌。","tags":["评论","微博"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"post_id":{"title":"Post Id","type":"string","description":"微博帖子长 ID；调用评论回复接口时必填，需与一级评论 comment_id 同时传入；用户已提供时直接使用，否则从一级评论结果 items[*].post_id 复用。"},"comment_id":{"title":"Comment Id","type":"string","description":"微博一级评论 ID；用户已提供时直接使用，否则可从一级评论结果 items[*].comment_id 复用；需与同一项 post_id 同时传入，不要传评论回复项的 comment_id。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"微博评论回复分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一帖子下同一一级评论的回复分页链路，不能跨帖子或评论复用。"}},"required":["post_id","comment_id"],"title":"InternalPostCommentReplyListRequest","type":"object","description":"请求体必须传微博帖子 post_id 和一级评论 comment_id。继续翻页时仍需传同一 post_id 和 comment_id，并将上一页返回的完整 next_page_token 原样作为 page_token 传回。"},"example":{"post_id":"5303511279471092","comment_id":"4611693340001972","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"WeiboAuthorData":{"properties":{"user_id":{"description":"微博用户 user_id；不可用时为空字符串；非空时可作为用户资料或用户帖子列表接口输入。","title":"User Id","type":"string"},"name":{"description":"微博用户名称；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"微博用户主页链接；可用于打开用户主页；不可用时为 null；需要继续查询用户资料或用户帖子列表时优先使用非空 user_id。","title":"Profile Url"}},"required":["user_id","name","avatar_url","profile_url"],"title":"WeiboAuthorData","type":"object"},"WeiboCommentReplyItemData":{"properties":{"comment_id":{"description":"微博评论回复 ID；这是回复项自身的 comment_id，不要作为评论回复接口入口输入。","title":"Comment Id","type":"string"},"content":{"description":"评论回复内容。","title":"Content","type":"string"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论回复发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论回复点赞数；不可用时为 null。","title":"Like Count"},"ip_location":{"description":"评论回复发布时的 IP 属地；没有时为空字符串。","title":"Ip Location","type":"string"},"image_urls":{"description":"评论回复图片链接列表；无图片时为空数组。","items":{"type":"string"},"title":"Image Urls","type":"array"},"author":{"anyOf":[{"$ref":"#/$defs/WeiboAuthorData"},{"type":"null"}],"description":"评论回复作者信息；不可用时为 null。"}},"required":["comment_id","content","publish_time","like_count","ip_location","image_urls","author"],"title":"WeiboCommentReplyItemData","type":"object"}},"properties":{"items":{"description":"当前页评论回复列表。","items":{"$ref":"#/$defs/WeiboCommentReplyItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；next_page_token 只能用于同一能力和同一分页链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"WeiboCommentRepliesResult","type":"object"},"example":{"items":[{"comment_id":"4611693340001973","content":"同感，最后一节很关键。","publish_time":1714317000,"like_count":2,"ip_location":"广东","image_urls":[],"author":{"user_id":"20002","name":"回复作者","avatar_url":"https://example.invalid/reply-avatar.jpg","profile_url":"https://weibo.com/u/20002"}}],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["weibo_get_post_comment_replies_by_comment_id"]},{"operation_id":"weibo_get_post_liker_list_by_post_id","platform_id":"weibo","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/weibo/post/liker/list","summary":"读取微博帖子点赞用户","description":"按微博帖子 post_id 或 post_url 读取点赞用户列表，返回用户信息、点赞时间展示文本和来源展示文本。","tags":["用户互动","微博"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"post_id":{"default":"","title":"Post Id","type":"string","description":"微博帖子长 ID；可从搜索、详情、转发或用户帖子列表结果中的 post_id 复用。"},"post_url":{"default":"","title":"Post Url","type":"string","description":"微博帖子页面链接、短链接或包含帖子链接的分享文案；不要传用户主页链接或 post_id。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"微博点赞分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一帖子点赞分页链路，不能跨帖子复用。"}},"title":"InternalPostLikerListRequest","type":"object","description":"首次请求必须且只能选择一种微博帖子入口：传 post_id，或传 post_url。继续翻页时仍需传同一 post_id 或 post_url，并将上一页返回的完整 next_page_token 原样作为 page_token 传回。"},"example":{"post_url":"https://weibo.com/1682207150/R1tllDJRy","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"WeiboAuthorData":{"properties":{"user_id":{"description":"微博用户 user_id；不可用时为空字符串；非空时可作为用户资料或用户帖子列表接口输入。","title":"User Id","type":"string"},"name":{"description":"微博用户名称；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"微博用户主页链接；可用于打开用户主页；不可用时为 null；需要继续查询用户资料或用户帖子列表时优先使用非空 user_id。","title":"Profile Url"}},"required":["user_id","name","avatar_url","profile_url"],"title":"WeiboAuthorData","type":"object"},"WeiboLikerItemData":{"properties":{"user_id":{"description":"点赞用户 user_id；不可用时为空字符串；非空时可作为用户资料或用户帖子列表接口输入。","title":"User Id","type":"string"},"liked_time_label":{"description":"点赞时间展示文本，可能为相对时间或日期文本；不可用时为空字符串。","title":"Liked Time Label","type":"string"},"like_source_label":{"description":"点赞来源展示文本；不可用时为空字符串；不要当作稳定枚举。","title":"Like Source Label","type":"string"},"user":{"anyOf":[{"$ref":"#/$defs/WeiboAuthorData"},{"type":"null"}],"description":"点赞用户信息；不可用时为 null。"}},"required":["user_id","liked_time_label","like_source_label","user"],"title":"WeiboLikerItemData","type":"object"}},"properties":{"items":{"description":"当前页点赞用户列表。","items":{"$ref":"#/$defs/WeiboLikerItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；next_page_token 只能用于同一能力和同一分页链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"WeiboLikerResult","type":"object"},"example":{"items":[{"user_id":"20003","liked_time_label":"3小时前","like_source_label":"iPhone客户端","user":{"user_id":"20003","name":"点赞用户","avatar_url":"https://example.invalid/liker-avatar.jpg","profile_url":"https://weibo.com/u/20003"}}],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["weibo_get_post_liker_list_by_post_id","weibo_get_post_liker_list_by_post_url"]},{"operation_id":"weibo_get_post_repost_list_by_post_id","platform_id":"weibo","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/weibo/post/repost/list","summary":"读取微博帖子转发列表","description":"按微博帖子 post_id 或 post_url 读取转发列表，返回转发正文、互动指标、作者信息和转发关联话题。","tags":["用户互动","微博"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"post_id":{"default":"","title":"Post Id","type":"string","description":"微博帖子长 ID；可从搜索、详情、转发或用户帖子列表结果中的 post_id 复用。"},"post_url":{"default":"","title":"Post Url","type":"string","description":"微博帖子页面链接、短链接或包含帖子链接的分享文案；不要传用户主页链接或 post_id。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"微博转发分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一帖子转发分页链路，不能跨帖子复用。"}},"title":"InternalPostRepostListRequest","type":"object","description":"首次请求必须且只能选择一种微博帖子入口：传 post_id，或传 post_url。继续翻页时仍需传同一 post_id 或 post_url，并将上一页返回的完整 next_page_token 原样作为 page_token 传回。"},"example":{"post_url":"https://weibo.com/1682207150/R1tllDJRy","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"WeiboAuthorData":{"properties":{"user_id":{"description":"微博用户 user_id；不可用时为空字符串；非空时可作为用户资料或用户帖子列表接口输入。","title":"User Id","type":"string"},"name":{"description":"微博用户名称；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"微博用户主页链接；可用于打开用户主页；不可用时为 null；需要继续查询用户资料或用户帖子列表时优先使用非空 user_id。","title":"Profile Url"}},"required":["user_id","name","avatar_url","profile_url"],"title":"WeiboAuthorData","type":"object"},"WeiboImageData":{"properties":{"url":{"description":"图片链接。","title":"Url","type":"string"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片宽度，像素；不可用时为 null。","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片高度，像素；不可用时为 null。","title":"Height"}},"required":["url","width","height"],"title":"WeiboImageData","type":"object"},"WeiboRepostItemData":{"properties":{"post_id":{"description":"微博帖子长 ID，可作为详情、评论、点赞或转发接口输入；查询评论回复时需与同一条一级评论的 comment_id 同时传入。","title":"Post Id","type":"string"},"content":{"description":"微博帖子正文；不可用时为空字符串。","title":"Content","type":"string"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"post_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"微博帖子页面链接；需要打开帖子网页时优先使用此字段；不可用时为 null；不要自行拼接链接。","title":"Post Url"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"点赞数；不可用时为 null。","title":"Like Count"},"comment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论数；不可用时为 null。","title":"Comment Count"},"repost_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"转发数；不可用时为 null。","title":"Repost Count"},"image_urls":{"description":"图片链接列表；无图时为空数组。","items":{"type":"string"},"title":"Image Urls","type":"array"},"images":{"description":"图片列表，包含链接及宽高；无图时为空数组。","items":{"$ref":"#/$defs/WeiboImageData"},"title":"Images","type":"array"},"author":{"anyOf":[{"$ref":"#/$defs/WeiboAuthorData"},{"type":"null"}],"description":"帖子作者信息；不可用时为 null。"},"topics":{"description":"微博转发关联话题标题列表；无话题时为空数组。","items":{"type":"string"},"title":"Topics","type":"array"}},"required":["post_id","content","publish_time","post_url","like_count","comment_count","repost_count","image_urls","images","author","topics"],"title":"WeiboRepostItemData","type":"object"}},"properties":{"items":{"description":"当前页微博转发列表。","items":{"$ref":"#/$defs/WeiboRepostItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；next_page_token 只能用于同一能力和同一分页链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"WeiboRepostListResult","type":"object"},"example":{"items":[{"post_id":"5303511279471093","content":"转发微博并补充观点。","publish_time":1714317100,"post_url":"https://weibo.com/20002/R1tllDJRz","like_count":5,"comment_count":1,"repost_count":0,"image_urls":[],"images":[],"author":{"user_id":"20002","name":"转发用户","avatar_url":"https://example.invalid/repost-avatar.jpg","profile_url":"https://weibo.com/u/20002"},"topics":["露营"]}],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["weibo_get_post_repost_list_by_post_id","weibo_get_post_repost_list_by_post_url"]},{"operation_id":"weibo_get_user_info","platform_id":"weibo","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/weibo/user/info","summary":"读取微博用户资料","description":"按微博用户 user_id 或主页链接读取公开用户资料、认证信息和公开互动规模。","tags":["用户资料","微博"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"User Id","description":"微博用户 user_id；可从作者信息或用户资料结果中的非空 user_id 复用。"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Profile Url","description":"微博用户主页链接；请传用户主页链接，不要传帖子链接、昵称或 user_id。"}},"title":"InternalUserInfoRequest","type":"object","description":"请求体必须且只能选择一种微博用户入口：传 user_id，或传 profile_url。"},"example":{"user_id":"1282864934"}},"response":{"content_type":"application/json","schema":{"properties":{"user_id":{"description":"微博用户 user_id，可作为用户资料或用户帖子列表接口输入。","title":"User Id","type":"string"},"name":{"description":"用户名称；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"微博用户主页链接；可用于打开用户主页；不可用时为 null；需要继续查询用户资料或用户帖子列表时优先使用非空 user_id。","title":"Profile 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"},"post_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"已发布微博数；不可用时为 null。","title":"Post Count"},"verified":{"description":"是否为认证账号。","title":"Verified","type":"boolean"},"verified_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"认证说明；不可用时为 null。","title":"Verified Reason"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["user_id","name","avatar_url","profile_url","bio","follower_count","following_count","post_count","verified","verified_reason","points"],"title":"WeiboUserInfoData","type":"object"},"example":{"user_id":"1282864934","name":"微博用户","avatar_url":"https://example.invalid/weibo-user-avatar.jpg","profile_url":"https://weibo.com/u/1282864934","bio":"记录公开微博内容。","follower_count":120000,"following_count":120,"post_count":4567,"verified":true,"verified_reason":"微博认证用户","points":{"cost":10,"balance":990}}},"related_mcp_tools":["weibo_get_user_info_by_user_id","weibo_get_user_info_by_profile_url"]},{"operation_id":"weibo_get_user_posts","platform_id":"weibo","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/weibo/user/post/list","summary":"读取微博用户帖子列表","description":"按微博用户 user_id 或主页链接读取用户已发布微博帖子列表，返回帖子字段、话题标签和下一页分页令牌。","tags":["用户内容","微博"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"User Id","description":"微博用户 user_id；可从作者信息或用户资料结果中的非空 user_id 复用。"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Profile Url","description":"微博用户主页链接；请传用户主页链接，不要传帖子链接、昵称或 user_id。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"微博用户帖子列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一用户帖子列表分页链路，不能跨用户复用。"}},"title":"InternalUserPostsRequest","type":"object","description":"首次请求必须且只能选择一种微博用户入口：传 user_id，或传 profile_url。继续翻页时仍需传同一 user_id 或 profile_url，并将上一页返回的完整 next_page_token 原样作为 page_token 传回。"},"example":{"user_id":"1282864934","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"WeiboAuthorData":{"properties":{"user_id":{"description":"微博用户 user_id；不可用时为空字符串；非空时可作为用户资料或用户帖子列表接口输入。","title":"User Id","type":"string"},"name":{"description":"微博用户名称；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"微博用户主页链接；可用于打开用户主页；不可用时为 null；需要继续查询用户资料或用户帖子列表时优先使用非空 user_id。","title":"Profile Url"}},"required":["user_id","name","avatar_url","profile_url"],"title":"WeiboAuthorData","type":"object"},"WeiboImageData":{"properties":{"url":{"description":"图片链接。","title":"Url","type":"string"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片宽度，像素；不可用时为 null。","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片高度，像素；不可用时为 null。","title":"Height"}},"required":["url","width","height"],"title":"WeiboImageData","type":"object"},"WeiboPostItemData":{"properties":{"post_id":{"description":"微博帖子长 ID，可作为详情、评论、点赞或转发接口输入；查询评论回复时需与同一条一级评论的 comment_id 同时传入。","title":"Post Id","type":"string"},"content":{"description":"微博帖子正文；不可用时为空字符串。","title":"Content","type":"string"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"post_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"微博帖子页面链接；需要打开帖子网页时优先使用此字段；不可用时为 null；不要自行拼接链接。","title":"Post Url"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"点赞数；不可用时为 null。","title":"Like Count"},"comment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论数；不可用时为 null。","title":"Comment Count"},"repost_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"转发数；不可用时为 null。","title":"Repost Count"},"play_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"帖子内视频播放数；没有视频或暂不可用时为 null，不是帖子浏览数。","title":"Play Count"},"image_urls":{"description":"图片链接列表；无图时为空数组。","items":{"type":"string"},"title":"Image Urls","type":"array"},"images":{"description":"图片列表，包含链接及宽高；无图时为空数组。","items":{"$ref":"#/$defs/WeiboImageData"},"title":"Images","type":"array"},"topic_tags":{"description":"微博帖子话题标签列表；无标签时为空数组。","items":{"$ref":"#/$defs/WeiboTopicTagData"},"title":"Topic Tags","type":"array"},"author":{"anyOf":[{"$ref":"#/$defs/WeiboAuthorData"},{"type":"null"}],"description":"帖子作者信息；不可用时为 null。"}},"required":["post_id","content","publish_time","post_url","like_count","comment_count","repost_count","play_count","image_urls","images","topic_tags","author"],"title":"WeiboPostItemData","type":"object"},"WeiboTopicTagData":{"additionalProperties":false,"properties":{"name":{"description":"话题标签名称。","title":"Name","type":"string"}},"required":["name"],"title":"WeiboTopicTagData","type":"object"}},"properties":{"items":{"description":"当前页微博用户帖子列表。","items":{"$ref":"#/$defs/WeiboPostItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；next_page_token 只能用于同一能力和同一分页链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"WeiboUserPostsResult","type":"object"},"example":{"items":[{"post_id":"5303511279471092","content":"露营装备清单和周末路线讨论正在升温。","publish_time":1714316800,"post_url":"https://weibo.com/1682207150/R1tllDJRy","like_count":120,"comment_count":18,"repost_count":4,"play_count":260000,"image_urls":["https://example.invalid/weibo-image.jpg"],"images":[{"url":"https://example.invalid/weibo-image.jpg","width":1080,"height":720}],"topic_tags":[{"name":"露营"}],"author":{"user_id":"1682207150","name":"露营研究所","avatar_url":"https://example.invalid/weibo-avatar.jpg","profile_url":"https://weibo.com/u/1682207150"}}],"next_page_token":"opaque-weibo-user-post-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["weibo_get_user_posts_by_user_id","weibo_get_user_posts_by_profile_url"]}]},{"surface":"mcp","status":"available","endpoint":"https://mcp.socialdatax.com/weibo/mcp","authentication":{"required":true},"capabilities_resource":"weibo://guides/tool-capabilities","related_http_operation_ids":["weibo_get_hot_search_list","weibo_search_posts","weibo_get_post_detail","weibo_get_post_comments","weibo_get_post_comment_replies","weibo_get_post_liker_list_by_post_id","weibo_get_post_repost_list_by_post_id","weibo_get_user_info","weibo_get_user_posts"]}]},{"platform_id":"wechat","label":"微信","english_label":"WeChat","status":"available","surfaces":[{"surface":"http","status":"available","base_path":"/socialdatax/api/v1/wechat","description":"公开微信视频号 HTTP API 提供热榜、视频搜索、详情、评论和用户相关核心接口。","operations":[{"operation_id":"wechat_get_hot_search_list","platform_id":"wechat","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/wechat/hot/search/list","summary":"读取微信视频号热榜","description":"读取微信视频号热榜，返回排名和热点标题；当前不支持翻页。","tags":["内容搜索","搜索热榜","视频号"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{},"title":"InternalWechatHotSearchRequest","type":"object"},"example":{}},"response":{"content_type":"application/json","schema":{"$defs":{"InternalWechatHotSearchItemResponse":{"additionalProperties":false,"properties":{"rank":{"title":"Rank","type":"integer","description":"主热榜排名。"},"keyword":{"title":"Keyword","type":"string","description":"热点标题或热榜词。"}},"required":["rank","keyword"],"title":"InternalWechatHotSearchItemResponse","type":"object"}},"additionalProperties":false,"properties":{"items":{"items":{"$ref":"#/$defs/InternalWechatHotSearchItemResponse"},"title":"Items","type":"array","description":"当前页结果列表。"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","points"],"title":"InternalWechatHotSearchResponse","type":"object"},"example":{"items":[{"rank":1,"keyword":"露营"}],"points":{"cost":10,"balance":990}}},"related_mcp_tools":["wechat_get_hot_search_list"]},{"operation_id":"wechat_search_videos","platform_id":"wechat","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/wechat/video/search","summary":"搜索微信视频号视频","description":"按关键词搜索微信视频号视频，支持排序、时长筛选和下一页分页令牌。","tags":["内容搜索","视频号"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"keyword":{"title":"Keyword","type":"string","description":"微信视频号视频搜索词；只传关键词或短语；不要传任何链接、encrypted_object_id、user_id 或 page_token 作为 keyword。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"微信视频号视频搜索分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；只能用于同一微信视频号搜索分页链路、同一关键词和同一筛选条件，不能跨能力、关键词或筛选条件复用。"},"sort_type":{"default":"all","enum":["all","time_descending","collect_count_descending"],"title":"Sort Type","type":"string","description":"搜索排序方式，可选：all（不限，默认）、time_descending（最新）、collect_count_descending（最热/最多收藏排序）。如无明确排序需求，保持 all。","x-socialdatax-enum-labels":{"all":"不限","time_descending":"最新","collect_count_descending":"最热/最多收藏排序"}},"duration_range":{"default":"all","enum":["all","under_5_min","between_5_and_20_min","over_20_min"],"title":"Duration Range","type":"string","description":"视频时长筛选，可选：all（不限，默认）、under_5_min（5 分钟以下）、between_5_and_20_min（5-20 分钟）、over_20_min（20 分钟以上）。如无明确筛选需求，保持 all。","x-socialdatax-enum-labels":{"all":"不限","under_5_min":"5 分钟以下","between_5_and_20_min":"5-20 分钟","over_20_min":"20 分钟以上"}}},"required":["keyword"],"title":"InternalWechatVideoSearchRequest","type":"object"},"example":{"keyword":"露营","page_token":"","sort_type":"all","duration_range":"all"}},"response":{"content_type":"application/json","schema":{"$defs":{"InternalWechatSearchAuthorResponse":{"additionalProperties":false,"properties":{"name":{"title":"Name","type":"string","description":"名称。"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url","description":"头像链接；没有头像时为 null。"}},"required":["name","avatar_url"],"title":"InternalWechatSearchAuthorResponse","type":"object"},"InternalWechatTopicTagResponse":{"additionalProperties":false,"properties":{"name":{"title":"Name","type":"string","description":"话题标签名称。"}},"required":["name"],"title":"InternalWechatTopicTagResponse","type":"object"},"InternalWechatVideoSearchItemResponse":{"additionalProperties":false,"properties":{"encrypted_object_id":{"title":"Encrypted Object Id","type":"string","description":"微信视频号合法 encrypted_object_id；用户已提供时原样使用，否则可从 wechat_search_videos 返回项获取。"},"content_type":{"const":"video","title":"Content Type","type":"string","description":"内容类型。"},"description":{"title":"Description","type":"string"},"topic_tags":{"items":{"$ref":"#/$defs/InternalWechatTopicTagResponse"},"title":"Topic Tags","type":"array","description":"作品文案中的话题标签；无话题时为空数组；每项只返回 name。"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cover Image Url","description":"统一封面图链接。"},"publish_time":{"title":"Publish Time","type":"integer","description":"发布时间，秒级 Unix 时间戳。"},"duration_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Seconds"},"like_count":{"title":"Like Count","type":"integer","description":"点赞数。"},"collect_count":{"title":"Collect Count","type":"integer","description":"收藏数。"},"comment_count":{"title":"Comment Count","type":"integer","description":"评论数。"},"share_count":{"title":"Share Count","type":"integer","description":"分享数。"},"author":{"$ref":"#/$defs/InternalWechatSearchAuthorResponse","description":"作者信息。"}},"required":["encrypted_object_id","content_type","description","topic_tags","cover_image_url","publish_time","duration_seconds","like_count","collect_count","comment_count","share_count","author"],"title":"InternalWechatVideoSearchItemResponse","type":"object"}},"additionalProperties":false,"properties":{"items":{"items":{"$ref":"#/$defs/InternalWechatVideoSearchItemResponse"},"title":"Items","type":"array","description":"当前页结果列表。"},"next_page_token":{"title":"Next Page Token","type":"string","description":"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；next_page_token 只能用于同一微信视频号搜索分页链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"InternalWechatVideoSearchResponse","type":"object"},"example":{"items":[{"encrypted_object_id":"export/UzFfBgAAxNihABcaQCLMjMzT4DCKa25PGq4WQLbjDR5MjFnNkg","content_type":"video","description":"女生一人雨天户外沉浸式露营是种什么体验#户外露营 #露营 #雨中露营 #露营装备","topic_tags":[{"name":"户外露营"},{"name":"露营"},{"name":"雨中露营"},{"name":"露营装备"}],"cover_image_url":"https://example.invalid/wechat-cover.jpg","publish_time":1780931019,"duration_seconds":446,"like_count":87,"collect_count":41,"comment_count":13,"share_count":47,"author":{"name":"爱玩的闷三","avatar_url":"https://example.invalid/wechat-avatar.jpg"}}],"next_page_token":"opaque-wechat-search-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["wechat_search_videos"]},{"operation_id":"wechat_search_finder_user","platform_id":"wechat","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/wechat/finder/user/search","summary":"搜索微信视频号用户","description":"按关键词或视频号ID搜索微信视频号用户，返回可用于用户资料和用户发布作品列表接口的 user_id，支持分页令牌。","tags":["用户搜索","视频号"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"keyword":{"title":"Keyword","type":"string","description":"微信视频号用户搜索关键词，支持输入视频号ID（如 sphhTeTFNszPMPc）或昵称/关键词进行搜索；不要传链接或分页 token。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"微信视频号用户搜索分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；只能用于同一微信视频号用户搜索分页链路、同一关键词，不能跨能力或关键词复用。"}},"required":["keyword"],"title":"InternalWechatFinderUserSearchRequest","type":"object"},"example":{"keyword":"露营","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"InternalWechatFinderUserSearchItemResponse":{"additionalProperties":false,"properties":{"user_id":{"title":"User Id","type":"string","description":"微信视频号用户 ID；可作为用户资料或用户发布作品列表接口输入。"},"name":{"title":"Name","type":"string","description":"名称。"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url","description":"头像链接；没有头像时为 null。"},"bio":{"title":"Bio","type":"string","description":"用户个人简介；没有简介时为空字符串。"}},"required":["user_id","name","avatar_url","bio"],"title":"InternalWechatFinderUserSearchItemResponse","type":"object"}},"additionalProperties":false,"properties":{"items":{"items":{"$ref":"#/$defs/InternalWechatFinderUserSearchItemResponse"},"title":"Items","type":"array","description":"当前页结果列表。"},"next_page_token":{"title":"Next Page Token","type":"string","description":"下一页不透明分页令牌；为空表示没有更多用户搜索结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一微信视频号用户搜索分页链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"InternalWechatFinderUserSearchResponse","type":"object"},"example":{"items":[{"user_id":"v2_060000231003b20faec8c7e18b1dc5d7cf04e534b0777edbd7a084f0df31ae5fdc069a40607b@finder","name":"露营研究所","avatar_url":"https://example.invalid/wechat-user-search-avatar.jpg","bio":"分享周末露营路线、营地搭建和户外装备清单，陪你把短途露营计划准备得更轻松。"}],"next_page_token":"opaque-wechat-user-search-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":[]},{"operation_id":"wechat_get_video_detail","platform_id":"wechat","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/wechat/video/detail","summary":"读取微信视频号作品详情","description":"按 encrypted_object_id 或微信视频号作品链接读取公开作品详情，返回文案、媒体资源、互动指标和作者信息。","tags":["内容详情","视频号"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Url","description":"微信视频号作品链接（视频或图文），或包含该链接的分享文案。"},"encrypted_object_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Encrypted Object Id","description":"微信视频号合法 encrypted_object_id；用户已提供时原样使用，否则可从 wechat_search_videos 返回项获取。"}},"title":"InternalWechatVideoDetailRequest","type":"object","description":"请求体必须且只能选择一种作品详情入口：传 encrypted_object_id，或传 url。不要两个都传，也不要空请求。"},"example":{"encrypted_object_id":"export/UzFfAgtgekIEAQAAAAAAd94yB38uNAAAAAstQy6ubaLX4KHWvLEZgBPEhad8ZjoqeYOLzNPgMIqpfnwabdr3lN-THd7Es0wO"}},"response":{"content_type":"application/json","schema":{"$defs":{"InternalWechatDetailImageResponse":{"additionalProperties":false,"properties":{"url":{"title":"Url","type":"string","description":"微信视频号图文图片资源链接。"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height"}},"required":["url","width","height"],"title":"InternalWechatDetailImageResponse","type":"object"},"InternalWechatDetailVideoResponse":{"additionalProperties":false,"properties":{"video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Video Url"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Ms","description":"时长，单位毫秒；没有时长时为 null。"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height"}},"required":["video_url","duration_ms","width","height"],"title":"InternalWechatDetailVideoResponse","type":"object"},"InternalWechatTopicTagResponse":{"additionalProperties":false,"properties":{"name":{"title":"Name","type":"string","description":"话题标签名称。"}},"required":["name"],"title":"InternalWechatTopicTagResponse","type":"object"},"InternalWechatVideoDetailAuthorResponse":{"additionalProperties":false,"properties":{"user_id":{"title":"User Id","type":"string","description":"作者微信视频号用户 ID；非空且为 v2_...@finder 时可作为用户资料或用户发布作品列表接口输入。"},"name":{"title":"Name","type":"string","description":"名称。"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url","description":"头像链接；没有头像时为 null。"},"bio":{"title":"Bio","type":"string","description":"用户个人简介；没有简介时为空字符串。"}},"required":["user_id","name","avatar_url","bio"],"title":"InternalWechatVideoDetailAuthorResponse","type":"object"}},"additionalProperties":false,"properties":{"object_id":{"title":"Object Id","type":"string","description":"微信视频号作品 object_id；获取视频评论时请与同一条视频的 object_nonce_id 一起原样传入。"},"object_nonce_id":{"title":"Object Nonce Id","type":"string","description":"微信视频号作品 object_nonce_id；获取视频评论时请与同一条视频的 object_id 一起原样传入。"},"content_type":{"enum":["video","image"],"title":"Content Type","type":"string","description":"内容类型。","x-socialdatax-enum-labels":{"image":"图片","video":"视频"}},"description":{"title":"Description","type":"string"},"topic_tags":{"items":{"$ref":"#/$defs/InternalWechatTopicTagResponse"},"title":"Topic Tags","type":"array","description":"作品文案中的话题标签；无话题时为空数组；每项只返回 name。"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cover Image Url","description":"统一封面图链接。"},"video":{"anyOf":[{"$ref":"#/$defs/InternalWechatDetailVideoResponse"},{"type":"null"}],"description":"视频资源信息；图文内容或无视频资源时为 null。"},"images":{"items":{"$ref":"#/$defs/InternalWechatDetailImageResponse"},"title":"Images","type":"array","description":"图片资源列表；无图片时为空数组。"},"like_count":{"title":"Like Count","type":"integer","description":"点赞数。"},"collect_count":{"title":"Collect Count","type":"integer","description":"收藏数。"},"comment_count":{"title":"Comment Count","type":"integer","description":"评论数。"},"share_count":{"title":"Share Count","type":"integer","description":"分享数。"},"publish_time":{"title":"Publish Time","type":"integer","description":"发布时间，秒级 Unix 时间戳。"},"ip_location":{"title":"Ip Location","type":"string","description":"发布时的 IP 属地；没有 IP 属地时为空字符串。"},"author":{"$ref":"#/$defs/InternalWechatVideoDetailAuthorResponse","description":"作者信息。"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["object_id","object_nonce_id","content_type","description","topic_tags","cover_image_url","video","images","like_count","collect_count","comment_count","share_count","publish_time","ip_location","author","points"],"title":"InternalWechatVideoDetailResponse","type":"object"},"example":{"object_id":"14469096051103173201","object_nonce_id":"4041472331870621547_0_39_0_0","content_type":"video","description":"男人沉浸式雪中露营#雪中露营 #户外露营 #解压","topic_tags":[{"name":"雪中露营"},{"name":"户外露营"},{"name":"解压"}],"cover_image_url":"https://example.invalid/wechat-cover.jpg","video":{"video_url":"https://example.invalid/wechat-video.mp4","duration_ms":264900,"width":1080,"height":1920},"publish_time":1724850660,"collect_count":201,"comment_count":17,"author":{"user_id":"v2_060000231003b20faec8c5e38c1fc2d1ca02ed31b077443bacd942a0f8fce8dba8bb27842014@finder","name":"野人日记YEREN","avatar_url":"https://example.invalid/wechat-avatar.jpg","bio":"野人日记 每日一更"},"like_count":406,"share_count":741,"ip_location":"山东","images":[],"points":{"cost":10,"balance":990}}},"related_mcp_tools":["wechat_get_video_detail_by_encrypted_object_id","wechat_get_video_detail_by_url"]},{"operation_id":"wechat_get_video_comments","platform_id":"wechat","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/wechat/video/comment/list","summary":"读取微信视频号一级评论","description":"按微信视频号视频的 object_id 与 object_nonce_id，或视频链接，读取公开一级评论列表。","tags":["评论","视频号"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Url","description":"微信视频号视频链接，或包含该链接的分享文案。"},"object_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Object Id","description":"微信视频号作品 object_id；获取视频评论时请与同一条视频的 object_nonce_id 一起原样传入。"},"object_nonce_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Object Nonce Id","description":"微信视频号作品 object_nonce_id；获取视频评论时请与同一条视频的 object_id 一起原样传入。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"微信视频号评论分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；只能用于同一视频评论分页链路，不能跨视频复用。"}},"title":"InternalWechatVideoCommentsRequest","type":"object","description":"首次请求必须且只能选择一种评论入口：传 url，或同时传 object_id 与 object_nonce_id。继续翻页时只需传上一页返回的完整 next_page_token 作为 page_token；也可以继续带同一入口：同一视频链接，或同一条视频的 object_id 与 object_nonce_id。"},"example":{"object_id":"14469096051103173201","object_nonce_id":"4041472331870621547_0_39_0_0","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"InternalWechatCommentAuthorResponse":{"additionalProperties":false,"properties":{"user_id":{"title":"User Id","type":"string","description":"评论作者微信视频号用户 ID；可能是 @finder 或 @stranger；仅 v2_...@finder 可用于用户信息接口；不可用时为空字符串。"},"name":{"title":"Name","type":"string","description":"名称。"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url","description":"头像链接；没有头像时为 null。"}},"required":["user_id","name","avatar_url"],"title":"InternalWechatCommentAuthorResponse","type":"object"},"InternalWechatVideoCommentItemResponse":{"additionalProperties":false,"properties":{"comment_id":{"title":"Comment Id","type":"string","description":"微信视频号一级评论 ID；需要继续获取该评论下的回复时可作为 comment_id 传入。"},"object_id":{"title":"Object Id","type":"string","description":"微信视频号作品 object_id；获取视频评论时请与同一条视频的 object_nonce_id 一起原样传入。"},"object_nonce_id":{"title":"Object Nonce Id","type":"string","description":"微信视频号作品 object_nonce_id；获取视频评论时请与同一条视频的 object_id 一起原样传入。"},"content":{"title":"Content","type":"string","description":"评论内容。"},"publish_time":{"title":"Publish Time","type":"integer","description":"发布时间，秒级 Unix 时间戳。"},"like_count":{"title":"Like Count","type":"integer","description":"点赞数。"},"reply_count":{"title":"Reply Count","type":"integer","description":"回复数。"},"ip_location":{"title":"Ip Location","type":"string","description":"发布时的 IP 属地；没有 IP 属地时为空字符串。"},"author":{"$ref":"#/$defs/InternalWechatCommentAuthorResponse","description":"作者信息。"}},"required":["comment_id","object_id","object_nonce_id","content","publish_time","like_count","reply_count","ip_location","author"],"title":"InternalWechatVideoCommentItemResponse","type":"object"}},"additionalProperties":false,"properties":{"items":{"items":{"$ref":"#/$defs/InternalWechatVideoCommentItemResponse"},"title":"Items","type":"array","description":"当前页结果列表。"},"next_page_token":{"title":"Next Page Token","type":"string","description":"下一页不透明分页令牌；为空表示没有更多评论。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；next_page_token 只能用于同一微信视频号评论分页链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"},"comment_count":{"title":"Comment Count","type":"integer","description":"评论数。"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","comment_count","points"],"title":"InternalWechatVideoCommentsResponse","type":"object"},"example":{"items":[{"comment_id":"14608046980043114941","object_id":"14469096051103173201","object_nonce_id":"4041472331870621547_0_39_0_0","content":"背景音乐是什么","publish_time":1741414902,"like_count":0,"reply_count":5,"ip_location":"河南","author":{"user_id":"v5_020b0a16610401000000000016332f3df33dda000000b1afa7d8728e3dd43ef4317a780e33c292160a85dd62028f228e8916f5c34a3f69b80614e03930471c41e97150397d0ccbc3a5de5df87d7d6ec7dd6c60fde9a6b640b01c8621fb0d2189e3f77c@stranger","name":"麦田星空","avatar_url":"https://example.invalid/comment-avatar.jpg"}}],"next_page_token":"opaque-wechat-comment-page-token","comment_count":17,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["wechat_get_video_comments_by_object_id","wechat_get_video_comments_by_url"]},{"operation_id":"wechat_get_video_comment_replies","platform_id":"wechat","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/wechat/video/comment/reply/list","summary":"读取微信视频号评论回复","description":"按微信视频号视频 object_id、object_nonce_id 和一级评论 ID 读取公开评论回复列表。","tags":["评论","视频号"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"object_id":{"title":"Object Id","type":"string","description":"微信视频号作品 object_id；获取视频评论时请与同一条视频的 object_nonce_id 一起原样传入。"},"object_nonce_id":{"title":"Object Nonce Id","type":"string","description":"微信视频号作品 object_nonce_id；获取视频评论时请与同一条视频的 object_id 一起原样传入。"},"comment_id":{"title":"Comment Id","type":"string","description":"微信视频号一级评论 ID；从一级评论结果 items[].comment_id 复制，用于获取该评论下的回复；不要传回复项的 comment_id。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"评论回复分页令牌；首次请求留空，继续翻页时必须将上一页返回的完整 next_page_token 原样传回；只能用于同一微信视频号、同一一级评论的回复分页链路。"}},"required":["object_id","object_nonce_id","comment_id"],"title":"InternalWechatVideoCommentRepliesRequest","type":"object"},"example":{"object_id":"14469096051103173201","object_nonce_id":"4041472331870621547_0_39_0_0","comment_id":"14608046980043114941","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"InternalWechatCommentAuthorResponse":{"additionalProperties":false,"properties":{"user_id":{"title":"User Id","type":"string","description":"评论作者微信视频号用户 ID；可能是 @finder 或 @stranger；仅 v2_...@finder 可用于用户信息接口；不可用时为空字符串。"},"name":{"title":"Name","type":"string","description":"名称。"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url","description":"头像链接；没有头像时为 null。"}},"required":["user_id","name","avatar_url"],"title":"InternalWechatCommentAuthorResponse","type":"object"},"InternalWechatVideoCommentReplyItemResponse":{"additionalProperties":false,"properties":{"comment_id":{"title":"Comment Id","type":"string","description":"微信视频号评论回复 ID。"},"content":{"title":"Content","type":"string","description":"评论回复内容。"},"publish_time":{"title":"Publish Time","type":"integer","description":"发布时间，秒级 Unix 时间戳。"},"like_count":{"title":"Like Count","type":"integer","description":"点赞数。"},"ip_location":{"title":"Ip Location","type":"string","description":"发布时的 IP 属地；没有 IP 属地时为空字符串。"},"reply_to_comment_id":{"title":"Reply To Comment Id","type":"string"},"reply_to_user_id":{"title":"Reply To User Id","type":"string","description":"被回复用户 ID；可能为空、@finder 或 @stranger；仅 v2_...@finder 可用于用户信息接口。"},"reply_to_user_name":{"title":"Reply To User Name","type":"string"},"author":{"$ref":"#/$defs/InternalWechatCommentAuthorResponse","description":"作者信息。"}},"required":["comment_id","content","publish_time","like_count","ip_location","reply_to_comment_id","reply_to_user_id","reply_to_user_name","author"],"title":"InternalWechatVideoCommentReplyItemResponse","type":"object"}},"additionalProperties":false,"properties":{"items":{"items":{"$ref":"#/$defs/InternalWechatVideoCommentReplyItemResponse"},"title":"Items","type":"array","description":"当前页结果列表。"},"next_page_token":{"title":"Next Page Token","type":"string","description":"下一页不透明分页令牌；为空表示没有更多评论回复。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；next_page_token 只能用于同一微信视频号、同一一级评论的回复分页链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"InternalWechatVideoCommentRepliesResponse","type":"object"},"example":{"items":[{"comment_id":"14751566632096106621","content":"liekkas拿走不谢[旺柴]","publish_time":1758523777,"like_count":1,"ip_location":"广东","reply_to_comment_id":"14608046980043114941","reply_to_user_id":"","reply_to_user_name":"","author":{"user_id":"v2_060000231003b20faec8c6e6891ec6d5ca06ee36b077ce9ea4fc6ccae43469044f3f50a50272@finder","name":"发呆9738","avatar_url":"https://example.invalid/reply-avatar.jpg"}}],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["wechat_get_video_comment_replies_by_comment_id"]},{"operation_id":"wechat_get_user_info","platform_id":"wechat","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/wechat/user/info","summary":"读取微信视频号用户资料","description":"按微信视频号 user_id，或作品链接解析作者后读取公开用户资料和公开发布数量。","tags":["用户资料","视频号"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"User Id","description":"微信视频号用户 ID；只支持以 v2_ 开头、以 @finder 结尾的账号 ID；可从作品详情、用户发布作品列表、评论或评论回复结果中的 author.user_id 或 reply_to_user_id 复制；如果不是 v2_...@finder，不要传。"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Url","description":"微信视频号作品链接（视频或图文），或包含该链接的分享文案。"}},"title":"InternalWechatUserInfoRequest","type":"object","description":"请求体必须且只能选择一种用户资料入口：传 user_id，或传 url。url 支持微信视频号作品链接（视频或图文）或包含链接的分享文案，用于解析作品作者。"},"example":{"user_id":"v2_060000231003b20faec8c5e58110c0dcc90cee33b0777dd2f17b0e35693b274a9dd455cde24f@finder"}},"response":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"user_id":{"title":"User Id","type":"string","description":"微信视频号用户 ID。"},"name":{"title":"Name","type":"string","description":"名称。"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url","description":"头像链接；没有头像时为 null。"},"bio":{"title":"Bio","type":"string","description":"用户个人简介；没有简介时为空字符串。"},"gender":{"enum":["male","female","unknown"],"title":"Gender","type":"string","x-socialdatax-enum-labels":{"male":"男","female":"女","unknown":"未知"}},"ip_location":{"title":"Ip Location","type":"string","description":"发布时的 IP 属地；没有 IP 属地时为空字符串。"},"location":{"title":"Location","type":"string"},"original_content_count":{"title":"Original Content Count","type":"integer"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["user_id","name","avatar_url","bio","gender","ip_location","location","original_content_count","points"],"title":"InternalWechatUserInfoResponse","type":"object"},"example":{"user_id":"v2_060000231003b20faec8c5e58110c0dcc90cee33b0777dd2f17b0e35693b274a9dd455cde24f@finder","name":"汽配老板大橙子","avatar_url":"https://example.invalid/wechat-avatar.jpg","bio":"汽配老板与00后员工斗智斗勇的日常","gender":"male","ip_location":"上海","location":"浙江 杭州","original_content_count":5,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["wechat_get_user_info_by_user_id","wechat_get_user_info_by_url"]},{"operation_id":"wechat_get_user_posted_videos","platform_id":"wechat","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/wechat/user/video/list","summary":"读取微信视频号用户发布作品列表","description":"按微信视频号 user_id 或作品链接解析作者后读取已发布作品列表（含视频和图文），支持分页令牌。","tags":["用户内容","视频号"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"User Id","description":"微信视频号用户 ID；只支持以 v2_ 开头、以 @finder 结尾的账号 ID；可从作品详情、用户发布作品列表、评论或评论回复结果中的 author.user_id 或 reply_to_user_id 复制；如果不是 v2_...@finder，不要传。"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Url","description":"微信视频号作品链接（视频或图文），或包含该链接的分享文案。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"微信视频号用户发布作品列表分页令牌；首次请求留空，继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一微信视频号用户发布作品分页链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"}},"title":"InternalWechatUserPostedVideosRequest","type":"object","description":"首次请求必须且只能选择一种用户发布列表入口：传 user_id，或传 url。继续翻页时只需传上一页返回的完整 next_page_token 作为 page_token；也可以继续带同一入口：同一微信视频号用户 ID，或同一作品链接。"},"example":{"user_id":"v2_060000231003b20faec8c7e4891fc4ddcf0dee34b077dec72328afb683c547d385d93d3a71bb@finder","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"InternalWechatDetailImageResponse":{"additionalProperties":false,"properties":{"url":{"title":"Url","type":"string","description":"微信视频号图文图片资源链接。"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height"}},"required":["url","width","height"],"title":"InternalWechatDetailImageResponse","type":"object"},"InternalWechatDetailVideoResponse":{"additionalProperties":false,"properties":{"video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Video Url"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Ms","description":"时长，单位毫秒；没有时长时为 null。"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height"}},"required":["video_url","duration_ms","width","height"],"title":"InternalWechatDetailVideoResponse","type":"object"},"InternalWechatTopicTagResponse":{"additionalProperties":false,"properties":{"name":{"title":"Name","type":"string","description":"话题标签名称。"}},"required":["name"],"title":"InternalWechatTopicTagResponse","type":"object"},"InternalWechatUserPostedVideoAuthorResponse":{"additionalProperties":false,"properties":{"user_id":{"title":"User Id","type":"string","description":"作者微信视频号用户 ID；非空且为 v2_...@finder 时可作为用户资料或用户发布作品列表接口输入。"},"name":{"title":"Name","type":"string","description":"名称。"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url","description":"头像链接；没有头像时为 null。"}},"required":["user_id","name","avatar_url"],"title":"InternalWechatUserPostedVideoAuthorResponse","type":"object"},"InternalWechatUserPostedVideoItemResponse":{"additionalProperties":false,"properties":{"object_id":{"title":"Object Id","type":"string","description":"微信视频号作品 object_id；获取视频评论时请与同一条视频的 object_nonce_id 一起原样传入。"},"object_nonce_id":{"title":"Object Nonce Id","type":"string","description":"微信视频号作品 object_nonce_id；获取视频评论时请与同一条视频的 object_id 一起原样传入。"},"content_type":{"enum":["video","image"],"title":"Content Type","type":"string","description":"内容类型。","x-socialdatax-enum-labels":{"image":"图片","video":"视频"}},"description":{"title":"Description","type":"string"},"topic_tags":{"items":{"$ref":"#/$defs/InternalWechatTopicTagResponse"},"title":"Topic Tags","type":"array","description":"作品文案中的话题标签；无话题时为空数组；每项只返回 name。"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cover Image Url","description":"统一封面图链接。"},"video":{"anyOf":[{"$ref":"#/$defs/InternalWechatDetailVideoResponse"},{"type":"null"}],"description":"视频资源信息；图文作品或当前不可用时为 null。"},"images":{"items":{"$ref":"#/$defs/InternalWechatDetailImageResponse"},"title":"Images","type":"array","description":"图片资源列表；无图片时为空数组。"},"publish_time":{"title":"Publish Time","type":"integer","description":"发布时间，秒级 Unix 时间戳。"},"collect_count":{"title":"Collect Count","type":"integer","description":"收藏数。"},"comment_count":{"title":"Comment Count","type":"integer","description":"评论数。"},"author":{"$ref":"#/$defs/InternalWechatUserPostedVideoAuthorResponse","description":"作者信息。"}},"required":["object_id","object_nonce_id","content_type","description","topic_tags","cover_image_url","video","images","publish_time","collect_count","comment_count","author"],"title":"InternalWechatUserPostedVideoItemResponse","type":"object"}},"additionalProperties":false,"properties":{"items":{"items":{"$ref":"#/$defs/InternalWechatUserPostedVideoItemResponse"},"title":"Items","type":"array","description":"当前页结果列表。"},"next_page_token":{"title":"Next Page Token","type":"string","description":"下一页不透明分页令牌；为空表示没有更多用户发布作品。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一微信视频号用户发布作品分页链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"InternalWechatUserPostedVideosResponse","type":"object"},"example":{"items":[{"object_id":"14943667433491794546","object_nonce_id":"4968047911187467652_0_0_2_1_1781493025261502_c0e90d76-6867-11f1-9fe1-8912022cfab7","content_type":"video","description":"","topic_tags":[],"cover_image_url":"https://example.invalid/wechat-user-video-cover.jpg","video":{"video_url":"https://example.invalid/wechat-user-video.mp4","duration_ms":14400,"width":1080,"height":1920},"images":[],"publish_time":1781423978,"collect_count":4,"comment_count":0,"author":{"user_id":"v2_060000231003b20faec8c7e4891fc4ddcf0dee34b077dec72328afb683c547d385d93d3a71bb@finder","name":"美丽的梦8628","avatar_url":"https://example.invalid/wechat-user-avatar.jpg"}}],"next_page_token":"opaque-wechat-user-video-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["wechat_get_user_posted_videos_by_user_id","wechat_get_user_posted_videos_by_url"]}]},{"surface":"mcp","status":"available","endpoint":"https://mcp.socialdatax.com/wechat/mcp","authentication":{"required":true},"capabilities_resource":"wechat://guides/tool-capabilities","related_http_operation_ids":["wechat_get_hot_search_list","wechat_search_videos","wechat_search_finder_user","wechat_get_video_detail","wechat_get_video_comments","wechat_get_video_comment_replies","wechat_get_user_info","wechat_get_user_posted_videos"]}]},{"platform_id":"zhihu","label":"知乎","english_label":"Zhihu","status":"available","surfaces":[{"surface":"http","status":"available","base_path":"/socialdatax/api/v1/zhihu","description":"公开知乎 HTTP API 提供热榜、内容搜索、详情、博主信息、用户发布文章列表、一级评论和评论回复接口，支持回答、文章、独立视频和带视频的回答。","operations":[{"operation_id":"zhihu_get_hot_list","platform_id":"zhihu","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/zhihu/hot/list","summary":"读取知乎热榜","description":"读取知乎热榜，返回当前热榜问题标题、摘要、热度、回答数和问题链接；当前不支持翻页。","tags":["热榜","知乎"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{},"title":"InternalHotListRequest","type":"object"},"example":{}},"response":{"content_type":"application/json","schema":{"$defs":{"ZhihuHotListItemData":{"properties":{"rank":{"description":"热榜排名，从 1 开始。","title":"Rank","type":"integer"},"question_id":{"description":"知乎问题 ID；用于识别热榜问题，不是详情或评论输入。","title":"Question Id","type":"string"},"title":{"description":"热榜问题标题。","title":"Title","type":"string"},"summary":{"description":"热榜问题摘要；不可用时为空字符串。","title":"Summary","type":"string"},"question_url":{"description":"可打开的知乎问题页面链接；不是详情或评论请求的 content_url。","title":"Question Url","type":"string"},"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"},"answer_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该问题回答数；不可用时为 null。","title":"Answer Count"}},"required":["rank","question_id","title","summary","question_url","cover_image_url","hot_value","answer_count"],"title":"ZhihuHotListItemData","type":"object"}},"properties":{"items":{"description":"当前知乎热榜列表；当前不支持翻页。","items":{"$ref":"#/$defs/ZhihuHotListItemData"},"title":"Items","type":"array"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","points"],"title":"ZhihuHotListResult","type":"object"},"example":{"items":[{"rank":1,"question_id":"2063292318887539352","title":"小红书被曝正主动联系相关老员工，愿补发期权换签署相关条款，真实性多大？若能达成一致，能顺利 IPO 吗？","summary":"7 月初，小红书前员工陈浩向港交所、香港证监会、中国证监会提交实名材料。","question_url":"https://www.zhihu.com/question/2063292318887539352","cover_image_url":"https://example.invalid/zhihu-hot-cover.png","hot_value":11350000,"answer_count":197}],"points":{"cost":10,"balance":990}}},"related_mcp_tools":["zhihu_get_hot_list"]},{"operation_id":"zhihu_search_content","platform_id":"zhihu","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/zhihu/content/search","summary":"搜索知乎内容","description":"按关键词和筛选条件搜索公开知乎内容，返回回答、文章、独立视频或带视频的回答的搜索结果摘要、互动指标和下一页分页令牌。","tags":["内容搜索","知乎"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"keyword":{"title":"Keyword","type":"string","description":"知乎内容搜索关键词；不要传问题链接、回答链接、专栏文章链接、视频链接、用户主页链接或分页 token；如果输入是知乎回答（包括带视频的回答）、专栏文章或独立视频链接，应按用户意图使用详情或评论接口；如果输入是知乎用户主页链接，应按用户意图改用博主信息或用户发布文章列表接口。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"知乎搜索分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一关键词、同一类型筛选、同一排序和同一发布时间筛选链路。更换关键词、类型、排序或发布时间筛选时，请清空 page_token 后从第一页重新搜索。"},"content_type":{"default":"all","enum":["all","answer","article","video"],"title":"Content Type","type":"string","description":"内容类型筛选：all=不限类型，answer=只看回答，article=只看文章，video=只看视频内容（可能返回独立视频 video 或带视频的回答 videoanswer；videoanswer 不是独立视频，也不是筛选取值）。","x-socialdatax-enum-labels":{"all":"不限类型","answer":"只看回答","article":"只看文章","video":"只看视频内容"}},"sort_type":{"default":"general","enum":["general","upvote_count_descending","time_descending"],"title":"Sort Type","type":"string","description":"排序方式：general=综合排序，upvote_count_descending=最多赞同，time_descending=最新发布。如无明确排序需求，保持 general。","x-socialdatax-enum-labels":{"general":"综合排序","upvote_count_descending":"最多赞同","time_descending":"最新发布"}},"publish_time_range":{"default":"all","enum":["all","day","week","month","three_months","half_year","year"],"title":"Publish Time Range","type":"string","description":"发布时间筛选：all=不限时间，day=一天内，week=一周内，month=一月内，three_months=三月内，half_year=半年内，year=一年内。如无明确筛选需求，保持 all。","x-socialdatax-enum-labels":{"all":"不限时间","day":"一天内","week":"一周内","month":"一月内","three_months":"三月内","half_year":"半年内","year":"一年内"}}},"required":["keyword"],"title":"InternalContentSearchRequest","type":"object"},"example":{"keyword":"露营","page_token":"","content_type":"all","sort_type":"general","publish_time_range":"all"}},"response":{"content_type":"application/json","schema":{"$defs":{"ZhihuAnswerSummaryData":{"properties":{"visit_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"回答访问数；不是文章阅读数或视频播放数；不可用时为 null。","title":"Visit Count"}},"required":["visit_count"],"title":"ZhihuAnswerSummaryData","type":"object"},"ZhihuAuthorSummaryData":{"properties":{"user_id":{"description":"知乎作者用户 ID；用于识别作者，不是内容详情、博主资料或作者文章列表输入；不可用时为空字符串。","title":"User Id","type":"string"},"name":{"description":"知乎作者名称；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者主页链接；可作为 zhihu_get_user_info_by_profile_url 或 zhihu_get_user_posted_articles_by_profile_url 的 profile_url；不是内容详情或评论请求的 content_url；不可用时为 null。","title":"Profile Url"},"bio":{"description":"作者简介；不可用时为空字符串。","title":"Bio","type":"string"},"verification_label":{"description":"作者认证文案；不可用时为空字符串。","title":"Verification Label","type":"string"},"verified":{"description":"作者是否为认证账号。","title":"Verified","type":"boolean"},"follower_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"作者粉丝数；不可用时为 null。","title":"Follower Count"},"received_upvote_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"作者累计获得的赞同数；不可用时为 null。","title":"Received Upvote Count"}},"required":["user_id","name","avatar_url","profile_url","bio","verification_label","verified","follower_count","received_upvote_count"],"title":"ZhihuAuthorSummaryData","type":"object"},"ZhihuContentSearchItemData":{"properties":{"content_id":{"description":"知乎内容 ID；结合 content_type 可作为搜索结果去重和引用的稳定键；videoanswer 的 content_id 是回答 ID。不要把 content_id 当作详情或评论输入；读取详情、评论、打开或展示内容时优先使用非空的 content_url。","title":"Content Id","type":"string"},"content_type":{"description":"内容类型；当前可能为 answer、article、video 或 videoanswer。videoanswer 表示带视频的回答，不是独立视频；它的 content_id 是回答 ID，content_url 是回答页链接，传 content_url 读取详情时返回 answer。","enum":["answer","article","video","videoanswer"],"title":"Content Type","type":"string","x-socialdatax-enum-labels":{"answer":"回答","article":"文章","video":"独立视频","videoanswer":"带视频的回答"}},"title":{"description":"内容标题；answer 和 videoanswer 结果通常为所属问题标题；不可用时为空字符串。","title":"Title","type":"string"},"summary":{"description":"搜索结果摘要；不是全文；不可用时为空字符串。","title":"Summary","type":"string"},"content_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"内容页面链接；非空时可作为内容详情或评论请求的 content_url；需要打开或引用内容时优先使用；不可用时为 null。","title":"Content Url"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"封面图链接；不可用时为 null。","title":"Cover Image Url"},"image_urls":{"description":"搜索结果携带的内容图片链接列表；不保证覆盖详情页完整图片；无图片时为空数组。","items":{"type":"string"},"title":"Image Urls","type":"array"},"author":{"$ref":"#/$defs/ZhihuAuthorSummaryData","description":"作者信息。"},"answer":{"anyOf":[{"$ref":"#/$defs/ZhihuAnswerSummaryData"},{"type":"null"}],"description":"回答类指标，不是回答正文；answer 和 videoanswer 结果返回对象，其他结果为 null。"},"question":{"anyOf":[{"$ref":"#/$defs/ZhihuQuestionSummaryData"},{"type":"null"}],"description":"回答所属问题摘要；answer 和 videoanswer 结果返回对象，其他结果为 null。"},"video":{"anyOf":[{"$ref":"#/$defs/ZhihuSearchVideoSummaryData"},{"type":"null"}],"description":"搜索结果携带的视频摘要指标；不包含播放资源 play_url；需要视频播放资源时，用非空的 content_url 调用详情工具；video 和 videoanswer 结果可能返回对象，无视频信息时为 null。"},"upvote_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"赞同数；不可用时为 null。","title":"Upvote Count"},"comment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论数；不可用时为 null。","title":"Comment Count"},"collect_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"收藏数；不可用时为 null。","title":"Collect Count"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"update_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"更新时间，秒级 Unix 时间戳；不可用时为 null。","title":"Update Time"}},"required":["content_id","content_type","title","summary","content_url","cover_image_url","image_urls","author","answer","question","video","upvote_count","comment_count","collect_count","publish_time","update_time"],"title":"ZhihuContentSearchItemData","type":"object"},"ZhihuQuestionSummaryData":{"properties":{"question_id":{"description":"知乎问题 ID；用于按问题聚合回答，不是内容详情或评论输入；不可用时为空字符串。","title":"Question Id","type":"string"},"title":{"description":"问题标题；不可用时为空字符串。","title":"Title","type":"string"},"question_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"知乎问题页面链接；不是内容详情或评论请求的 content_url；不可用时为 null。","title":"Question Url"}},"required":["question_id","title","question_url"],"title":"ZhihuQuestionSummaryData","type":"object"},"ZhihuSearchVideoSummaryData":{"properties":{"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频时长，毫秒；不可用时为 null。","title":"Duration Ms"},"play_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频播放数；不可用时为 null。","title":"Play Count"}},"required":["duration_ms","play_count"],"title":"ZhihuSearchVideoSummaryData","type":"object"}},"properties":{"items":{"description":"当前页知乎内容列表；当前页可能为空，是否可继续翻页以 next_page_token 是否为空为准。","items":{"$ref":"#/$defs/ZhihuContentSearchItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；只用于当前搜索续页；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"ZhihuContentSearchResult","type":"object"},"example":{"items":[{"content_id":"2053174917596821362","content_type":"answer","title":"为什么现在很多人喜欢带孩子去露营？","summary":"从天幕、桌椅到照明和收纳，一份适合周末出行的露营装备清单。","content_url":"https://www.zhihu.com/question/4165158627/answer/2053174917596821362","cover_image_url":"https://example.invalid/zhihu-cover.jpg","image_urls":["https://example.invalid/zhihu-content-image.jpg"],"author":{"user_id":"1553efc24f115be8de96f5b0940641e5","name":"圆圆鱼","avatar_url":"https://example.invalid/zhihu-avatar.jpg","profile_url":"https://www.zhihu.com/people/ba-fei-yu-chi-chi","bio":"儿童用品、懒人家电、数码好物测评及体验分享","verification_label":"诺丁汉大学 理学硕士","verified":true,"follower_count":2127,"received_upvote_count":12521},"answer":{"visit_count":966},"question":{"question_id":"4165158627","title":"为什么现在很多人喜欢带孩子去露营？","question_url":"https://www.zhihu.com/question/4165158627"},"video":null,"upvote_count":4,"comment_count":2,"collect_count":0,"publish_time":1782295046,"update_time":1782295046}],"next_page_token":"opaque-search-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["zhihu_search_content"]},{"operation_id":"zhihu_get_content_detail","platform_id":"zhihu","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/zhihu/content/detail","summary":"获取知乎内容详情","description":"根据知乎回答页（包括带视频的回答）、专栏文章页或独立视频页链接获取公开知乎内容详情。","tags":["内容详情","知乎"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"content_url":{"title":"Content Url","type":"string","description":"知乎内容页面链接；只传下面三类已支持的知乎网页链接格式，不要传接口地址、短链接、移动端链接或包含链接的分享文案；从搜索结果读取详情时，直接传搜索结果里非空的 content_url；不要只传 content_id 或数字 ID，不要自行拼接链接；不要传问题页链接或作者主页链接；支持回答页链接（包括带视频的回答） https://www.zhihu.com/question/{question_id}/answer/{answer_id}、专栏文章链接 https://zhuanlan.zhihu.com/p/{article_id}、独立视频链接 https://www.zhihu.com/zvideo/{zvideo_id}。"}},"required":["content_url"],"title":"InternalContentDetailRequest","type":"object"},"example":{"content_url":"https://www.zhihu.com/question/4165158627/answer/2053174917596821362"}},"response":{"content_type":"application/json","schema":{"$defs":{"ZhihuAuthorSummaryData":{"properties":{"user_id":{"description":"知乎作者用户 ID；用于识别作者，不是内容详情、博主资料或作者文章列表输入；不可用时为空字符串。","title":"User Id","type":"string"},"name":{"description":"知乎作者名称；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者主页链接；可作为 zhihu_get_user_info_by_profile_url 或 zhihu_get_user_posted_articles_by_profile_url 的 profile_url；不是内容详情或评论请求的 content_url；不可用时为 null。","title":"Profile Url"},"bio":{"description":"作者简介；不可用时为空字符串。","title":"Bio","type":"string"},"verification_label":{"description":"作者认证文案；不可用时为空字符串。","title":"Verification Label","type":"string"},"verified":{"description":"作者是否为认证账号。","title":"Verified","type":"boolean"},"follower_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"作者粉丝数；不可用时为 null。","title":"Follower Count"},"received_upvote_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"作者累计获得的赞同数；不可用时为 null。","title":"Received Upvote Count"}},"required":["user_id","name","avatar_url","profile_url","bio","verification_label","verified","follower_count","received_upvote_count"],"title":"ZhihuAuthorSummaryData","type":"object"},"ZhihuImageData":{"properties":{"url":{"description":"图片链接。","title":"Url","type":"string"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片宽度，像素；不可用时为 null。","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"图片高度，像素；不可用时为 null。","title":"Height"}},"required":["url","width","height"],"title":"ZhihuImageData","type":"object"},"ZhihuQuestionSummaryData":{"properties":{"question_id":{"description":"知乎问题 ID；用于按问题聚合回答，不是内容详情或评论输入；不可用时为空字符串。","title":"Question Id","type":"string"},"title":{"description":"问题标题；不可用时为空字符串。","title":"Title","type":"string"},"question_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"知乎问题页面链接；不是内容详情或评论请求的 content_url；不可用时为 null。","title":"Question Url"}},"required":["question_id","title","question_url"],"title":"ZhihuQuestionSummaryData","type":"object"},"ZhihuTopicTagData":{"additionalProperties":false,"properties":{"name":{"description":"话题标签名称。","title":"Name","type":"string"}},"required":["name"],"title":"ZhihuTopicTagData","type":"object"},"ZhihuVideoSummaryData":{"properties":{"play_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"视频播放资源链接；优先返回高清 MP4 资源；可能随时间失效，不是内容页面 content_url；不可用时为 null。","title":"Play Url"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频时长，毫秒；不可用时为 null。","title":"Duration Ms"},"play_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频播放数；不可用时为 null。","title":"Play Count"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频宽度，像素；不可用时为 null。","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频高度，像素；不可用时为 null。","title":"Height"}},"required":["play_url","duration_ms","play_count","width","height"],"title":"ZhihuVideoSummaryData","type":"object"}},"properties":{"content_id":{"description":"知乎内容 ID；用于识别内容；不要把 content_id 当作详情或评论输入。","title":"Content Id","type":"string"},"content_type":{"description":"内容类型：answer=回答（包括带视频的回答详情），article=文章，video=独立视频；详情不会返回 videoanswer。","enum":["answer","article","video"],"title":"Content Type","type":"string","x-socialdatax-enum-labels":{"answer":"回答","article":"文章","video":"独立视频"}},"title":{"description":"内容标题；answer 通常为所属问题标题。","title":"Title","type":"string"},"content":{"description":"详情正文或视频描述纯文本；视频详情不是视频转写；不可用时为空字符串。","title":"Content","type":"string"},"content_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"可打开的知乎内容页面链接；可作为评论请求的 content_url；不可用时为 null；不要自行拼接。","title":"Content Url"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"封面图链接；不可用时为 null。","title":"Cover Image Url"},"image_urls":{"description":"回答或文章详情正文中解析到的图片链接列表；视频详情返回空数组；无图片时为空数组。","items":{"type":"string"},"title":"Image Urls","type":"array"},"images":{"description":"正文图片列表，包含链接及宽高；无图时为空数组。","items":{"$ref":"#/$defs/ZhihuImageData"},"title":"Images","type":"array"},"author":{"$ref":"#/$defs/ZhihuAuthorSummaryData","description":"作者信息。"},"question":{"anyOf":[{"$ref":"#/$defs/ZhihuQuestionSummaryData"},{"type":"null"}],"description":"回答所属问题摘要；answer（包括带视频的回答详情）返回对象，article 和独立视频 video 为 null。"},"video":{"anyOf":[{"$ref":"#/$defs/ZhihuVideoSummaryData"},{"type":"null"}],"description":"视频信息；独立视频详情和带视频的回答详情可能返回对象；包含可用时的播放资源 play_url；普通回答、文章或无视频信息时为 null。"},"upvote_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"赞同数；不可用时为 null。","title":"Upvote Count"},"comment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论数；不可用时为 null。","title":"Comment Count"},"collect_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"收藏数；不可用时为 null。","title":"Collect Count"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"喜欢数；与赞同数 upvote_count 不同；不可用时为 null。","title":"Like Count"},"share_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"分享数；不可用时为 null。","title":"Share Count"},"ip_location":{"description":"IP 属地；不可用时为空字符串。","title":"Ip Location","type":"string"},"topic_tags":{"description":"知乎话题标签列表；无标签时为空数组；每项只返回 name。","items":{"$ref":"#/$defs/ZhihuTopicTagData"},"title":"Topic Tags","type":"array"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"update_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"更新时间，秒级 Unix 时间戳；不可用时为 null。","title":"Update Time"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["content_id","content_type","title","content","content_url","cover_image_url","image_urls","images","author","question","video","upvote_count","comment_count","collect_count","like_count","share_count","ip_location","topic_tags","publish_time","update_time","points"],"title":"ZhihuContentDetailData","type":"object"},"example":{"content_id":"2053174917596821362","content_type":"answer","title":"为什么现在很多人喜欢带孩子去露营？","content":"今年夏天，我才开始喜欢带女儿露营。露营的体验感实在是太好了！","content_url":"https://www.zhihu.com/question/4165158627/answer/2053174917596821362","cover_image_url":"https://example.invalid/zhihu-content-image.jpg","image_urls":["https://example.invalid/zhihu-content-image.jpg"],"images":[{"url":"https://example.invalid/zhihu-content-image.jpg","width":3072,"height":4096}],"author":{"user_id":"1553efc24f115be8de96f5b0940641e5","name":"圆圆鱼","avatar_url":"https://example.invalid/zhihu-avatar.jpg","profile_url":"https://www.zhihu.com/people/ba-fei-yu-chi-chi","bio":"儿童用品、懒人家电、数码好物测评及体验分享","verification_label":"诺丁汉大学 理学硕士","verified":true,"follower_count":null,"received_upvote_count":null},"question":{"question_id":"4165158627","title":"为什么现在很多人喜欢带孩子去露营？","question_url":"https://www.zhihu.com/question/4165158627"},"video":null,"upvote_count":4,"comment_count":2,"collect_count":0,"like_count":null,"share_count":null,"ip_location":"","topic_tags":[],"publish_time":1782295046,"update_time":1782295046,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["zhihu_get_content_detail_by_url"]},{"operation_id":"zhihu_get_user_info","platform_id":"zhihu","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/zhihu/user/info","summary":"获取知乎博主信息","description":"根据知乎用户主页链接获取公开博主资料，返回基础信息、性别、认证、粉丝数、公开回答数、公开文章数和 IP 属地。","tags":["博主信息","知乎"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"profile_url":{"title":"Profile Url","type":"string","description":"知乎用户主页链接；只传 https://www.zhihu.com/people/{url_token} 这种主页链接；不要传 user_id、昵称、回答链接、专栏文章链接、问题页链接、接口地址、短链接、移动端链接或包含链接的分享文案；从搜索结果、详情、评论或评论回复里的 author.profile_url 继续获取博主资料时，直接复用该非空 profile_url。"}},"required":["profile_url"],"title":"InternalUserInfoRequest","type":"object"},"example":{"profile_url":"https://www.zhihu.com/people/ba-fei-yu-chi-chi"}},"response":{"content_type":"application/json","schema":{"properties":{"user_id":{"description":"知乎用户 ID；用于识别博主，不是当前知乎博主资料或作者文章列表输入；不可用时为空字符串。","title":"User Id","type":"string"},"name":{"description":"知乎用户名称；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"知乎用户主页链接；可直接复用为 zhihu_get_user_info_by_profile_url 或 zhihu_get_user_posted_articles_by_profile_url 的 profile_url；不可用时为 null。","title":"Profile Url"},"bio":{"description":"知乎用户简介；不可用时为空字符串。","title":"Bio","type":"string"},"gender":{"description":"知乎用户性别：male=男，female=女，unknown=未知。","enum":["male","female","unknown"],"title":"Gender","type":"string","x-socialdatax-enum-labels":{"male":"男","female":"女","unknown":"未知"}},"verification_label":{"description":"知乎用户认证文案；不可用时为空字符串。","title":"Verification Label","type":"string"},"verified":{"description":"知乎用户是否为认证账号。","title":"Verified","type":"boolean"},"follower_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"知乎用户粉丝数；不可用时为 null。","title":"Follower Count"},"answer_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"知乎用户公开回答数；不可用时为 null。","title":"Answer Count"},"article_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"知乎用户公开文章数；不可用时为 null。","title":"Article Count"},"ip_location":{"description":"知乎用户 IP 属地；不可用时为空字符串。","title":"Ip Location","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["user_id","name","avatar_url","profile_url","bio","gender","verification_label","verified","follower_count","answer_count","article_count","ip_location","points"],"title":"ZhihuUserInfoData","type":"object"},"example":{"user_id":"1553efc24f115be8de96f5b0940641e5","name":"圆圆鱼","avatar_url":"https://example.invalid/zhihu-avatar.jpg","profile_url":"https://www.zhihu.com/people/ba-fei-yu-chi-chi","bio":"儿童用品、懒人家电、数码好物测评及体验分享","gender":"female","verification_label":"诺丁汉大学 理学硕士","verified":true,"follower_count":2128,"answer_count":364,"article_count":62,"ip_location":"北京","points":{"cost":10,"balance":990}}},"related_mcp_tools":["zhihu_get_user_info_by_profile_url"]},{"operation_id":"zhihu_get_user_posted_articles","platform_id":"zhihu","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/zhihu/user/article/list","summary":"读取知乎用户发布文章列表","description":"根据知乎用户主页链接读取该作者发布文章列表，返回文章摘要、互动指标和下一页分页令牌；当前按最新发布顺序返回。用于作者作品列表或博主作品列表场景时，当前仅支持文章列表，不返回回答、想法或视频。","tags":["用户文章","作者文章","博主文章","知乎"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"profile_url":{"title":"Profile Url","type":"string","description":"知乎用户主页链接；只传 https://www.zhihu.com/people/{url_token} 这种主页链接；不要传 user_id、昵称、回答链接、专栏文章链接、问题页链接、接口地址、短链接、移动端链接或包含链接的分享文案；从搜索结果、详情、评论或评论回复里的 author.profile_url 继续读取作者发布文章列表时，或从博主信息结果里的 profile_url 继续读取作者发布文章列表时，直接复用该非空 profile_url。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"知乎用户发布文章列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一 profile_url 的文章列表链路；更换作者时，请清空 page_token 后从第一页重新读取。"}},"required":["profile_url"],"title":"InternalUserPostedArticlesRequest","type":"object"},"example":{"profile_url":"https://www.zhihu.com/people/tony.ting","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"ZhihuAuthorSummaryData":{"properties":{"user_id":{"description":"知乎作者用户 ID；用于识别作者，不是内容详情、博主资料或作者文章列表输入；不可用时为空字符串。","title":"User Id","type":"string"},"name":{"description":"知乎作者名称；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者主页链接；可作为 zhihu_get_user_info_by_profile_url 或 zhihu_get_user_posted_articles_by_profile_url 的 profile_url；不是内容详情或评论请求的 content_url；不可用时为 null。","title":"Profile Url"},"bio":{"description":"作者简介；不可用时为空字符串。","title":"Bio","type":"string"},"verification_label":{"description":"作者认证文案；不可用时为空字符串。","title":"Verification Label","type":"string"},"verified":{"description":"作者是否为认证账号。","title":"Verified","type":"boolean"},"follower_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"作者粉丝数；不可用时为 null。","title":"Follower Count"},"received_upvote_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"作者累计获得的赞同数；不可用时为 null。","title":"Received Upvote Count"}},"required":["user_id","name","avatar_url","profile_url","bio","verification_label","verified","follower_count","received_upvote_count"],"title":"ZhihuAuthorSummaryData","type":"object"},"ZhihuUserPostedArticleItemData":{"properties":{"content_id":{"description":"知乎内容 ID；用于识别用户发布文章列表项；不要把 content_id 当作详情、评论或博主资料输入。","title":"Content Id","type":"string"},"title":{"description":"文章标题；不可用时为空字符串。","title":"Title","type":"string"},"summary":{"description":"文章列表摘要；不是详情全文；不可用时为空字符串。","title":"Summary","type":"string"},"content_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"可打开的知乎文章页面链接；非空时可作为详情或评论请求的 content_url；不可用时为 null。","title":"Content Url"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"封面图链接；不可用时为 null。","title":"Cover Image Url"},"author":{"$ref":"#/$defs/ZhihuAuthorSummaryData","description":"作者信息。"},"upvote_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"赞同数；不可用时为 null。","title":"Upvote Count"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"喜欢数；与赞同数 upvote_count 不同；不可用时为 null。","title":"Like Count"},"comment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论数；不可用时为 null。","title":"Comment Count"},"collect_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"收藏数；不可用时为 null。","title":"Collect Count"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"update_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"更新时间，秒级 Unix 时间戳；不可用时为 null。","title":"Update Time"}},"required":["content_id","title","summary","content_url","cover_image_url","author","upvote_count","like_count","comment_count","collect_count","publish_time","update_time"],"title":"ZhihuUserPostedArticleItemData","type":"object"}},"properties":{"items":{"description":"当前页知乎用户发布文章列表；当前页可能为空，是否可继续翻页以 next_page_token 是否为空为准。","items":{"$ref":"#/$defs/ZhihuUserPostedArticleItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；只用于当前用户发布文章列表续页；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"ZhihuUserPostedArticlesResult","type":"object"},"example":{"items":[{"content_id":"2044771174773785063","title":"从山野到市井，户外装备在你需要的时候能托住你","summary":"周末去了皮缝峡谷溯溪徒步，全程 8km，路线轻松，适合夏天亲子户外。","content_url":"https://zhuanlan.zhihu.com/p/2044771174773785063","cover_image_url":null,"author":{"user_id":"d66b2d62299707fc3261ad598a722b75","name":"疯狂的Tim","avatar_url":"https://example.invalid/zhihu-avatar.jpg","profile_url":"https://www.zhihu.com/people/tony.ting","bio":"旅行者、露营佬、钓鱼佬、前程序员、伪产品","verification_label":"","verified":false,"follower_count":null,"received_upvote_count":null},"upvote_count":26,"like_count":0,"comment_count":4,"collect_count":22,"publish_time":1780292248,"update_time":1780294962}],"next_page_token":"opaque-user-posted-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["zhihu_get_user_posted_articles_by_profile_url"]},{"operation_id":"zhihu_get_content_comments","platform_id":"zhihu","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/zhihu/content/comment/list","summary":"读取知乎内容一级评论","description":"根据知乎回答页（包括带视频的回答）、专栏文章页或独立视频页链接读取公开一级评论，返回评论内容、作者、互动信息和下一页分页令牌。","tags":["评论","知乎"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"content_url":{"title":"Content Url","type":"string","description":"知乎内容页面链接；只传回答页链接（包括带视频的回答）、专栏文章链接或独立视频链接；从搜索结果中的 answer、article、video 或 videoanswer 读取评论时，直接传该结果里非空的 content_url；不要只传 content_id 或数字 ID，不要传接口地址、短链接、移动端链接、包含链接的分享文案、问题页链接或作者主页链接；支持回答页链接 https://www.zhihu.com/question/{question_id}/answer/{answer_id}、专栏文章链接 https://zhuanlan.zhihu.com/p/{article_id}、独立视频链接 https://www.zhihu.com/zvideo/{zvideo_id}。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"知乎评论分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一 content_url 和同一排序链路；更换链接或排序时，请清空 page_token 后从第一页重新读取评论。"},"sort_type":{"default":"default","enum":["default","time_descending"],"title":"Sort Type","type":"string","description":"评论排序方式：default=默认，time_descending=最新。如无明确排序需求，保持 default。","x-socialdatax-enum-labels":{"default":"默认","time_descending":"最新"}}},"required":["content_url"],"title":"InternalContentCommentsRequest","type":"object"},"example":{"content_url":"https://www.zhihu.com/question/4165158627/answer/2053174917596821362","page_token":"","sort_type":"default"}},"response":{"content_type":"application/json","schema":{"$defs":{"ZhihuAuthorSummaryData":{"properties":{"user_id":{"description":"知乎作者用户 ID；用于识别作者，不是内容详情、博主资料或作者文章列表输入；不可用时为空字符串。","title":"User Id","type":"string"},"name":{"description":"知乎作者名称；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者主页链接；可作为 zhihu_get_user_info_by_profile_url 或 zhihu_get_user_posted_articles_by_profile_url 的 profile_url；不是内容详情或评论请求的 content_url；不可用时为 null。","title":"Profile Url"},"bio":{"description":"作者简介；不可用时为空字符串。","title":"Bio","type":"string"},"verification_label":{"description":"作者认证文案；不可用时为空字符串。","title":"Verification Label","type":"string"},"verified":{"description":"作者是否为认证账号。","title":"Verified","type":"boolean"},"follower_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"作者粉丝数；不可用时为 null。","title":"Follower Count"},"received_upvote_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"作者累计获得的赞同数；不可用时为 null。","title":"Received Upvote Count"}},"required":["user_id","name","avatar_url","profile_url","bio","verification_label","verified","follower_count","received_upvote_count"],"title":"ZhihuAuthorSummaryData","type":"object"},"ZhihuCommentItemData":{"properties":{"comment_id":{"description":"知乎一级评论 ID；可作为 zhihu_get_comment_replies_by_url 的 comment_id。","title":"Comment Id","type":"string"},"content":{"description":"评论正文纯文本；不可用时为空字符串。","title":"Content","type":"string"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论点赞数；不可用时为 null。","title":"Like Count"},"reply_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"一级评论下的回复数；不可用时为 null。","title":"Reply Count"},"is_pinned":{"description":"评论是否置顶。","title":"Is Pinned","type":"boolean"},"is_author_comment":{"description":"是否为内容作者本人发布的评论。","title":"Is Author Comment","type":"boolean"},"ip_location":{"description":"评论发布时的 IP 属地；不可用时为空字符串。","title":"Ip Location","type":"string"},"author":{"$ref":"#/$defs/ZhihuAuthorSummaryData","description":"评论作者信息。"}},"required":["comment_id","content","publish_time","like_count","reply_count","is_pinned","is_author_comment","ip_location","author"],"title":"ZhihuCommentItemData","type":"object"}},"properties":{"items":{"description":"当前页一级评论列表；当前页可能为空数组；是否可继续翻页以 next_page_token 是否为空为准。","items":{"$ref":"#/$defs/ZhihuCommentItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；只用于当前评论续页；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成。","title":"Next Page Token","type":"string"},"comment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该评论区评论数；不是当前页 items 数量；独立视频场景下也不一定等于一级评论总数；不可用时为 null。","title":"Comment Count"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","comment_count","points"],"title":"ZhihuContentCommentsResult","type":"object"},"example":{"items":[{"comment_id":"11530807997","content":"夏天露营帐篷里会很热吧？我们家俩娃特别怕热","publish_time":1784093413,"like_count":0,"reply_count":0,"is_pinned":false,"is_author_comment":false,"ip_location":"江苏","author":{"user_id":"5798cfe54c036315482144636212c677","name":"小团子mummy","avatar_url":"https://example.invalid/zhihu-comment-avatar.jpg","profile_url":"https://www.zhihu.com/people/qiu-yue-xiao-18","bio":"家有一双姐妹花/职场妈妈/分享育儿知识","verification_label":"东南大学 管理学硕士","verified":true,"follower_count":null,"received_upvote_count":null}}],"next_page_token":"","comment_count":2,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["zhihu_get_content_comments_by_url"]},{"operation_id":"zhihu_get_comment_replies","platform_id":"zhihu","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/zhihu/content/comment/reply/list","summary":"读取知乎评论回复","description":"根据知乎内容页链接和一级评论 ID 读取公开评论回复，返回回复正文、作者、互动信息和下一页分页令牌。","tags":["评论回复","知乎"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"content_url":{"title":"Content Url","type":"string","description":"知乎内容页面链接；用户已提供时直接使用，否则请直接复用读取该一级评论时使用的回答页链接（包括带视频的回答）、专栏文章链接或独立视频链接；通常直接复用 zhihu_get_content_comments_by_url 使用的 content_url；不要只传 content_id 或数字 ID，不要传接口地址、短链接、移动端链接、包含链接的分享文案、问题页链接或作者主页链接；支持回答页链接 https://www.zhihu.com/question/{question_id}/answer/{answer_id}、专栏文章链接 https://zhuanlan.zhihu.com/p/{article_id}、独立视频链接 https://www.zhihu.com/zvideo/{zvideo_id}。"},"comment_id":{"title":"Comment Id","type":"string","description":"一级评论 ID；用户已提供时直接使用，否则请直接复制 zhihu_get_content_comments_by_url 返回的 items[*].comment_id；不要传评论回复项自身的 comment_id。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"知乎评论回复分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一 content_url 和同一 comment_id 链路；更换链接或一级评论 comment_id 时，请清空 page_token 后从第一页重新读取回复。"}},"required":["content_url","comment_id"],"title":"InternalContentCommentRepliesRequest","type":"object"},"example":{"content_url":"https://www.zhihu.com/question/475060406/answer/2069978930","comment_id":"4706610382","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"ZhihuAuthorSummaryData":{"properties":{"user_id":{"description":"知乎作者用户 ID；用于识别作者，不是内容详情、博主资料或作者文章列表输入；不可用时为空字符串。","title":"User Id","type":"string"},"name":{"description":"知乎作者名称；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者主页链接；可作为 zhihu_get_user_info_by_profile_url 或 zhihu_get_user_posted_articles_by_profile_url 的 profile_url；不是内容详情或评论请求的 content_url；不可用时为 null。","title":"Profile Url"},"bio":{"description":"作者简介；不可用时为空字符串。","title":"Bio","type":"string"},"verification_label":{"description":"作者认证文案；不可用时为空字符串。","title":"Verification Label","type":"string"},"verified":{"description":"作者是否为认证账号。","title":"Verified","type":"boolean"},"follower_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"作者粉丝数；不可用时为 null。","title":"Follower Count"},"received_upvote_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"作者累计获得的赞同数；不可用时为 null。","title":"Received Upvote Count"}},"required":["user_id","name","avatar_url","profile_url","bio","verification_label","verified","follower_count","received_upvote_count"],"title":"ZhihuAuthorSummaryData","type":"object"},"ZhihuCommentReplyItemData":{"properties":{"comment_id":{"description":"当前评论回复自身的评论 ID；不是输入里的一级评论 comment_id。","title":"Comment Id","type":"string"},"parent_comment_id":{"description":"所属一级评论 ID；等于本次读取回复时传入的一级评论 comment_id。","title":"Parent Comment Id","type":"string"},"reply_to_comment_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"被回复的二级评论 ID；直接回复一级评论时为 null。","title":"Reply To Comment Id"},"content":{"description":"评论回复正文纯文本；不可用时为空字符串。","title":"Content","type":"string"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论回复发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论回复点赞数；不可用时为 null。","title":"Like Count"},"is_author_comment":{"description":"是否为内容作者本人发布的评论回复。","title":"Is Author Comment","type":"boolean"},"ip_location":{"description":"评论回复发布时的 IP 属地；不可用时为空字符串。","title":"Ip Location","type":"string"},"author":{"$ref":"#/$defs/ZhihuAuthorSummaryData","description":"评论回复作者信息。"}},"required":["comment_id","parent_comment_id","reply_to_comment_id","content","publish_time","like_count","is_author_comment","ip_location","author"],"title":"ZhihuCommentReplyItemData","type":"object"}},"properties":{"items":{"description":"当前页评论回复列表；当前页可能为空数组；是否可继续翻页以 next_page_token 是否为空为准。","items":{"$ref":"#/$defs/ZhihuCommentReplyItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；只用于当前评论回复续页；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成。","title":"Next Page Token","type":"string"},"reply_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该一级评论下的回复总数；不是当前页 items 数量；不可用时为 null。","title":"Reply Count"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","reply_count","points"],"title":"ZhihuCommentRepliesResult","type":"object"},"example":{"items":[{"comment_id":"4709420367","parent_comment_id":"4706610382","reply_to_comment_id":"4707764753","content":"大才能挡更多啊，小了那还不搞一身[流泪]","publish_time":1631784334,"like_count":1,"is_author_comment":false,"ip_location":"","author":{"user_id":"ae0071708fd6aa8e2310cd4d507c2ffd","name":"扬灵","avatar_url":"https://example.invalid/zhihu-comment-avatar.jpg","profile_url":"https://www.zhihu.com/people/xie-wen-60-35","bio":"","verification_label":"","verified":false,"follower_count":null,"received_upvote_count":null}}],"next_page_token":"","reply_count":6,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["zhihu_get_comment_replies_by_url"]}]},{"surface":"mcp","status":"available","endpoint":"https://mcp.socialdatax.com/zhihu/mcp","authentication":{"required":true},"capabilities_resource":"zhihu://guides/tool-capabilities","related_http_operation_ids":["zhihu_get_hot_list","zhihu_search_content","zhihu_get_content_detail","zhihu_get_user_info","zhihu_get_user_posted_articles","zhihu_get_content_comments","zhihu_get_comment_replies"]}]},{"platform_id":"instagram","label":"Instagram","english_label":"Instagram","status":"available","surfaces":[{"surface":"http","status":"available","base_path":"/socialdatax/api/v1/instagram","description":"公开 Instagram HTTP API 提供搜索、帖子详情、评论、评论回复、用户信息和用户帖子列表接口。","operations":[{"operation_id":"instagram_search_posts","platform_id":"instagram","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/instagram/post/search","summary":"搜索 Instagram 帖子","description":"按关键词搜索公开 Instagram 帖子，返回结构化帖子信息和下一页分页令牌。","tags":["帖子搜索","Instagram"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"keyword":{"title":"Keyword","type":"string","description":"Instagram 帖子搜索词，可传关键词或短语，例如品牌名、话题、人物名或内容需求；不要传帖子链接、用户主页链接、post_id、username 或 page_token。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"Instagram 搜索分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一关键词链路。更换关键词时，请清空 page_token 后从第一页重新搜索。"}},"required":["keyword"],"title":"InternalInstagramPostSearchRequest","type":"object"},"example":{"keyword":"camping","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"InstagramLocationData":{"properties":{"location_id":{"description":"Instagram 地点 ID；不可用时为空字符串。","title":"Location Id","type":"string"},"name":{"description":"地点名称；不可用时为空字符串。","title":"Name","type":"string"},"address":{"description":"地点地址；不可用时为空字符串。","title":"Address","type":"string"},"city":{"description":"地点城市；不可用时为空字符串。","title":"City","type":"string"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"地点纬度；不可用时为 null。","title":"Latitude"},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"地点经度；不可用时为 null。","title":"Longitude"}},"required":["location_id","name","address","city","latitude","longitude"],"title":"InstagramLocationData","type":"object"},"InstagramMediaItemData":{"properties":{"media_id":{"description":"媒体项 ID；不可用时为空字符串。","title":"Media Id","type":"string"},"media_type":{"description":"媒体项类型；photo 表示图片，video 表示视频。","enum":["photo","video"],"title":"Media Type","type":"string","x-socialdatax-enum-labels":{"photo":"图片","video":"视频"}},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"媒体项封面图链接；图片媒体为图片本身，视频媒体为视频封面；不可用时为 null。","title":"Cover Image Url"},"video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"视频播放资源链接；图片媒体或不可用时为 null。","title":"Video Url"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"媒体宽度，像素；不可用时为 null。","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"媒体高度，像素；不可用时为 null。","title":"Height"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频时长，单位毫秒；图片媒体或不可用时为 null。","title":"Duration Ms"},"alt_text":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"媒体替代文本说明；不可用时为 null。","title":"Alt Text"}},"required":["media_id","media_type","cover_image_url","video_url","width","height","duration_ms","alt_text"],"title":"InstagramMediaItemData","type":"object"},"InstagramMentionedUserData":{"properties":{"username":{"description":"文本中 @ 到的用户名，不带 @。","title":"Username","type":"string"}},"required":["username"],"title":"InstagramMentionedUserData","type":"object"},"InstagramMusicData":{"properties":{"music_id":{"description":"音乐 ID；不可用时为空字符串。","title":"Music Id","type":"string"},"title":{"description":"音乐标题；不可用时为空字符串。","title":"Title","type":"string"},"artist_name":{"description":"音乐艺术家名称；不可用时为空字符串。","title":"Artist Name","type":"string"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"音乐封面图链接；不可用时为 null。","title":"Cover Image Url"},"play_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"音乐播放资源链接；不可用时为 null。","title":"Play Url"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"音乐时长，单位毫秒；不可用时为 null。","title":"Duration Ms"}},"required":["music_id","title","artist_name","cover_image_url","play_url","duration_ms"],"title":"InstagramMusicData","type":"object"},"InstagramPostSearchItemData":{"properties":{"post_id":{"description":"Instagram 帖子 ID。","title":"Post Id","type":"string"},"post_type":{"description":"帖子类型；photo 表示照片帖子，video 表示视频帖子，carousel 表示轮播帖子。","enum":["photo","video","carousel"],"title":"Post Type","type":"string","x-socialdatax-enum-labels":{"photo":"照片帖子","video":"视频帖子","carousel":"轮播帖子"}},"share_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Instagram 帖子分享页链接；不可用时为 null。","title":"Share Url"},"caption":{"description":"帖子配文；没有配文时为空字符串。","title":"Caption","type":"string"},"topic_tags":{"description":"帖子配文中的话题标签；无话题标签时为空数组；每项只返回 name，不带 #。","items":{"$ref":"#/$defs/InstagramTopicTagData"},"title":"Topic Tags","type":"array"},"mentioned_users":{"description":"帖子配文中 @ 到的用户名；无 @ 时为空数组；每项只返回 username，不带 @。","items":{"$ref":"#/$defs/InstagramMentionedUserData"},"title":"Mentioned Users","type":"array"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"帖子封面图链接；不可用时为 null。","title":"Cover Image Url"},"media_count":{"description":"帖子包含的媒体数量。","title":"Media Count","type":"integer"},"media_items":{"description":"帖子包含的图片/视频媒体列表；单图/单视频通常 1 项，轮播帖按顺序返回多项。","items":{"$ref":"#/$defs/InstagramMediaItemData"},"title":"Media Items","type":"array"},"music":{"anyOf":[{"$ref":"#/$defs/InstagramMusicData"},{"type":"null"}],"description":"帖子关联音乐/配乐信息；没有可返回的音乐信息时为 null。"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"点赞数；不可用时为 null。","title":"Like Count"},"comment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论数；不可用时为 null。","title":"Comment Count"},"play_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Instagram 播放/观看数；没有视频或不可用时为 null。","title":"Play Count"},"repost_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"转发/再分享数；不可用时为 null。","title":"Repost Count"},"comments_disabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"是否禁止发评论；true 表示已禁止，false 表示未禁止，null 表示不可用。","title":"Comments Disabled"},"like_and_view_counts_hidden":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"平台展示层是否隐藏点赞数或播放/观看数；true 表示已隐藏，false 表示未隐藏，null 表示不可用。","title":"Like And View Counts Hidden"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"location":{"anyOf":[{"$ref":"#/$defs/InstagramLocationData"},{"type":"null"}],"description":"帖子地理标记地点/POI，不是 IP 属地；没有地点时为 null。"},"tagged_users":{"description":"帖子图片或视频中标记的用户列表；无标记用户时为空数组。","items":{"$ref":"#/$defs/InstagramUserSummaryData"},"title":"Tagged Users","type":"array"},"collaborators":{"description":"帖子共同发布者/协作者列表；无共同发布者时为空数组。","items":{"$ref":"#/$defs/InstagramUserSummaryData"},"title":"Collaborators","type":"array"},"author":{"anyOf":[{"$ref":"#/$defs/InstagramUserSummaryData"},{"type":"null"}],"description":"帖子作者信息；不可用时为 null。"}},"required":["post_id","post_type","share_url","caption","topic_tags","mentioned_users","cover_image_url","media_count","media_items","music","like_count","comment_count","play_count","repost_count","comments_disabled","like_and_view_counts_hidden","publish_time","location","tagged_users","collaborators","author"],"title":"InstagramPostSearchItemData","type":"object"},"InstagramTopicTagData":{"properties":{"name":{"description":"话题标签名称，不带 #。","title":"Name","type":"string"}},"required":["name"],"title":"InstagramTopicTagData","type":"object"},"InstagramUserSummaryData":{"properties":{"user_id":{"description":"Instagram 用户稳定数字 ID；不可用时为空字符串。","title":"User Id","type":"string"},"username":{"description":"Instagram 用户名，不带 @；不可用时为空字符串。","title":"Username","type":"string"},"name":{"description":"用户展示名；不是 username；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户主页链接；通常可直接打开作者主页；不可用时为 null。","title":"Profile Url"},"is_verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"是否认证；不可用时为 null。","title":"Is Verified"}},"required":["user_id","username","name","avatar_url","profile_url","is_verified"],"title":"InstagramUserSummaryData","type":"object"}},"properties":{"items":{"description":"当前页 Instagram 搜索结果列表；当前页可能为空，是否可继续翻页以 next_page_token 是否为空为准。","items":{"$ref":"#/$defs/InstagramPostSearchItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；只用于当前搜索续页；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"InstagramPostSearchResult","type":"object"},"example":{"items":[{"post_id":"3893365017811200987","post_type":"photo","share_url":"https://www.instagram.com/p/DYIAtsTkavb/","caption":"Weekend camping inspiration.\n\n#camping #outdoor","topic_tags":[{"name":"camping"},{"name":"outdoor"}],"mentioned_users":[],"cover_image_url":"https://example.invalid/instagram-cover.jpg","media_count":1,"media_items":[{"media_id":"3893365017811200987","media_type":"photo","cover_image_url":"https://example.invalid/instagram-cover.jpg","video_url":null,"width":1246,"height":1438,"duration_ms":null,"alt_text":"Photo by Camping Journal on May 09, 2026."}],"music":{"music_id":"144106568633110","title":"Campfire Weekend","artist_name":"Campfire Sounds","cover_image_url":"https://example.invalid/music-cover.jpg","play_url":"https://example.invalid/music.mp3","duration_ms":205676},"like_count":71709,"comment_count":583,"play_count":null,"repost_count":5449,"comments_disabled":null,"like_and_view_counts_hidden":false,"publish_time":1778345323,"location":null,"tagged_users":[],"collaborators":[],"author":{"user_id":"77903045825","username":"camping_journal","name":"Camping Journal","avatar_url":"https://example.invalid/avatar-hd.jpg","profile_url":"https://www.instagram.com/camping_journal/","is_verified":false}}],"next_page_token":"opaque-search-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["instagram_search_posts"]},{"operation_id":"instagram_get_post_detail","platform_id":"instagram","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/instagram/post/detail","summary":"获取 Instagram 帖子详情","description":"按帖子 ID 或帖子链接获取公开 Instagram 帖子详情，返回结构化帖子、媒体、互动指标和作者信息。","tags":["帖子详情","Instagram"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"post_id":{"default":"","title":"Post Id","type":"string","description":"Instagram 帖子 ID（数字字符串）；用户已提供时原样使用，否则可从搜索结果或详情结果的 post_id 原样复制；不要传 shortcode、用户名、主页链接或包含链接的分享文案。"},"post_url":{"default":"","title":"Post Url","type":"string","description":"Instagram 帖子分享页链接；从搜索结果或详情结果的 share_url 原样复制，或传用户提供的 Instagram 帖子链接；不要传作者主页链接、评论链接或接口地址。"}},"title":"InternalInstagramPostDetailRequest","type":"object","description":"请求体至少传 post_id 或 post_url 其中一个；两个都传时优先使用 post_id。"},"example":{"post_id":"3889422887170484896","post_url":""}},"response":{"content_type":"application/json","schema":{"$defs":{"InstagramLocationData":{"properties":{"location_id":{"description":"Instagram 地点 ID；不可用时为空字符串。","title":"Location Id","type":"string"},"name":{"description":"地点名称；不可用时为空字符串。","title":"Name","type":"string"},"address":{"description":"地点地址；不可用时为空字符串。","title":"Address","type":"string"},"city":{"description":"地点城市；不可用时为空字符串。","title":"City","type":"string"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"地点纬度；不可用时为 null。","title":"Latitude"},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"地点经度；不可用时为 null。","title":"Longitude"}},"required":["location_id","name","address","city","latitude","longitude"],"title":"InstagramLocationData","type":"object"},"InstagramMediaItemData":{"properties":{"media_id":{"description":"媒体项 ID；不可用时为空字符串。","title":"Media Id","type":"string"},"media_type":{"description":"媒体项类型；photo 表示图片，video 表示视频。","enum":["photo","video"],"title":"Media Type","type":"string","x-socialdatax-enum-labels":{"photo":"图片","video":"视频"}},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"媒体项封面图链接；图片媒体为图片本身，视频媒体为视频封面；不可用时为 null。","title":"Cover Image Url"},"video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"视频播放资源链接；图片媒体或不可用时为 null。","title":"Video Url"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"媒体宽度，像素；不可用时为 null。","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"媒体高度，像素；不可用时为 null。","title":"Height"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频时长，单位毫秒；图片媒体或不可用时为 null。","title":"Duration Ms"},"alt_text":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"媒体替代文本说明；不可用时为 null。","title":"Alt Text"}},"required":["media_id","media_type","cover_image_url","video_url","width","height","duration_ms","alt_text"],"title":"InstagramMediaItemData","type":"object"},"InstagramMentionedUserData":{"properties":{"username":{"description":"文本中 @ 到的用户名，不带 @。","title":"Username","type":"string"}},"required":["username"],"title":"InstagramMentionedUserData","type":"object"},"InstagramMusicData":{"properties":{"music_id":{"description":"音乐 ID；不可用时为空字符串。","title":"Music Id","type":"string"},"title":{"description":"音乐标题；不可用时为空字符串。","title":"Title","type":"string"},"artist_name":{"description":"音乐艺术家名称；不可用时为空字符串。","title":"Artist Name","type":"string"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"音乐封面图链接；不可用时为 null。","title":"Cover Image Url"},"play_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"音乐播放资源链接；不可用时为 null。","title":"Play Url"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"音乐时长，单位毫秒；不可用时为 null。","title":"Duration Ms"}},"required":["music_id","title","artist_name","cover_image_url","play_url","duration_ms"],"title":"InstagramMusicData","type":"object"},"InstagramTopicTagData":{"properties":{"name":{"description":"话题标签名称，不带 #。","title":"Name","type":"string"}},"required":["name"],"title":"InstagramTopicTagData","type":"object"},"InstagramUserSummaryData":{"properties":{"user_id":{"description":"Instagram 用户稳定数字 ID；不可用时为空字符串。","title":"User Id","type":"string"},"username":{"description":"Instagram 用户名，不带 @；不可用时为空字符串。","title":"Username","type":"string"},"name":{"description":"用户展示名；不是 username；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户主页链接；通常可直接打开作者主页；不可用时为 null。","title":"Profile Url"},"is_verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"是否认证；不可用时为 null。","title":"Is Verified"}},"required":["user_id","username","name","avatar_url","profile_url","is_verified"],"title":"InstagramUserSummaryData","type":"object"}},"properties":{"post_id":{"description":"Instagram 帖子 ID。","title":"Post Id","type":"string"},"post_type":{"description":"帖子类型；photo 表示照片帖子，video 表示视频帖子，carousel 表示轮播帖子。","enum":["photo","video","carousel"],"title":"Post Type","type":"string","x-socialdatax-enum-labels":{"photo":"照片帖子","video":"视频帖子","carousel":"轮播帖子"}},"share_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Instagram 帖子分享页链接；不可用时为 null。","title":"Share Url"},"caption":{"description":"帖子配文；没有配文时为空字符串。","title":"Caption","type":"string"},"topic_tags":{"description":"帖子配文中的话题标签；无话题标签时为空数组；每项只返回 name，不带 #。","items":{"$ref":"#/$defs/InstagramTopicTagData"},"title":"Topic Tags","type":"array"},"mentioned_users":{"description":"帖子配文中 @ 到的用户名；无 @ 时为空数组；每项只返回 username，不带 @。","items":{"$ref":"#/$defs/InstagramMentionedUserData"},"title":"Mentioned Users","type":"array"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"帖子封面图链接；不可用时为 null。","title":"Cover Image Url"},"media_count":{"description":"帖子包含的媒体数量。","title":"Media Count","type":"integer"},"media_items":{"description":"帖子包含的图片/视频媒体列表；单图/单视频通常 1 项，轮播帖按顺序返回多项。","items":{"$ref":"#/$defs/InstagramMediaItemData"},"title":"Media Items","type":"array"},"music":{"anyOf":[{"$ref":"#/$defs/InstagramMusicData"},{"type":"null"}],"description":"帖子关联音乐/配乐信息；没有可返回的音乐信息时为 null。"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"点赞数；不可用时为 null。","title":"Like Count"},"comment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论数；不可用时为 null。","title":"Comment Count"},"play_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Instagram 播放/观看数；没有视频或不可用时为 null。","title":"Play Count"},"repost_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"转发/再分享数；不可用时为 null。","title":"Repost Count"},"comments_disabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"是否禁止发评论；true 表示已禁止，false 表示未禁止，null 表示不可用。","title":"Comments Disabled"},"like_and_view_counts_hidden":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"平台展示层是否隐藏点赞数或播放/观看数；true 表示已隐藏，false 表示未隐藏，null 表示不可用。","title":"Like And View Counts Hidden"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"location":{"anyOf":[{"$ref":"#/$defs/InstagramLocationData"},{"type":"null"}],"description":"帖子地理标记地点/POI，不是 IP 属地；没有地点时为 null。"},"tagged_users":{"description":"帖子图片或视频中标记的用户列表；无标记用户时为空数组。","items":{"$ref":"#/$defs/InstagramUserSummaryData"},"title":"Tagged Users","type":"array"},"collaborators":{"description":"帖子共同发布者/协作者列表；无共同发布者时为空数组。","items":{"$ref":"#/$defs/InstagramUserSummaryData"},"title":"Collaborators","type":"array"},"author":{"anyOf":[{"$ref":"#/$defs/InstagramUserSummaryData"},{"type":"null"}],"description":"帖子作者信息；不可用时为 null。"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["post_id","post_type","share_url","caption","topic_tags","mentioned_users","cover_image_url","media_count","media_items","music","like_count","comment_count","play_count","repost_count","comments_disabled","like_and_view_counts_hidden","publish_time","location","tagged_users","collaborators","author","points"],"title":"InstagramPostDetailData","type":"object"},"example":{"post_id":"3889422887170484896","post_type":"photo","share_url":"https://www.instagram.com/p/DX6AYJDEiqg/","caption":"🐻 #JJ #JUSTIN #JustinJay #takagijustinjay #smtr25","topic_tags":[{"name":"JJ"},{"name":"JUSTIN"},{"name":"JustinJay"},{"name":"takagijustinjay"},{"name":"smtr25"}],"mentioned_users":[],"cover_image_url":"https://example.invalid/instagram-cover.jpg","media_count":1,"media_items":[{"media_id":"3889422887170484896","media_type":"photo","cover_image_url":"https://example.invalid/instagram-cover.jpg","video_url":null,"width":1440,"height":1920,"duration_ms":null,"alt_text":"Photo by JUSTIN JAY 🐻 on May 03, 2026. May be an image of concert."}],"music":{"music_id":"301044350448495","title":"Beauty And A Beat (feat. Nicki Minaj)","artist_name":"Justin Bieber","cover_image_url":"https://example.invalid/music-cover.jpg","play_url":"https://example.invalid/music.mp3","duration_ms":227986},"like_count":13074,"comment_count":88,"play_count":null,"repost_count":1257,"comments_disabled":null,"like_and_view_counts_hidden":false,"publish_time":1777875402,"location":null,"tagged_users":[],"collaborators":[],"author":{"user_id":"55099911460","username":"takagi_justinjay","name":"JUSTIN JAY 🐻","avatar_url":"https://example.invalid/avatar-hd.jpg","profile_url":"https://www.instagram.com/takagi_justinjay/","is_verified":false},"points":{"cost":10,"balance":990}}},"related_mcp_tools":["instagram_get_post_detail_by_post_id","instagram_get_post_detail_by_post_url"]},{"operation_id":"instagram_get_post_comments","platform_id":"instagram","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/instagram/post/comment/list","summary":"获取 Instagram 帖子评论","description":"按帖子分享页链接分页获取公开 Instagram 帖子的一级评论。","tags":["帖子评论","Instagram"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"post_url":{"title":"Post Url","type":"string","description":"Instagram 帖子分享页链接；用户已提供时原样使用，否则可从搜索结果或详情结果的 share_url 原样复制；不要传 post_id、作者主页链接、评论链接、接口地址或包含链接的分享文案。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"Instagram 评论分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一帖子评论链路；更换帖子链接时，请清空 page_token 后从第一页重新读取评论。"}},"required":["post_url"],"title":"InternalInstagramPostCommentsRequest","type":"object"},"example":{"post_url":"https://www.instagram.com/p/DYIAtsTkavb/","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"InstagramCommentItemData":{"properties":{"post_id":{"description":"评论所属的 Instagram 帖子 ID；不可用时为空字符串。","title":"Post Id","type":"string"},"comment_id":{"description":"一级评论 ID；需要读取回复时，与同条评论的 post_id 一起用于获取该评论回复。","title":"Comment Id","type":"string"},"content":{"description":"评论正文；不可用时为空字符串。","title":"Content","type":"string"},"mentioned_users":{"description":"评论正文中 @ 到的用户名；无 @ 时为空数组；每项只返回 username，不带 @。","items":{"$ref":"#/$defs/InstagramMentionedUserData"},"title":"Mentioned Users","type":"array"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论点赞数；不可用时为 null。","title":"Like Count"},"reply_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"一级评论下的回复数；不可用时为 null。","title":"Reply Count"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"is_edited":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"评论是否编辑过；true 表示编辑过，false 表示未编辑，null 表示不可用。","title":"Is Edited"},"author":{"anyOf":[{"$ref":"#/$defs/InstagramUserSummaryData"},{"type":"null"}],"description":"评论作者信息；不可用时为 null。"}},"required":["post_id","comment_id","content","mentioned_users","like_count","reply_count","publish_time","is_edited","author"],"title":"InstagramCommentItemData","type":"object"},"InstagramMentionedUserData":{"properties":{"username":{"description":"文本中 @ 到的用户名，不带 @。","title":"Username","type":"string"}},"required":["username"],"title":"InstagramMentionedUserData","type":"object"},"InstagramUserSummaryData":{"properties":{"user_id":{"description":"Instagram 用户稳定数字 ID；不可用时为空字符串。","title":"User Id","type":"string"},"username":{"description":"Instagram 用户名，不带 @；不可用时为空字符串。","title":"Username","type":"string"},"name":{"description":"用户展示名；不是 username；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户主页链接；通常可直接打开作者主页；不可用时为 null。","title":"Profile Url"},"is_verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"是否认证；不可用时为 null。","title":"Is Verified"}},"required":["user_id","username","name","avatar_url","profile_url","is_verified"],"title":"InstagramUserSummaryData","type":"object"}},"properties":{"post_url":{"description":"可打开的 Instagram 帖子分享页链接；继续引用或展示帖子时优先使用。","title":"Post Url","type":"string"},"items":{"description":"当前页一级评论列表；当前页可能为空数组。","items":{"$ref":"#/$defs/InstagramCommentItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；只用于当前评论续页；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成。","title":"Next Page Token","type":"string"},"comment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该帖子评论总数；不是当前页评论条数，也不等于当前页 items 数量；不可用时为 null。","title":"Comment Count"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["post_url","items","next_page_token","comment_count","points"],"title":"InstagramPostCommentsResult","type":"object"},"example":{"post_url":"https://www.instagram.com/p/DYIAtsTkavb/","items":[{"post_id":"3893365017811200987","comment_id":"17879199738591511","content":"I love you ❤️ God Bless you","mentioned_users":[],"like_count":13,"reply_count":2,"publish_time":1778345509,"is_edited":false,"author":{"user_id":"8469201701","username":"nicoleduartemaquilladora","name":"Nicole Duarte","avatar_url":"https://example.invalid/avatar.jpg","profile_url":"https://www.instagram.com/nicoleduartemaquilladora/","is_verified":false}}],"next_page_token":"opaque-comment-page-token","comment_count":584,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["instagram_get_post_comments_by_post_url"]},{"operation_id":"instagram_get_post_comment_replies","platform_id":"instagram","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/instagram/post/comment/reply/list","summary":"获取 Instagram 评论回复","description":"按帖子 ID 和一级评论 ID 分页获取公开 Instagram 帖子的评论回复。","tags":["评论回复","Instagram"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"post_id":{"title":"Post Id","type":"string","description":"Instagram 帖子 ID（数字字符串）；用户已提供时原样使用，否则从一级评论结果 items[*].post_id 原样复制，也可使用同一帖子搜索、详情结果的 post_id；需与一级评论 comment_id 同时传入。"},"comment_id":{"title":"Comment Id","type":"string","description":"Instagram 一级评论 ID（数字字符串）；用户已提供时原样使用，否则从一级评论结果 items[*].comment_id 原样复制；不要传评论回复结果里的 items[*].comment_id。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"Instagram 评论回复分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一帖子和一级评论的回复链路；更换 post_id 或 comment_id 时，请清空 page_token 后从第一页重新读取评论回复。"}},"required":["post_id","comment_id"],"title":"InternalInstagramPostCommentRepliesRequest","type":"object"},"example":{"post_id":"3893365017811200987","comment_id":"17879199738591511","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"InstagramCommentReplyItemData":{"properties":{"comment_id":{"description":"评论回复自身 ID；不是一级评论 ID，不要作为读取回复的一级评论 ID 传入。","title":"Comment Id","type":"string"},"content":{"description":"评论回复正文；不可用时为空字符串。","title":"Content","type":"string"},"mentioned_users":{"description":"评论回复正文中 @ 到的用户名；无 @ 时为空数组；每项只返回 username，不带 @。","items":{"$ref":"#/$defs/InstagramMentionedUserData"},"title":"Mentioned Users","type":"array"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论回复点赞数；不可用时为 null。","title":"Like Count"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论回复发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"author":{"anyOf":[{"$ref":"#/$defs/InstagramUserSummaryData"},{"type":"null"}],"description":"评论回复作者信息；不可用时为 null。"}},"required":["comment_id","content","mentioned_users","like_count","publish_time","author"],"title":"InstagramCommentReplyItemData","type":"object"},"InstagramMentionedUserData":{"properties":{"username":{"description":"文本中 @ 到的用户名，不带 @。","title":"Username","type":"string"}},"required":["username"],"title":"InstagramMentionedUserData","type":"object"},"InstagramUserSummaryData":{"properties":{"user_id":{"description":"Instagram 用户稳定数字 ID；不可用时为空字符串。","title":"User Id","type":"string"},"username":{"description":"Instagram 用户名，不带 @；不可用时为空字符串。","title":"Username","type":"string"},"name":{"description":"用户展示名；不是 username；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户主页链接；通常可直接打开作者主页；不可用时为 null。","title":"Profile Url"},"is_verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"是否认证；不可用时为 null。","title":"Is Verified"}},"required":["user_id","username","name","avatar_url","profile_url","is_verified"],"title":"InstagramUserSummaryData","type":"object"}},"properties":{"items":{"description":"当前页评论回复列表；当前页可能为空数组。","items":{"$ref":"#/$defs/InstagramCommentReplyItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；只用于当前评论回复续页；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成。","title":"Next Page Token","type":"string"},"reply_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"当前接口返回的评论回复数量；不代表一级评论下展示的全部回复数；不可用时为 null。","title":"Reply Count"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","reply_count","points"],"title":"InstagramPostCommentRepliesResult","type":"object"},"example":{"items":[{"comment_id":"18200536849348656","content":"@nicoleduartehair Hello dear,for how long have you been my fan ❤️","mentioned_users":[{"username":"nicoleduartehair"}],"like_count":0,"publish_time":1779489890,"author":{"user_id":"39077006750","username":"justinbizzle.1256444","name":"","avatar_url":"https://example.invalid/avatar.jpg","profile_url":"https://www.instagram.com/justinbizzle.1256444/","is_verified":false}}],"next_page_token":"","reply_count":1,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["instagram_get_post_comment_replies_by_comment_id"]},{"operation_id":"instagram_get_user_info","platform_id":"instagram","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/instagram/user/info","summary":"获取 Instagram 用户信息","description":"按用户名或用户主页链接获取公开 Instagram 用户信息。","tags":["用户信息","Instagram"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"username":{"default":"","title":"Username","type":"string","description":"Instagram 用户名，不带 @；用户已提供时原样使用，否则可从搜索、详情、评论或评论回复结果的 author.username 原样复制；不要传用户主页链接、帖子链接、评论链接或分享文案。"},"profile_url":{"default":"","title":"Profile Url","type":"string","description":"Instagram 用户主页链接；从搜索、详情、评论或评论回复结果的 author.profile_url 原样复制；或传用户提供的 Instagram 用户主页链接；不要传帖子链接、评论链接、接口地址或包含链接的分享文案。"}},"title":"InternalInstagramUserInfoRequest","type":"object","description":"请求体必须且只能传 username 或 profile_url 其中一个。"},"example":{"username":"instagram"}},"response":{"content_type":"application/json","schema":{"$defs":{"InstagramExternalLinkData":{"properties":{"title":{"description":"主页外链标题；不可用时为空字符串。","title":"Title","type":"string"},"url":{"description":"主页外链 URL。","title":"Url","type":"string"}},"required":["title","url"],"title":"InstagramExternalLinkData","type":"object"}},"properties":{"user_id":{"description":"Instagram 用户稳定数字 ID；不可用时为空字符串。","title":"User Id","type":"string"},"username":{"description":"Instagram 用户名，不带 @；不可用时为空字符串。","title":"Username","type":"string"},"name":{"description":"用户展示名；不是 username；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"高清头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户主页链接；不可用时为 null。","title":"Profile Url"},"bio":{"description":"用户个人简介；没有简介时为空字符串。","title":"Bio","type":"string"},"external_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"主页外部链接中的主链接；没有外部链接时为 null。","title":"External Url"},"external_links":{"description":"主页外链列表，包含可用的多个主页外部链接；无外链时为空数组。","items":{"$ref":"#/$defs/InstagramExternalLinkData"},"title":"External Links","type":"array"},"is_verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"是否认证；不可用时为 null。","title":"Is Verified"},"is_private":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"是否私密账号；不可用时为 null。","title":"Is Private"},"follower_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"粉丝数；不可用时为 null。","title":"Follower Count"},"following_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"关注数；不可用时为 null。","title":"Following Count"},"post_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"已发布帖子数；不可用时为 null。","title":"Post Count"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["user_id","username","name","avatar_url","profile_url","bio","external_url","external_links","is_verified","is_private","follower_count","following_count","post_count","points"],"title":"InstagramUserInfoData","type":"object"},"example":{"user_id":"25025320","username":"instagram","name":"Instagram","avatar_url":"https://example.invalid/avatar-hd.jpg","profile_url":"https://www.instagram.com/instagram/","bio":"Discover what's new on Instagram.","external_url":"https://example.invalid/profile-link","external_links":[{"title":"Profile link","url":"https://example.invalid/profile-link"}],"is_verified":true,"is_private":false,"follower_count":685845022,"following_count":259,"post_count":8529,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["instagram_get_user_info_by_username","instagram_get_user_info_by_profile_url"]},{"operation_id":"instagram_get_user_posts","platform_id":"instagram","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/instagram/user/post/list","summary":"获取 Instagram 用户帖子列表","description":"按用户名或用户主页链接分页获取该用户发布的公开 Instagram 帖子列表。","tags":["用户帖子","Instagram"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"username":{"default":"","title":"Username","type":"string","description":"Instagram 用户名，不带 @；用户已提供时原样使用，否则可从用户信息结果的 username，或搜索、详情、评论、评论回复结果的 author.username 原样复制；不要传用户主页链接、帖子链接、评论链接或分享文案。"},"profile_url":{"default":"","title":"Profile Url","type":"string","description":"Instagram 用户主页链接；从用户信息结果的 profile_url，或搜索、详情、评论、评论回复结果的 author.profile_url 原样复制；也可传用户提供的 Instagram 用户主页链接；不要传帖子链接、评论链接、接口地址或包含链接的分享文案。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"Instagram 用户帖子列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一用户帖子列表链路；更换 username 或 profile_url 时，请清空 page_token 后从第一页重新读取。"}},"title":"InternalInstagramUserPostsRequest","type":"object","description":"请求体必须且只能传 username 或 profile_url 其中一个；page_token 首次请求留空。"},"example":{"username":"instagram","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"InstagramLocationData":{"properties":{"location_id":{"description":"Instagram 地点 ID；不可用时为空字符串。","title":"Location Id","type":"string"},"name":{"description":"地点名称；不可用时为空字符串。","title":"Name","type":"string"},"address":{"description":"地点地址；不可用时为空字符串。","title":"Address","type":"string"},"city":{"description":"地点城市；不可用时为空字符串。","title":"City","type":"string"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"地点纬度；不可用时为 null。","title":"Latitude"},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"地点经度；不可用时为 null。","title":"Longitude"}},"required":["location_id","name","address","city","latitude","longitude"],"title":"InstagramLocationData","type":"object"},"InstagramMediaItemData":{"properties":{"media_id":{"description":"媒体项 ID；不可用时为空字符串。","title":"Media Id","type":"string"},"media_type":{"description":"媒体项类型；photo 表示图片，video 表示视频。","enum":["photo","video"],"title":"Media Type","type":"string","x-socialdatax-enum-labels":{"photo":"图片","video":"视频"}},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"媒体项封面图链接；图片媒体为图片本身，视频媒体为视频封面；不可用时为 null。","title":"Cover Image Url"},"video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"视频播放资源链接；图片媒体或不可用时为 null。","title":"Video Url"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"媒体宽度，像素；不可用时为 null。","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"媒体高度，像素；不可用时为 null。","title":"Height"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频时长，单位毫秒；图片媒体或不可用时为 null。","title":"Duration Ms"},"alt_text":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"媒体替代文本说明；不可用时为 null。","title":"Alt Text"}},"required":["media_id","media_type","cover_image_url","video_url","width","height","duration_ms","alt_text"],"title":"InstagramMediaItemData","type":"object"},"InstagramMentionedUserData":{"properties":{"username":{"description":"文本中 @ 到的用户名，不带 @。","title":"Username","type":"string"}},"required":["username"],"title":"InstagramMentionedUserData","type":"object"},"InstagramMusicData":{"properties":{"music_id":{"description":"音乐 ID；不可用时为空字符串。","title":"Music Id","type":"string"},"title":{"description":"音乐标题；不可用时为空字符串。","title":"Title","type":"string"},"artist_name":{"description":"音乐艺术家名称；不可用时为空字符串。","title":"Artist Name","type":"string"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"音乐封面图链接；不可用时为 null。","title":"Cover Image Url"},"play_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"音乐播放资源链接；不可用时为 null。","title":"Play Url"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"音乐时长，单位毫秒；不可用时为 null。","title":"Duration Ms"}},"required":["music_id","title","artist_name","cover_image_url","play_url","duration_ms"],"title":"InstagramMusicData","type":"object"},"InstagramPostSearchItemData":{"properties":{"post_id":{"description":"Instagram 帖子 ID。","title":"Post Id","type":"string"},"post_type":{"description":"帖子类型；photo 表示照片帖子，video 表示视频帖子，carousel 表示轮播帖子。","enum":["photo","video","carousel"],"title":"Post Type","type":"string","x-socialdatax-enum-labels":{"photo":"照片帖子","video":"视频帖子","carousel":"轮播帖子"}},"share_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Instagram 帖子分享页链接；不可用时为 null。","title":"Share Url"},"caption":{"description":"帖子配文；没有配文时为空字符串。","title":"Caption","type":"string"},"topic_tags":{"description":"帖子配文中的话题标签；无话题标签时为空数组；每项只返回 name，不带 #。","items":{"$ref":"#/$defs/InstagramTopicTagData"},"title":"Topic Tags","type":"array"},"mentioned_users":{"description":"帖子配文中 @ 到的用户名；无 @ 时为空数组；每项只返回 username，不带 @。","items":{"$ref":"#/$defs/InstagramMentionedUserData"},"title":"Mentioned Users","type":"array"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"帖子封面图链接；不可用时为 null。","title":"Cover Image Url"},"media_count":{"description":"帖子包含的媒体数量。","title":"Media Count","type":"integer"},"media_items":{"description":"帖子包含的图片/视频媒体列表；单图/单视频通常 1 项，轮播帖按顺序返回多项。","items":{"$ref":"#/$defs/InstagramMediaItemData"},"title":"Media Items","type":"array"},"music":{"anyOf":[{"$ref":"#/$defs/InstagramMusicData"},{"type":"null"}],"description":"帖子关联音乐/配乐信息；没有可返回的音乐信息时为 null。"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"点赞数；不可用时为 null。","title":"Like Count"},"comment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论数；不可用时为 null。","title":"Comment Count"},"play_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Instagram 播放/观看数；没有视频或不可用时为 null。","title":"Play Count"},"repost_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"转发/再分享数；不可用时为 null。","title":"Repost Count"},"comments_disabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"是否禁止发评论；true 表示已禁止，false 表示未禁止，null 表示不可用。","title":"Comments Disabled"},"like_and_view_counts_hidden":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"平台展示层是否隐藏点赞数或播放/观看数；true 表示已隐藏，false 表示未隐藏，null 表示不可用。","title":"Like And View Counts Hidden"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"location":{"anyOf":[{"$ref":"#/$defs/InstagramLocationData"},{"type":"null"}],"description":"帖子地理标记地点/POI，不是 IP 属地；没有地点时为 null。"},"tagged_users":{"description":"帖子图片或视频中标记的用户列表；无标记用户时为空数组。","items":{"$ref":"#/$defs/InstagramUserSummaryData"},"title":"Tagged Users","type":"array"},"collaborators":{"description":"帖子共同发布者/协作者列表；无共同发布者时为空数组。","items":{"$ref":"#/$defs/InstagramUserSummaryData"},"title":"Collaborators","type":"array"},"author":{"anyOf":[{"$ref":"#/$defs/InstagramUserSummaryData"},{"type":"null"}],"description":"帖子作者信息；不可用时为 null。"}},"required":["post_id","post_type","share_url","caption","topic_tags","mentioned_users","cover_image_url","media_count","media_items","music","like_count","comment_count","play_count","repost_count","comments_disabled","like_and_view_counts_hidden","publish_time","location","tagged_users","collaborators","author"],"title":"InstagramPostSearchItemData","type":"object"},"InstagramTopicTagData":{"properties":{"name":{"description":"话题标签名称，不带 #。","title":"Name","type":"string"}},"required":["name"],"title":"InstagramTopicTagData","type":"object"},"InstagramUserSummaryData":{"properties":{"user_id":{"description":"Instagram 用户稳定数字 ID；不可用时为空字符串。","title":"User Id","type":"string"},"username":{"description":"Instagram 用户名，不带 @；不可用时为空字符串。","title":"Username","type":"string"},"name":{"description":"用户展示名；不是 username；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户主页链接；通常可直接打开作者主页；不可用时为 null。","title":"Profile Url"},"is_verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"是否认证；不可用时为 null。","title":"Is Verified"}},"required":["user_id","username","name","avatar_url","profile_url","is_verified"],"title":"InstagramUserSummaryData","type":"object"}},"properties":{"items":{"description":"当前页该用户发布的 Instagram 帖子列表；当前页可能为空，是否可继续翻页以 next_page_token 是否为空为准。","items":{"$ref":"#/$defs/InstagramPostSearchItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；只用于当前用户帖子列表续页；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"InstagramUserPostsResult","type":"object"},"example":{"items":[{"post_id":"3946339291940673822","post_type":"video","share_url":"https://www.instagram.com/reel/DbENq1rSlke/","caption":"Discover what's new on Instagram.","topic_tags":[],"mentioned_users":[],"cover_image_url":"https://example.invalid/instagram-video-cover.jpg","media_count":1,"media_items":[{"media_id":"3946339291940673822","media_type":"video","cover_image_url":"https://example.invalid/instagram-video-cover.jpg","video_url":"https://example.invalid/instagram-video.mp4","width":1080,"height":1920,"duration_ms":15880,"alt_text":null}],"music":null,"like_count":83589,"comment_count":4627,"play_count":40849075,"repost_count":2806,"comments_disabled":null,"like_and_view_counts_hidden":false,"publish_time":1784660391,"location":null,"tagged_users":[],"collaborators":[],"author":{"user_id":"25025320","username":"instagram","name":"Instagram","avatar_url":"https://example.invalid/avatar.jpg","profile_url":"https://www.instagram.com/instagram/","is_verified":true}}],"next_page_token":"opaque-user-posts-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["instagram_get_user_posts_by_username","instagram_get_user_posts_by_profile_url"]}]},{"surface":"mcp","status":"available","endpoint":"https://mcp.socialdatax.com/instagram/mcp","authentication":{"required":true},"capabilities_resource":"instagram://guides/tool-capabilities","related_http_operation_ids":["instagram_search_posts","instagram_get_post_detail","instagram_get_post_comments","instagram_get_post_comment_replies","instagram_get_user_info","instagram_get_user_posts"]}]},{"platform_id":"x","label":"X","english_label":"Twitter","status":"available","surfaces":[{"surface":"http","status":"available","base_path":"/socialdatax/api/v1/x","description":"公开 X HTTP API 提供帖子搜索、帖子详情、帖子评论列表、评论回复、用户信息和用户帖子列表接口；搜索支持热门和最新排序且仅返回帖子结果；帖子详情和评论列表接口支持 post_id 或 post_url 入口，已知 post_id 时优先传 post_id。","operations":[{"operation_id":"x_search_posts","platform_id":"x","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/x/post/search","summary":"搜索 X 帖子","description":"按 keyword 搜索公开 X/Twitter 帖子；sort_type 可传 hot=热门，或 time_descending=最新；需要 latest/newest sorting 时也传 time_descending；继续翻页传 page_token，响应返回 next_page_token；只返回帖子结果和结构化帖子信息。","tags":["帖子搜索","推特","X"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"keyword":{"title":"Keyword","type":"string","description":"X / Twitter 帖子搜索词，可传关键词或短语，例如品牌名、话题、人物名或内容需求；不要传帖子链接、用户主页链接、接口地址、post_id、user_id、username 或 page_token。"},"sort_type":{"default":"hot","enum":["hot","time_descending"],"title":"Sort Type","type":"string","description":"搜索排序：hot=热门，time_descending=最新；需要 latest/newest sorting 时也传 time_descending。如无明确排序需求，保持 hot。","x-socialdatax-enum-labels":{"hot":"热门","time_descending":"最新"}},"page_token":{"default":"","title":"Page Token","type":"string","description":"X 搜索分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一关键词和同一搜索排序链路；更换关键词或 sort_type 时，请清空 page_token 后从第一页重新搜索。"}},"required":["keyword"],"title":"XPostSearchRequest","type":"object"},"example":{"keyword":"camping","sort_type":"hot","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"XExternalLinkData":{"properties":{"target_url":{"description":"正文链接展开后的目标链接；可能是外部网站或 X 内部链接；不可用时为空字符串。","title":"Target Url","type":"string"},"short_url":{"description":"X 正文中的 t.co 短链接；不可用时为空字符串。","title":"Short Url","type":"string"}},"required":["target_url","short_url"],"title":"XExternalLinkData","type":"object"},"XMediaItemData":{"properties":{"media_id":{"description":"媒体项 ID；不可用时为空字符串。","title":"Media Id","type":"string"},"media_type":{"description":"媒体项类型；photo 表示图片，video 表示视频。","enum":["photo","video"],"title":"Media Type","type":"string","x-socialdatax-enum-labels":{"photo":"图片","video":"视频"}},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"媒体项封面图链接；图片媒体为图片本身，视频媒体为视频封面；不可用时为 null。","title":"Cover Image Url"},"video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"视频播放资源链接；图片媒体或不可用时为 null。","title":"Video Url"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"媒体宽度，像素；视频实际清晰度以 video_url 资源为准；不可用时为 null。","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"媒体高度，像素；视频实际清晰度以 video_url 资源为准；不可用时为 null。","title":"Height"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频时长，单位毫秒；图片媒体或不可用时为 null。","title":"Duration Ms"}},"required":["media_id","media_type","cover_image_url","video_url","width","height","duration_ms"],"title":"XMediaItemData","type":"object"},"XMentionedUserData":{"properties":{"user_id":{"description":"被 @ 用户 ID；不可用时为空字符串。","title":"User Id","type":"string"},"username":{"description":"被 @ 用户名，不带 @；不可用时为空字符串。","title":"Username","type":"string"},"name":{"description":"被 @ 用户展示名；不可用时为空字符串。","title":"Name","type":"string"}},"required":["user_id","username","name"],"title":"XMentionedUserData","type":"object"},"XPostSearchItemData":{"properties":{"post_id":{"description":"X 帖子数字 ID；帖子详情或评论列表查询优先使用该字段；请按字符串原样保留。","title":"Post Id","type":"string"},"post_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"X 帖子详情页链接；主要用于展示；详情或评论列表查询优先使用 post_id，只有没有 post_id 时再作为 URL 入口；不是帖子正文里的链接；不可用时为 null。","title":"Post Url"},"post_type":{"description":"帖子类型；text=未返回图片/视频媒体的文字帖，photo=图片帖，video=包含视频的帖子。","enum":["text","photo","video"],"title":"Post Type","type":"string","x-socialdatax-enum-labels":{"text":"文字帖","photo":"图片帖","video":"视频帖"}},"text":{"description":"帖子正文文本；不可用时为空字符串。","title":"Text","type":"string"},"lang":{"description":"帖子语言代码；不可用时为空字符串。","title":"Lang","type":"string"},"topic_tags":{"description":"帖子中的话题标签；无话题标签或不可用时为空数组；每项只返回 name，不带 #。","items":{"$ref":"#/$defs/XTopicTagData"},"title":"Topic Tags","type":"array"},"mentioned_users":{"description":"帖子中 @ 到的用户；无 @ 或不可用时为空数组。","items":{"$ref":"#/$defs/XMentionedUserData"},"title":"Mentioned Users","type":"array"},"external_links":{"description":"帖子正文中的链接列表；可能包含外部网站或 X 内部链接；无链接或不可用时为空数组。","items":{"$ref":"#/$defs/XExternalLinkData"},"title":"External Links","type":"array"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"帖子首个可用媒体封面图链接；无媒体或不可用时为 null。","title":"Cover Image Url"},"media_count":{"description":"帖子包含的媒体数量；等于返回的 media_items 数量。","title":"Media Count","type":"integer"},"media_items":{"description":"帖子包含的图片/视频媒体列表；无媒体或不可用时为空数组。","items":{"$ref":"#/$defs/XMediaItemData"},"title":"Media Items","type":"array"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该帖累计点赞数；不可用时为 null。","title":"Like Count"},"reply_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该帖累计回复/评论统计；不是评论列表当前页 items 数量；不可用时为 null。","title":"Reply Count"},"repost_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该帖累计转帖数；不可用时为 null。","title":"Repost Count"},"quote_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该帖被引用次数；不是 quoted_post 对象数量；不可用时为 null。","title":"Quote Count"},"bookmark_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该帖累计书签数；不可用时为 null。","title":"Bookmark Count"},"view_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该帖累计浏览/观看数；不可用时为 null。","title":"View Count"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"conversation_id":{"description":"会话/讨论串归组 ID；不是评论 ID；不可用时为空字符串。","title":"Conversation Id","type":"string"},"reply_to_post_id":{"description":"该帖回复的上级帖子 ID；不是评论 ID；没有或不可用时为空字符串。","title":"Reply To Post Id","type":"string"},"quoted_post":{"anyOf":[{"$ref":"#/$defs/XQuotedPostData"},{"type":"null"}],"description":"被引用的帖子摘要；不是完整帖子详情结构；没有引用帖或不可用时为 null。"},"reposted_post":{"anyOf":[{"$ref":"#/$defs/XRepostedPostData"},{"type":"null"}],"description":"被转帖的原帖摘要；不是引用帖，也不是完整帖子详情结构；没有转帖原帖或不可用时为 null。"},"author":{"anyOf":[{"$ref":"#/$defs/XUserSummaryData"},{"type":"null"}],"description":"帖子作者信息；不可用时为 null。"}},"required":["post_id","post_url","post_type","text","lang","topic_tags","mentioned_users","external_links","cover_image_url","media_count","media_items","like_count","reply_count","repost_count","quote_count","bookmark_count","view_count","publish_time","conversation_id","reply_to_post_id","quoted_post","reposted_post","author"],"title":"XPostSearchItemData","type":"object"},"XQuotedPostData":{"properties":{"post_id":{"description":"被引用的 X 帖子数字 ID；quoted_post 不为 null 时，引用帖详情或评论列表查询优先使用该字段；请按字符串原样保留。","title":"Post Id","type":"string"},"post_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"被引用帖子详情页链接；主要用于展示；引用帖详情或评论列表查询优先使用 quoted_post.post_id，只有没有被引用帖 post_id 时再作为 URL 入口；不是正文里的链接；不可用时为 null。","title":"Post Url"},"text":{"description":"被引用帖子正文文本；不可用时为空字符串。","title":"Text","type":"string"},"media_items":{"description":"被引用帖子携带的图片/视频媒体列表；无媒体或不可用时为空数组。","items":{"$ref":"#/$defs/XMediaItemData"},"title":"Media Items","type":"array"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被引用帖子自身的累计点赞数；不可用时为 null。","title":"Like Count"},"reply_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被引用帖子自身的累计回复/评论统计；不是评论列表当前页 items 数量；不可用时为 null。","title":"Reply Count"},"repost_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被引用帖子自身的累计转帖数；不可用时为 null。","title":"Repost Count"},"quote_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被引用帖子自身被引用次数；不是 quoted_post 对象数量；不可用时为 null。","title":"Quote Count"},"bookmark_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被引用帖子自身的累计书签数；不可用时为 null。","title":"Bookmark Count"},"view_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被引用帖子自身的累计浏览/观看数；不可用时为 null。","title":"View Count"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被引用帖子发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"author":{"anyOf":[{"$ref":"#/$defs/XUserSummaryData"},{"type":"null"}],"description":"被引用帖子作者信息；不可用时为 null。"}},"required":["post_id","post_url","text","media_items","like_count","reply_count","repost_count","quote_count","bookmark_count","view_count","publish_time","author"],"title":"XQuotedPostData","type":"object"},"XRepostedPostData":{"properties":{"post_id":{"description":"被转帖的原帖数字 ID；reposted_post 不为 null 时，原帖详情或评论列表查询优先使用该字段；请按字符串原样保留。","title":"Post Id","type":"string"},"post_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"被转帖原帖详情页链接；主要用于展示；原帖详情或评论列表查询优先使用 reposted_post.post_id，只有没有原帖 post_id 时再作为 URL 入口；不是正文里的链接；不可用时为 null。","title":"Post Url"},"text":{"description":"被转帖原帖正文文本；不可用时为空字符串。","title":"Text","type":"string"},"media_items":{"description":"被转帖原帖携带的图片/视频媒体列表；无媒体或不可用时为空数组。","items":{"$ref":"#/$defs/XMediaItemData"},"title":"Media Items","type":"array"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被转帖原帖自身的累计点赞数；不可用时为 null。","title":"Like Count"},"reply_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被转帖原帖自身的累计回复/评论统计；不是评论列表当前页 items 数量；不可用时为 null。","title":"Reply Count"},"repost_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被转帖原帖自身的累计转帖数；不可用时为 null。","title":"Repost Count"},"quote_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被转帖原帖自身被引用次数；不是 reposted_post 对象数量；不可用时为 null。","title":"Quote Count"},"bookmark_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被转帖原帖自身的累计书签数；不可用时为 null。","title":"Bookmark Count"},"view_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被转帖原帖自身的累计浏览/观看数；不可用时为 null。","title":"View Count"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被转帖原帖发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"author":{"anyOf":[{"$ref":"#/$defs/XUserSummaryData"},{"type":"null"}],"description":"被转帖原帖作者信息；不可用时为 null。"}},"required":["post_id","post_url","text","media_items","like_count","reply_count","repost_count","quote_count","bookmark_count","view_count","publish_time","author"],"title":"XRepostedPostData","type":"object"},"XTopicTagData":{"properties":{"name":{"description":"话题标签名称，不带 #。","title":"Name","type":"string"}},"required":["name"],"title":"XTopicTagData","type":"object"},"XUserSummaryData":{"properties":{"user_id":{"description":"X 用户稳定数字 ID；不可用时为空字符串。","title":"User Id","type":"string"},"username":{"description":"X 用户名，不带 @；不可用时为空字符串。","title":"Username","type":"string"},"name":{"description":"用户展示名；不是 username；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户主页链接；不可用时为 null。","title":"Profile Url"},"bio":{"description":"用户个人简介；没有或不可用时为空字符串。","title":"Bio","type":"string"},"is_verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"是否显示 X 认证标识；不可用时为 null。","title":"Is Verified"},"verified_type":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"认证类型补充信息；可能在 is_verified 为 false 时仍有值；没有或不可用时为 null。","title":"Verified Type"},"follower_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"粉丝数；不可用时为 null。","title":"Follower Count"},"following_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"关注数；不可用时为 null。","title":"Following Count"},"location":{"description":"用户主页资料里填写的所在地；不是 IP 属地；不可用时为空字符串。","title":"Location","type":"string"},"external_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户主页填写的网站或外部链接；不是帖子链接；标准用户主页请使用 author.profile_url；不可用时为 null。","title":"External Url"}},"required":["user_id","username","name","avatar_url","profile_url","bio","is_verified","verified_type","follower_count","following_count","location","external_url"],"title":"XUserSummaryData","type":"object"}},"properties":{"items":{"description":"当前页 X 搜索结果列表；已过滤掉用户、媒体页、列表等非帖子结果；当前页可能为空，是否可继续翻页以 next_page_token 是否为空为准。","items":{"$ref":"#/$defs/XPostSearchItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；只用于当前搜索续页；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"XPostSearchResult","type":"object"},"example":{"items":[{"post_id":"2079899183247487332","post_url":"https://x.com/camping_guide/status/2079899183247487332","post_type":"photo","text":"Weekend camping checklist for beginners.","lang":"en","topic_tags":[],"mentioned_users":[],"external_links":[],"cover_image_url":"https://example.invalid/x-cover.jpg","media_count":1,"media_items":[{"media_id":"2079899176381349888","media_type":"photo","cover_image_url":"https://example.invalid/x-cover.jpg","video_url":null,"width":683,"height":400,"duration_ms":null}],"like_count":154,"reply_count":23,"repost_count":23,"quote_count":4,"bookmark_count":32,"view_count":32745,"publish_time":1784721582,"conversation_id":"2079899183247487332","reply_to_post_id":"","quoted_post":null,"reposted_post":null,"author":{"user_id":"1891490382","username":"camping_guide","name":"Camping Guide","avatar_url":"https://example.invalid/avatar.jpg","profile_url":"https://x.com/camping_guide","bio":"Camping checklists, campsite ideas and outdoor weekend tips.","is_verified":true,"verified_type":null,"follower_count":1322594,"following_count":231,"location":"Pacific Northwest","external_url":"https://example.invalid/camping-guide"}}],"next_page_token":"opaque-search-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["x_search_posts"]},{"operation_id":"x_get_post_detail","platform_id":"x","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/x/post/detail","summary":"获取 X 帖子详情","description":"根据 X/Twitter 帖子 ID 或帖子链接获取公开帖子详情；已知 post_id 时优先传 post_id，只有帖子链接时再传 post_url。返回正文、媒体、互动数、作者、quoted_post 引用帖摘要和 reposted_post 转帖原帖摘要等结构化信息。","tags":["帖子详情","推特","X"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"post_id":{"default":"","title":"Post Id","type":"string","description":"X 帖子 ID；用户已提供时原样使用，否则可从搜索结果、详情结果、quoted_post、reposted_post 或用户帖子列表结果复制 post_id；必须是数字字符串；不要传帖子链接、用户名或分享文案。"},"post_url":{"default":"","title":"Post Url","type":"string","description":"X 帖子链接；仅在没有 post_id 时，请传搜索结果、详情结果、quoted_post 或 reposted_post 返回的非空 post_url，或用户帖子列表结果返回的非空 post_url，或形如 https://x.com/{username}/status/{post_id} 的 x.com 或 twitter.com 帖子页面链接；不要传用户主页链接、帖子正文里的链接、搜索关键词或接口地址。"}},"title":"XPostDetailRequest","type":"object","description":"至少传 post_id 或 post_url 其中一个；两个都传时优先使用 post_id。"},"example":{"post_id":"2079951458137763840"}},"response":{"content_type":"application/json","schema":{"$defs":{"XExternalLinkData":{"properties":{"target_url":{"description":"正文链接展开后的目标链接；可能是外部网站或 X 内部链接；不可用时为空字符串。","title":"Target Url","type":"string"},"short_url":{"description":"X 正文中的 t.co 短链接；不可用时为空字符串。","title":"Short Url","type":"string"}},"required":["target_url","short_url"],"title":"XExternalLinkData","type":"object"},"XMediaItemData":{"properties":{"media_id":{"description":"媒体项 ID；不可用时为空字符串。","title":"Media Id","type":"string"},"media_type":{"description":"媒体项类型；photo 表示图片，video 表示视频。","enum":["photo","video"],"title":"Media Type","type":"string","x-socialdatax-enum-labels":{"photo":"图片","video":"视频"}},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"媒体项封面图链接；图片媒体为图片本身，视频媒体为视频封面；不可用时为 null。","title":"Cover Image Url"},"video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"视频播放资源链接；图片媒体或不可用时为 null。","title":"Video Url"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"媒体宽度，像素；视频实际清晰度以 video_url 资源为准；不可用时为 null。","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"媒体高度，像素；视频实际清晰度以 video_url 资源为准；不可用时为 null。","title":"Height"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频时长，单位毫秒；图片媒体或不可用时为 null。","title":"Duration Ms"}},"required":["media_id","media_type","cover_image_url","video_url","width","height","duration_ms"],"title":"XMediaItemData","type":"object"},"XMentionedUserData":{"properties":{"user_id":{"description":"被 @ 用户 ID；不可用时为空字符串。","title":"User Id","type":"string"},"username":{"description":"被 @ 用户名，不带 @；不可用时为空字符串。","title":"Username","type":"string"},"name":{"description":"被 @ 用户展示名；不可用时为空字符串。","title":"Name","type":"string"}},"required":["user_id","username","name"],"title":"XMentionedUserData","type":"object"},"XQuotedPostData":{"properties":{"post_id":{"description":"被引用的 X 帖子数字 ID；quoted_post 不为 null 时，引用帖详情或评论列表查询优先使用该字段；请按字符串原样保留。","title":"Post Id","type":"string"},"post_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"被引用帖子详情页链接；主要用于展示；引用帖详情或评论列表查询优先使用 quoted_post.post_id，只有没有被引用帖 post_id 时再作为 URL 入口；不是正文里的链接；不可用时为 null。","title":"Post Url"},"text":{"description":"被引用帖子正文文本；不可用时为空字符串。","title":"Text","type":"string"},"media_items":{"description":"被引用帖子携带的图片/视频媒体列表；无媒体或不可用时为空数组。","items":{"$ref":"#/$defs/XMediaItemData"},"title":"Media Items","type":"array"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被引用帖子自身的累计点赞数；不可用时为 null。","title":"Like Count"},"reply_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被引用帖子自身的累计回复/评论统计；不是评论列表当前页 items 数量；不可用时为 null。","title":"Reply Count"},"repost_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被引用帖子自身的累计转帖数；不可用时为 null。","title":"Repost Count"},"quote_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被引用帖子自身被引用次数；不是 quoted_post 对象数量；不可用时为 null。","title":"Quote Count"},"bookmark_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被引用帖子自身的累计书签数；不可用时为 null。","title":"Bookmark Count"},"view_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被引用帖子自身的累计浏览/观看数；不可用时为 null。","title":"View Count"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被引用帖子发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"author":{"anyOf":[{"$ref":"#/$defs/XUserSummaryData"},{"type":"null"}],"description":"被引用帖子作者信息；不可用时为 null。"}},"required":["post_id","post_url","text","media_items","like_count","reply_count","repost_count","quote_count","bookmark_count","view_count","publish_time","author"],"title":"XQuotedPostData","type":"object"},"XRepostedPostData":{"properties":{"post_id":{"description":"被转帖的原帖数字 ID；reposted_post 不为 null 时，原帖详情或评论列表查询优先使用该字段；请按字符串原样保留。","title":"Post Id","type":"string"},"post_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"被转帖原帖详情页链接；主要用于展示；原帖详情或评论列表查询优先使用 reposted_post.post_id，只有没有原帖 post_id 时再作为 URL 入口；不是正文里的链接；不可用时为 null。","title":"Post Url"},"text":{"description":"被转帖原帖正文文本；不可用时为空字符串。","title":"Text","type":"string"},"media_items":{"description":"被转帖原帖携带的图片/视频媒体列表；无媒体或不可用时为空数组。","items":{"$ref":"#/$defs/XMediaItemData"},"title":"Media Items","type":"array"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被转帖原帖自身的累计点赞数；不可用时为 null。","title":"Like Count"},"reply_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被转帖原帖自身的累计回复/评论统计；不是评论列表当前页 items 数量；不可用时为 null。","title":"Reply Count"},"repost_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被转帖原帖自身的累计转帖数；不可用时为 null。","title":"Repost Count"},"quote_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被转帖原帖自身被引用次数；不是 reposted_post 对象数量；不可用时为 null。","title":"Quote Count"},"bookmark_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被转帖原帖自身的累计书签数；不可用时为 null。","title":"Bookmark Count"},"view_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被转帖原帖自身的累计浏览/观看数；不可用时为 null。","title":"View Count"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被转帖原帖发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"author":{"anyOf":[{"$ref":"#/$defs/XUserSummaryData"},{"type":"null"}],"description":"被转帖原帖作者信息；不可用时为 null。"}},"required":["post_id","post_url","text","media_items","like_count","reply_count","repost_count","quote_count","bookmark_count","view_count","publish_time","author"],"title":"XRepostedPostData","type":"object"},"XTopicTagData":{"properties":{"name":{"description":"话题标签名称，不带 #。","title":"Name","type":"string"}},"required":["name"],"title":"XTopicTagData","type":"object"},"XUserSummaryData":{"properties":{"user_id":{"description":"X 用户稳定数字 ID；不可用时为空字符串。","title":"User Id","type":"string"},"username":{"description":"X 用户名，不带 @；不可用时为空字符串。","title":"Username","type":"string"},"name":{"description":"用户展示名；不是 username；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户主页链接；不可用时为 null。","title":"Profile Url"},"bio":{"description":"用户个人简介；没有或不可用时为空字符串。","title":"Bio","type":"string"},"is_verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"是否显示 X 认证标识；不可用时为 null。","title":"Is Verified"},"verified_type":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"认证类型补充信息；可能在 is_verified 为 false 时仍有值；没有或不可用时为 null。","title":"Verified Type"},"follower_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"粉丝数；不可用时为 null。","title":"Follower Count"},"following_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"关注数；不可用时为 null。","title":"Following Count"},"location":{"description":"用户主页资料里填写的所在地；不是 IP 属地；不可用时为空字符串。","title":"Location","type":"string"},"external_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户主页填写的网站或外部链接；不是帖子链接；标准用户主页请使用 author.profile_url；不可用时为 null。","title":"External Url"}},"required":["user_id","username","name","avatar_url","profile_url","bio","is_verified","verified_type","follower_count","following_count","location","external_url"],"title":"XUserSummaryData","type":"object"}},"properties":{"post_id":{"description":"X 帖子数字 ID；帖子详情或评论列表查询优先使用该字段；请按字符串原样保留。","title":"Post Id","type":"string"},"post_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"X 帖子详情页链接；主要用于展示；详情或评论列表查询优先使用 post_id，只有没有 post_id 时再作为 URL 入口；不是帖子正文里的链接；不可用时为 null。","title":"Post Url"},"post_type":{"description":"帖子类型；text=未返回图片/视频媒体的文字帖，photo=图片帖，video=包含视频的帖子。","enum":["text","photo","video"],"title":"Post Type","type":"string","x-socialdatax-enum-labels":{"text":"文字帖","photo":"图片帖","video":"视频帖"}},"text":{"description":"帖子正文文本；不可用时为空字符串。","title":"Text","type":"string"},"lang":{"description":"帖子语言代码；不可用时为空字符串。","title":"Lang","type":"string"},"topic_tags":{"description":"帖子中的话题标签；无话题标签或不可用时为空数组；每项只返回 name，不带 #。","items":{"$ref":"#/$defs/XTopicTagData"},"title":"Topic Tags","type":"array"},"mentioned_users":{"description":"帖子中 @ 到的用户；无 @ 或不可用时为空数组。","items":{"$ref":"#/$defs/XMentionedUserData"},"title":"Mentioned Users","type":"array"},"external_links":{"description":"帖子正文中的链接列表；可能包含外部网站或 X 内部链接；无链接或不可用时为空数组。","items":{"$ref":"#/$defs/XExternalLinkData"},"title":"External Links","type":"array"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"帖子首个可用媒体封面图链接；无媒体或不可用时为 null。","title":"Cover Image Url"},"media_count":{"description":"帖子包含的媒体数量；等于返回的 media_items 数量。","title":"Media Count","type":"integer"},"media_items":{"description":"帖子包含的图片/视频媒体列表；无媒体或不可用时为空数组。","items":{"$ref":"#/$defs/XMediaItemData"},"title":"Media Items","type":"array"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该帖累计点赞数；不可用时为 null。","title":"Like Count"},"reply_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该帖累计回复/评论统计；不是评论列表当前页 items 数量；不可用时为 null。","title":"Reply Count"},"repost_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该帖累计转帖数；不可用时为 null。","title":"Repost Count"},"quote_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该帖被引用次数；不是 quoted_post 对象数量；不可用时为 null。","title":"Quote Count"},"bookmark_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该帖累计书签数；不可用时为 null。","title":"Bookmark Count"},"view_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该帖累计浏览/观看数；不可用时为 null。","title":"View Count"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"conversation_id":{"description":"会话/讨论串归组 ID；不是评论 ID；不可用时为空字符串。","title":"Conversation Id","type":"string"},"reply_to_post_id":{"description":"该帖回复的上级帖子 ID；不是评论 ID；没有或不可用时为空字符串。","title":"Reply To Post Id","type":"string"},"quoted_post":{"anyOf":[{"$ref":"#/$defs/XQuotedPostData"},{"type":"null"}],"description":"被引用的帖子摘要；不是完整帖子详情结构；没有引用帖或不可用时为 null。"},"reposted_post":{"anyOf":[{"$ref":"#/$defs/XRepostedPostData"},{"type":"null"}],"description":"被转帖的原帖摘要；不是引用帖，也不是完整帖子详情结构；没有转帖原帖或不可用时为 null。"},"author":{"anyOf":[{"$ref":"#/$defs/XUserSummaryData"},{"type":"null"}],"description":"帖子作者信息；不可用时为 null。"},"is_sensitive":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"是否带有平台敏感内容标记；不可用时为 null。","title":"Is Sensitive"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["post_id","post_url","post_type","text","lang","topic_tags","mentioned_users","external_links","cover_image_url","media_count","media_items","like_count","reply_count","repost_count","quote_count","bookmark_count","view_count","publish_time","conversation_id","reply_to_post_id","quoted_post","reposted_post","author","is_sensitive","points"],"title":"XPostDetailData","type":"object"},"example":{"post_id":"2079951458137763840","post_url":"https://x.com/alex_prompter/status/2079951458137763840","post_type":"video","text":"Full post text from X.","lang":"en","topic_tags":[],"mentioned_users":[],"external_links":[],"cover_image_url":"https://example.invalid/x-video-cover.jpg","media_count":1,"media_items":[{"media_id":"2079951431805829120","media_type":"video","cover_image_url":"https://example.invalid/x-video-cover.jpg","video_url":"https://example.invalid/x-video.mp4","width":1280,"height":720,"duration_ms":14280}],"like_count":70302,"reply_count":2943,"repost_count":12780,"quote_count":2245,"bookmark_count":18090,"view_count":5922104,"publish_time":1784734045,"conversation_id":"2079951458137763840","reply_to_post_id":"","quoted_post":{"post_id":"2079658951264920020","post_url":"https://x.com/OpenAI/status/2079658951264920020","text":"Quoted post text.","media_items":[],"like_count":19832,"reply_count":1849,"repost_count":3078,"quote_count":3704,"bookmark_count":7264,"view_count":28427739,"publish_time":1784664306,"author":{"user_id":"4398626122","username":"OpenAI","name":"OpenAI","avatar_url":"https://example.invalid/openai-avatar.jpg","profile_url":"https://x.com/OpenAI","bio":"","is_verified":true,"verified_type":null,"follower_count":null,"following_count":null,"location":"","external_url":null}},"reposted_post":null,"author":{"user_id":"1643695629665722379","username":"alex_prompter","name":"Alex Prompter","avatar_url":"https://example.invalid/avatar.jpg","profile_url":"https://x.com/alex_prompter","bio":"","is_verified":true,"verified_type":null,"follower_count":278971,"following_count":null,"location":"","external_url":null},"is_sensitive":false,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["x_get_post_detail_by_post_id","x_get_post_detail_by_post_url"]},{"operation_id":"x_get_post_comments","platform_id":"x","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/x/post/comment/list","summary":"获取 X 帖子评论列表","description":"根据 X/Twitter 帖子 ID 或帖子链接获取公开帖子的一级评论列表，不内嵌评论回复；已知 post_id 时优先传 post_id，只有帖子链接时再传 post_url。搜索或详情结果里的 quoted_post 或 reposted_post 需要获取一级评论列表时，同样优先传对应对象里的 post_id。需要评论回复时，使用评论项里的 post_id 和 comment_id 调评论回复接口。继续翻页传 page_token，响应返回 next_page_token。","tags":["帖子评论列表","推特","X"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"post_id":{"default":"","title":"Post Id","type":"string","description":"X 帖子 ID；用户已提供时原样使用，否则可从搜索结果、详情结果、quoted_post、reposted_post 或用户帖子列表结果复制 post_id；必须是数字字符串；不要传帖子链接、用户名、评论 ID 或分享文案。"},"post_url":{"default":"","title":"Post Url","type":"string","description":"X 帖子链接；仅在没有 post_id 时，请传搜索结果、详情结果、quoted_post 或 reposted_post 返回的非空 post_url，或用户帖子列表结果返回的非空 post_url，或形如 https://x.com/{username}/status/{post_id} 的 x.com 或 twitter.com 帖子页面链接；不要传用户主页链接、评论链接、帖子正文里的链接、搜索关键词或接口地址。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"X 帖子评论列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一帖子评论列表；切换到其他帖子时请清空 page_token 后从第一页重新获取。"}},"title":"XPostCommentsRequest","type":"object","description":"至少传 post_id 或 post_url 其中一个；两个都传时优先使用 post_id。"},"example":{"post_id":"2079951458137763840","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"XCommentAuthorData":{"properties":{"user_id":{"description":"X 用户稳定数字 ID；不可用时为空字符串。","title":"User Id","type":"string"},"username":{"description":"X 用户名，不带 @；不可用时为空字符串。","title":"Username","type":"string"},"name":{"description":"用户展示名；不是 username；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户主页链接；不可用时为 null。","title":"Profile Url"},"bio":{"description":"用户个人简介；没有或不可用时为空字符串。","title":"Bio","type":"string"},"is_verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"是否显示 X 认证标识；不可用时为 null。","title":"Is Verified"},"follower_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"粉丝数；不可用时为 null。","title":"Follower Count"}},"required":["user_id","username","name","avatar_url","profile_url","bio","is_verified","follower_count"],"title":"XCommentAuthorData","type":"object"},"XCommentItemData":{"properties":{"post_id":{"description":"所属 X 帖子数字 ID；不是评论 ID。","title":"Post Id","type":"string"},"comment_id":{"description":"X 一级评论 ID；请按字符串原样保留。","title":"Comment Id","type":"string"},"comment_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"评论自身详情页链接；主要用于展示；不是所属帖子的 post_url，不要作为评论列表入口；不可用时为 null。","title":"Comment Url"},"content":{"description":"评论正文文本；不可用时为空字符串。","title":"Content","type":"string"},"lang":{"description":"评论语言代码；不可用时为空字符串。","title":"Lang","type":"string"},"topic_tags":{"description":"评论中的话题标签；无话题标签或不可用时为空数组；每项只返回 name，不带 #。","items":{"$ref":"#/$defs/XTopicTagData"},"title":"Topic Tags","type":"array"},"mentioned_users":{"description":"评论中 @ 到的用户；无 @ 或不可用时为空数组。","items":{"$ref":"#/$defs/XMentionedUserData"},"title":"Mentioned Users","type":"array"},"external_links":{"description":"评论正文中的链接列表；可能包含外部网站或 X 内部链接；无链接或不可用时为空数组。","items":{"$ref":"#/$defs/XExternalLinkData"},"title":"External Links","type":"array"},"media_count":{"description":"评论包含的媒体数量；等于返回的 media_items 数量。","title":"Media Count","type":"integer"},"media_items":{"description":"评论包含的图片/视频媒体列表；无媒体或不可用时为空数组。","items":{"$ref":"#/$defs/XMediaItemData"},"title":"Media Items","type":"array"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该评论累计点赞数；不可用时为 null。","title":"Like Count"},"reply_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该评论累计回复数；不是当前页数量；评论列表不内嵌这些回复，需要读取时使用该评论的 post_id 和 comment_id 调用评论回复入口；不可用时为 null。","title":"Reply Count"},"repost_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该评论累计转帖数；不可用时为 null。","title":"Repost Count"},"quote_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该评论被引用次数；不是 quoted_post 对象数量；不可用时为 null。","title":"Quote Count"},"bookmark_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该评论累计书签数；不可用时为 null。","title":"Bookmark Count"},"view_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该评论累计浏览/观看数；不可用时为 null。","title":"View Count"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"is_author_comment":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"是否为帖子作者发表的评论；无法判断时为 null。","title":"Is Author Comment"},"author":{"anyOf":[{"$ref":"#/$defs/XCommentAuthorData"},{"type":"null"}],"description":"评论作者信息；不可用时为 null。"}},"required":["post_id","comment_id","comment_url","content","lang","topic_tags","mentioned_users","external_links","media_count","media_items","like_count","reply_count","repost_count","quote_count","bookmark_count","view_count","publish_time","is_author_comment","author"],"title":"XCommentItemData","type":"object"},"XExternalLinkData":{"properties":{"target_url":{"description":"正文链接展开后的目标链接；可能是外部网站或 X 内部链接；不可用时为空字符串。","title":"Target Url","type":"string"},"short_url":{"description":"X 正文中的 t.co 短链接；不可用时为空字符串。","title":"Short Url","type":"string"}},"required":["target_url","short_url"],"title":"XExternalLinkData","type":"object"},"XMediaItemData":{"properties":{"media_id":{"description":"媒体项 ID；不可用时为空字符串。","title":"Media Id","type":"string"},"media_type":{"description":"媒体项类型；photo 表示图片，video 表示视频。","enum":["photo","video"],"title":"Media Type","type":"string","x-socialdatax-enum-labels":{"photo":"图片","video":"视频"}},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"媒体项封面图链接；图片媒体为图片本身，视频媒体为视频封面；不可用时为 null。","title":"Cover Image Url"},"video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"视频播放资源链接；图片媒体或不可用时为 null。","title":"Video Url"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"媒体宽度，像素；视频实际清晰度以 video_url 资源为准；不可用时为 null。","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"媒体高度，像素；视频实际清晰度以 video_url 资源为准；不可用时为 null。","title":"Height"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频时长，单位毫秒；图片媒体或不可用时为 null。","title":"Duration Ms"}},"required":["media_id","media_type","cover_image_url","video_url","width","height","duration_ms"],"title":"XMediaItemData","type":"object"},"XMentionedUserData":{"properties":{"user_id":{"description":"被 @ 用户 ID；不可用时为空字符串。","title":"User Id","type":"string"},"username":{"description":"被 @ 用户名，不带 @；不可用时为空字符串。","title":"Username","type":"string"},"name":{"description":"被 @ 用户展示名；不可用时为空字符串。","title":"Name","type":"string"}},"required":["user_id","username","name"],"title":"XMentionedUserData","type":"object"},"XTopicTagData":{"properties":{"name":{"description":"话题标签名称，不带 #。","title":"Name","type":"string"}},"required":["name"],"title":"XTopicTagData","type":"object"}},"properties":{"post_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"所属帖子详情页链接；不是评论链接；不可用时为 null。","title":"Post Url"},"items":{"description":"当前页一级评论列表；当前页可能为空，是否可继续翻页以 next_page_token 是否为空为准。","items":{"$ref":"#/$defs/XCommentItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多评论。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；只用于当前帖子评论列表续页；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。","title":"Next Page Token","type":"string"},"comment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该帖子评论总数；不是当前页 items 数量；不可用时为 null。","title":"Comment Count"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["post_url","items","next_page_token","comment_count","points"],"title":"XPostCommentsResult","type":"object"},"example":{"post_url":"https://x.com/alex_prompter/status/2079951458137763840","items":[{"post_id":"2079951458137763840","comment_id":"2079951470322192501","comment_url":"https://x.com/alex_prompter/status/2079951470322192501","content":"Comment text from X.","lang":"en","topic_tags":[],"mentioned_users":[{"user_id":"4398626122","username":"OpenAI","name":"OpenAI"}],"external_links":[{"target_url":"https://linktr.ee/alex_prompter","short_url":"https://t.co/4GX8faMyEP"}],"media_count":1,"media_items":[{"media_id":"2079993631474372608","media_type":"photo","cover_image_url":"https://example.invalid/x-comment-photo.jpg","video_url":null,"width":736,"height":1104,"duration_ms":null}],"like_count":83,"reply_count":20,"repost_count":2,"quote_count":1,"bookmark_count":171,"view_count":189660,"publish_time":1784734048,"is_author_comment":true,"author":{"user_id":"1643695629665722379","username":"alex_prompter","name":"Alex Prompter","avatar_url":"https://example.invalid/avatar.jpg","profile_url":"https://x.com/alex_prompter","bio":"","is_verified":true,"follower_count":278971}}],"next_page_token":"opaque-comments-page-token","comment_count":3359,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["x_get_post_comments_by_post_id","x_get_post_comments_by_post_url"]},{"operation_id":"x_get_post_comment_replies","platform_id":"x","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/x/post/comment/reply/list","summary":"获取 X 评论回复列表","description":"根据 X/Twitter 帖子 ID 和一级评论 ID 获取公开评论回复列表；先从评论列表接口响应的 items[*].post_id 和 items[*].comment_id 取值。继续翻页传 page_token，响应返回 next_page_token。","tags":["评论回复","推特","X"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"post_id":{"title":"Post Id","type":"string","description":"X 帖子 ID；用户已提供时直接使用，否则请原样复制获取一级评论时使用的 post_id，或评论列表 items[*].post_id；必须是数字字符串；不要传评论 ID、帖子链接、用户名或分享文案。"},"comment_id":{"title":"Comment Id","type":"string","description":"X 一级评论 ID；用户已提供时直接使用，否则请原样复制 x_get_post_comments_by_post_id 或 x_get_post_comments_by_post_url 返回的 items[*].comment_id；不要传帖子 ID、评论回复结果里的 items[*].comment_id、评论链接、用户主页链接或分享文案。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"X 评论回复列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一帖子下同一条一级评论的回复列表；切换 post_id 或 comment_id 时请清空 page_token 后从第一页重新获取。"}},"required":["post_id","comment_id"],"title":"XPostCommentRepliesRequest","type":"object"},"example":{"post_id":"2079951458137763840","comment_id":"2079951470322192501","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"XCommentAuthorData":{"properties":{"user_id":{"description":"X 用户稳定数字 ID；不可用时为空字符串。","title":"User Id","type":"string"},"username":{"description":"X 用户名，不带 @；不可用时为空字符串。","title":"Username","type":"string"},"name":{"description":"用户展示名；不是 username；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户主页链接；不可用时为 null。","title":"Profile Url"},"bio":{"description":"用户个人简介；没有或不可用时为空字符串。","title":"Bio","type":"string"},"is_verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"是否显示 X 认证标识；不可用时为 null。","title":"Is Verified"},"follower_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"粉丝数；不可用时为 null。","title":"Follower Count"}},"required":["user_id","username","name","avatar_url","profile_url","bio","is_verified","follower_count"],"title":"XCommentAuthorData","type":"object"},"XCommentReplyItemData":{"properties":{"post_id":{"description":"所属 X 帖子数字 ID；不是评论 ID。","title":"Post Id","type":"string"},"comment_id":{"description":"X 评论回复自身 ID；不要作为评论回复入口输入。","title":"Comment Id","type":"string"},"parent_comment_id":{"description":"所属一级评论 ID。","title":"Parent Comment Id","type":"string"},"comment_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"评论回复自身详情页链接；主要用于展示；不是所属帖子链接，也不是评论回复列表入口；不可用时为 null。","title":"Comment Url"},"content":{"description":"评论回复正文文本；不可用时为空字符串。","title":"Content","type":"string"},"lang":{"description":"评论回复语言代码；不可用时为空字符串。","title":"Lang","type":"string"},"topic_tags":{"description":"评论回复中的话题标签；无话题标签或不可用时为空数组；每项只返回 name，不带 #。","items":{"$ref":"#/$defs/XTopicTagData"},"title":"Topic Tags","type":"array"},"mentioned_users":{"description":"评论回复中 @ 到的用户；无 @ 或不可用时为空数组。","items":{"$ref":"#/$defs/XMentionedUserData"},"title":"Mentioned Users","type":"array"},"external_links":{"description":"评论回复正文中的链接列表；可能包含外部网站或 X 内部链接；无链接或不可用时为空数组。","items":{"$ref":"#/$defs/XExternalLinkData"},"title":"External Links","type":"array"},"media_count":{"description":"评论回复包含的媒体数量；等于返回的 media_items 数量。","title":"Media Count","type":"integer"},"media_items":{"description":"评论回复包含的图片/视频媒体列表；无媒体或不可用时为空数组。","items":{"$ref":"#/$defs/XMediaItemData"},"title":"Media Items","type":"array"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该评论回复累计点赞数；不可用时为 null。","title":"Like Count"},"repost_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该评论回复累计转帖数；不可用时为 null。","title":"Repost Count"},"quote_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该评论回复被引用次数；不是 quoted_post 对象数量；不可用时为 null。","title":"Quote Count"},"bookmark_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该评论回复累计书签数；不可用时为 null。","title":"Bookmark Count"},"view_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该评论回复累计浏览/观看数；不可用时为 null。","title":"View Count"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论回复发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"author":{"anyOf":[{"$ref":"#/$defs/XCommentAuthorData"},{"type":"null"}],"description":"评论回复作者信息；不可用时为 null。"}},"required":["post_id","comment_id","parent_comment_id","comment_url","content","lang","topic_tags","mentioned_users","external_links","media_count","media_items","like_count","repost_count","quote_count","bookmark_count","view_count","publish_time","author"],"title":"XCommentReplyItemData","type":"object"},"XExternalLinkData":{"properties":{"target_url":{"description":"正文链接展开后的目标链接；可能是外部网站或 X 内部链接；不可用时为空字符串。","title":"Target Url","type":"string"},"short_url":{"description":"X 正文中的 t.co 短链接；不可用时为空字符串。","title":"Short Url","type":"string"}},"required":["target_url","short_url"],"title":"XExternalLinkData","type":"object"},"XMediaItemData":{"properties":{"media_id":{"description":"媒体项 ID；不可用时为空字符串。","title":"Media Id","type":"string"},"media_type":{"description":"媒体项类型；photo 表示图片，video 表示视频。","enum":["photo","video"],"title":"Media Type","type":"string","x-socialdatax-enum-labels":{"photo":"图片","video":"视频"}},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"媒体项封面图链接；图片媒体为图片本身，视频媒体为视频封面；不可用时为 null。","title":"Cover Image Url"},"video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"视频播放资源链接；图片媒体或不可用时为 null。","title":"Video Url"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"媒体宽度，像素；视频实际清晰度以 video_url 资源为准；不可用时为 null。","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"媒体高度，像素；视频实际清晰度以 video_url 资源为准；不可用时为 null。","title":"Height"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频时长，单位毫秒；图片媒体或不可用时为 null。","title":"Duration Ms"}},"required":["media_id","media_type","cover_image_url","video_url","width","height","duration_ms"],"title":"XMediaItemData","type":"object"},"XMentionedUserData":{"properties":{"user_id":{"description":"被 @ 用户 ID；不可用时为空字符串。","title":"User Id","type":"string"},"username":{"description":"被 @ 用户名，不带 @；不可用时为空字符串。","title":"Username","type":"string"},"name":{"description":"被 @ 用户展示名；不可用时为空字符串。","title":"Name","type":"string"}},"required":["user_id","username","name"],"title":"XMentionedUserData","type":"object"},"XTopicTagData":{"properties":{"name":{"description":"话题标签名称，不带 #。","title":"Name","type":"string"}},"required":["name"],"title":"XTopicTagData","type":"object"}},"properties":{"items":{"description":"当前页评论回复列表；当前页可能为空，是否可继续翻页以 next_page_token 是否为空为准。","items":{"$ref":"#/$defs/XCommentReplyItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多评论回复。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；只用于当前帖子下同一条一级评论的评论回复列表续页；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"XPostCommentRepliesResult","type":"object"},"example":{"items":[{"post_id":"2079951458137763840","comment_id":"2080025320107999528","parent_comment_id":"2079951470322192501","comment_url":"https://x.com/Skeuleos/status/2080025320107999528","content":"Reply text from X.","lang":"en","topic_tags":[],"mentioned_users":[],"external_links":[],"media_count":0,"media_items":[],"like_count":3,"repost_count":0,"quote_count":0,"bookmark_count":4,"view_count":100,"publish_time":1784751600,"author":{"user_id":"1273481605593686016","username":"Skeuleos","name":"Skeuleos","avatar_url":"https://example.invalid/x-reply-avatar.jpg","profile_url":"https://x.com/Skeuleos","bio":"","is_verified":false,"follower_count":null}}],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["x_get_post_comment_replies_by_comment_id"]},{"operation_id":"x_get_user_info","platform_id":"x","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/x/user/info","summary":"获取 X 用户信息","description":"根据 X/Twitter 用户 ID、用户名或用户主页链接获取公开用户信息；请求体必须且只能传 user_id、username 或 profile_url 其中一个。搜索、详情、评论、评论回复或用户帖子列表结果中的非空 author.user_id、author.username、author.profile_url 都可作为入口。","tags":["用户信息","推特","X"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"user_id":{"default":"","title":"User Id","type":"string","description":"X 用户稳定数字 ID；用户已提供时原样使用，否则可从搜索、详情、评论或评论回复结果的非空 author.user_id、用户帖子列表结果的非空 author.user_id，或用户信息结果的非空 user_id 原样复制；必须是数字字符串；不要传用户名、用户主页链接、帖子链接或分享文案。"},"username":{"default":"","title":"Username","type":"string","description":"X 用户名；推荐从搜索、详情、评论或评论回复结果的非空 author.username，或用户帖子列表结果的非空 author.username，或用户信息结果的非空 username 原样复制，该值不带 @；如果用户给的是 @username 也可以传；不要传用户主页链接、帖子链接或分享文案。"},"profile_url":{"default":"","title":"Profile Url","type":"string","description":"X 用户主页链接；从搜索、详情、评论或评论回复结果的非空 author.profile_url，或用户帖子列表结果的非空 author.profile_url，或用户信息结果的非空 profile_url 原样复制；也可传用户提供的 x.com 或 twitter.com 用户主页链接；不要传帖子链接、评论链接、帖子正文里的链接、搜索关键词或接口地址。"}},"title":"XUserInfoRequest","type":"object","description":"请求体必须且只能传 user_id、username 或 profile_url 其中一个。"},"example":{"user_id":"4398626122"}},"response":{"content_type":"application/json","schema":{"properties":{"user_id":{"description":"X 用户稳定数字 ID；不可用时为空字符串。","title":"User Id","type":"string"},"username":{"description":"X 用户名，不带 @；不可用时为空字符串。","title":"Username","type":"string"},"name":{"description":"用户展示名；不是 username；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户主页链接；不可用时为 null。","title":"Profile Url"},"bio":{"description":"用户个人简介；没有或不可用时为空字符串。","title":"Bio","type":"string"},"external_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户主页填写的网站或外部链接；不是用户主页链接；标准用户主页请使用 profile_url；不可用时为 null。","title":"External Url"},"is_verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"是否显示 X 认证标识；不可用时为 null。","title":"Is Verified"},"verified_type":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"认证类型补充文本；不用于判断是否认证，应以 is_verified 为准；没有或不可用时为 null。","title":"Verified Type"},"is_private":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"是否私密/受保护账号；不可用时为 null。","title":"Is Private"},"affiliated_account_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该账号关联的账号数量；不可用时为 null。","title":"Affiliated Account Count"},"follower_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"粉丝数；不可用时为 null。","title":"Follower Count"},"following_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"关注数；不可用时为 null。","title":"Following Count"},"post_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"累计发帖数；不可用时为 null。","title":"Post Count"},"media_post_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"累计媒体帖数；不可用时为 null。","title":"Media Post Count"},"location":{"description":"用户主页资料里填写的所在地；不是 IP 属地；不可用时为空字符串。","title":"Location","type":"string"},"header_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户主页头图链接；不可用时为 null。","title":"Header Image Url"},"pinned_post_ids":{"description":"置顶帖子 ID 列表；可用于 x_get_post_detail_by_post_id；没有或不可用时为空数组。","items":{"type":"string"},"title":"Pinned Post Ids","type":"array"},"account_created_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"账号创建时间，秒级 Unix 时间戳；不可用时为 null。","title":"Account Created Time"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["user_id","username","name","avatar_url","profile_url","bio","external_url","is_verified","verified_type","is_private","affiliated_account_count","follower_count","following_count","post_count","media_post_count","location","header_image_url","pinned_post_ids","account_created_time","points"],"title":"XUserInfoData","type":"object"},"example":{"user_id":"4398626122","username":"OpenAI","name":"OpenAI","avatar_url":"https://example.invalid/openai-avatar.jpg","profile_url":"https://x.com/OpenAI","bio":"OpenAI profile bio.","external_url":"https://openai.com","is_verified":true,"verified_type":null,"is_private":false,"affiliated_account_count":7,"follower_count":5067507,"following_count":4,"post_count":2034,"media_post_count":677,"location":"","header_image_url":"https://example.invalid/openai-header.jpg","pinned_post_ids":["2082577277246972300"],"account_created_time":1449442268,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["x_get_user_info_by_user_id","x_get_user_info_by_username","x_get_user_info_by_profile_url"]},{"operation_id":"x_get_user_posts","platform_id":"x","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/x/user/post/list","summary":"获取 X 用户帖子列表","description":"根据 X/Twitter 用户 ID、用户名或用户主页链接获取公开用户帖子列表；请求体必须且只能传 user_id、username 或 profile_url 其中一个。搜索、详情、评论、评论回复或用户帖子列表结果中的非空 author.user_id、author.username、author.profile_url，或用户信息结果中的非空 user_id、username、profile_url 都可作为入口。继续翻页传 page_token，响应返回 next_page_token。","tags":["用户帖子列表","推特","X"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"user_id":{"default":"","title":"User Id","type":"string","description":"X 用户稳定数字 ID；用户已提供时原样使用，否则可从搜索、详情、评论或评论回复结果的非空 author.user_id、用户帖子列表结果的非空 author.user_id，或用户信息结果的非空 user_id 原样复制；必须是数字字符串；不要传用户名、用户主页链接、帖子链接或分享文案。"},"username":{"default":"","title":"Username","type":"string","description":"X 用户名；推荐从搜索、详情、评论或评论回复结果的非空 author.username，或用户帖子列表结果的非空 author.username，或用户信息结果的非空 username 原样复制，该值不带 @；如果用户给的是 @username 也可以传；不要传用户主页链接、帖子链接或分享文案。"},"profile_url":{"default":"","title":"Profile Url","type":"string","description":"X 用户主页链接；从搜索、详情、评论或评论回复结果的非空 author.profile_url，或用户帖子列表结果的非空 author.profile_url，或用户信息结果的非空 profile_url 原样复制；也可传用户提供的 x.com 或 twitter.com 用户主页链接；不要传帖子链接、评论链接、帖子正文里的链接、搜索关键词或接口地址。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"X 用户帖子列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一用户帖子列表；切换 user_id、username 或 profile_url 时请清空 page_token 后从第一页重新获取。"}},"title":"XUserPostsRequest","type":"object","description":"请求体必须且只能传 user_id、username 或 profile_url 其中一个。"},"example":{"user_id":"4398626122","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"XExternalLinkData":{"properties":{"target_url":{"description":"正文链接展开后的目标链接；可能是外部网站或 X 内部链接；不可用时为空字符串。","title":"Target Url","type":"string"},"short_url":{"description":"X 正文中的 t.co 短链接；不可用时为空字符串。","title":"Short Url","type":"string"}},"required":["target_url","short_url"],"title":"XExternalLinkData","type":"object"},"XMediaItemData":{"properties":{"media_id":{"description":"媒体项 ID；不可用时为空字符串。","title":"Media Id","type":"string"},"media_type":{"description":"媒体项类型；photo 表示图片，video 表示视频。","enum":["photo","video"],"title":"Media Type","type":"string","x-socialdatax-enum-labels":{"photo":"图片","video":"视频"}},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"媒体项封面图链接；图片媒体为图片本身，视频媒体为视频封面；不可用时为 null。","title":"Cover Image Url"},"video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"视频播放资源链接；图片媒体或不可用时为 null。","title":"Video Url"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"媒体宽度，像素；视频实际清晰度以 video_url 资源为准；不可用时为 null。","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"媒体高度，像素；视频实际清晰度以 video_url 资源为准；不可用时为 null。","title":"Height"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频时长，单位毫秒；图片媒体或不可用时为 null。","title":"Duration Ms"}},"required":["media_id","media_type","cover_image_url","video_url","width","height","duration_ms"],"title":"XMediaItemData","type":"object"},"XMentionedUserData":{"properties":{"user_id":{"description":"被 @ 用户 ID；不可用时为空字符串。","title":"User Id","type":"string"},"username":{"description":"被 @ 用户名，不带 @；不可用时为空字符串。","title":"Username","type":"string"},"name":{"description":"被 @ 用户展示名；不可用时为空字符串。","title":"Name","type":"string"}},"required":["user_id","username","name"],"title":"XMentionedUserData","type":"object"},"XPostSearchItemData":{"properties":{"post_id":{"description":"X 帖子数字 ID；帖子详情或评论列表查询优先使用该字段；请按字符串原样保留。","title":"Post Id","type":"string"},"post_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"X 帖子详情页链接；主要用于展示；详情或评论列表查询优先使用 post_id，只有没有 post_id 时再作为 URL 入口；不是帖子正文里的链接；不可用时为 null。","title":"Post Url"},"post_type":{"description":"帖子类型；text=未返回图片/视频媒体的文字帖，photo=图片帖，video=包含视频的帖子。","enum":["text","photo","video"],"title":"Post Type","type":"string","x-socialdatax-enum-labels":{"text":"文字帖","photo":"图片帖","video":"视频帖"}},"text":{"description":"帖子正文文本；不可用时为空字符串。","title":"Text","type":"string"},"lang":{"description":"帖子语言代码；不可用时为空字符串。","title":"Lang","type":"string"},"topic_tags":{"description":"帖子中的话题标签；无话题标签或不可用时为空数组；每项只返回 name，不带 #。","items":{"$ref":"#/$defs/XTopicTagData"},"title":"Topic Tags","type":"array"},"mentioned_users":{"description":"帖子中 @ 到的用户；无 @ 或不可用时为空数组。","items":{"$ref":"#/$defs/XMentionedUserData"},"title":"Mentioned Users","type":"array"},"external_links":{"description":"帖子正文中的链接列表；可能包含外部网站或 X 内部链接；无链接或不可用时为空数组。","items":{"$ref":"#/$defs/XExternalLinkData"},"title":"External Links","type":"array"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"帖子首个可用媒体封面图链接；无媒体或不可用时为 null。","title":"Cover Image Url"},"media_count":{"description":"帖子包含的媒体数量；等于返回的 media_items 数量。","title":"Media Count","type":"integer"},"media_items":{"description":"帖子包含的图片/视频媒体列表；无媒体或不可用时为空数组。","items":{"$ref":"#/$defs/XMediaItemData"},"title":"Media Items","type":"array"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该帖累计点赞数；不可用时为 null。","title":"Like Count"},"reply_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该帖累计回复/评论统计；不是评论列表当前页 items 数量；不可用时为 null。","title":"Reply Count"},"repost_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该帖累计转帖数；不可用时为 null。","title":"Repost Count"},"quote_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该帖被引用次数；不是 quoted_post 对象数量；不可用时为 null。","title":"Quote Count"},"bookmark_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该帖累计书签数；不可用时为 null。","title":"Bookmark Count"},"view_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该帖累计浏览/观看数；不可用时为 null。","title":"View Count"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"conversation_id":{"description":"会话/讨论串归组 ID；不是评论 ID；不可用时为空字符串。","title":"Conversation Id","type":"string"},"reply_to_post_id":{"description":"该帖回复的上级帖子 ID；不是评论 ID；没有或不可用时为空字符串。","title":"Reply To Post Id","type":"string"},"quoted_post":{"anyOf":[{"$ref":"#/$defs/XQuotedPostData"},{"type":"null"}],"description":"被引用的帖子摘要；不是完整帖子详情结构；没有引用帖或不可用时为 null。"},"reposted_post":{"anyOf":[{"$ref":"#/$defs/XRepostedPostData"},{"type":"null"}],"description":"被转帖的原帖摘要；不是引用帖，也不是完整帖子详情结构；没有转帖原帖或不可用时为 null。"},"author":{"anyOf":[{"$ref":"#/$defs/XUserSummaryData"},{"type":"null"}],"description":"帖子作者信息；不可用时为 null。"}},"required":["post_id","post_url","post_type","text","lang","topic_tags","mentioned_users","external_links","cover_image_url","media_count","media_items","like_count","reply_count","repost_count","quote_count","bookmark_count","view_count","publish_time","conversation_id","reply_to_post_id","quoted_post","reposted_post","author"],"title":"XPostSearchItemData","type":"object"},"XQuotedPostData":{"properties":{"post_id":{"description":"被引用的 X 帖子数字 ID；quoted_post 不为 null 时，引用帖详情或评论列表查询优先使用该字段；请按字符串原样保留。","title":"Post Id","type":"string"},"post_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"被引用帖子详情页链接；主要用于展示；引用帖详情或评论列表查询优先使用 quoted_post.post_id，只有没有被引用帖 post_id 时再作为 URL 入口；不是正文里的链接；不可用时为 null。","title":"Post Url"},"text":{"description":"被引用帖子正文文本；不可用时为空字符串。","title":"Text","type":"string"},"media_items":{"description":"被引用帖子携带的图片/视频媒体列表；无媒体或不可用时为空数组。","items":{"$ref":"#/$defs/XMediaItemData"},"title":"Media Items","type":"array"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被引用帖子自身的累计点赞数；不可用时为 null。","title":"Like Count"},"reply_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被引用帖子自身的累计回复/评论统计；不是评论列表当前页 items 数量；不可用时为 null。","title":"Reply Count"},"repost_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被引用帖子自身的累计转帖数；不可用时为 null。","title":"Repost Count"},"quote_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被引用帖子自身被引用次数；不是 quoted_post 对象数量；不可用时为 null。","title":"Quote Count"},"bookmark_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被引用帖子自身的累计书签数；不可用时为 null。","title":"Bookmark Count"},"view_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被引用帖子自身的累计浏览/观看数；不可用时为 null。","title":"View Count"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被引用帖子发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"author":{"anyOf":[{"$ref":"#/$defs/XUserSummaryData"},{"type":"null"}],"description":"被引用帖子作者信息；不可用时为 null。"}},"required":["post_id","post_url","text","media_items","like_count","reply_count","repost_count","quote_count","bookmark_count","view_count","publish_time","author"],"title":"XQuotedPostData","type":"object"},"XRepostedPostData":{"properties":{"post_id":{"description":"被转帖的原帖数字 ID；reposted_post 不为 null 时，原帖详情或评论列表查询优先使用该字段；请按字符串原样保留。","title":"Post Id","type":"string"},"post_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"被转帖原帖详情页链接；主要用于展示；原帖详情或评论列表查询优先使用 reposted_post.post_id，只有没有原帖 post_id 时再作为 URL 入口；不是正文里的链接；不可用时为 null。","title":"Post Url"},"text":{"description":"被转帖原帖正文文本；不可用时为空字符串。","title":"Text","type":"string"},"media_items":{"description":"被转帖原帖携带的图片/视频媒体列表；无媒体或不可用时为空数组。","items":{"$ref":"#/$defs/XMediaItemData"},"title":"Media Items","type":"array"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被转帖原帖自身的累计点赞数；不可用时为 null。","title":"Like Count"},"reply_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被转帖原帖自身的累计回复/评论统计；不是评论列表当前页 items 数量；不可用时为 null。","title":"Reply Count"},"repost_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被转帖原帖自身的累计转帖数；不可用时为 null。","title":"Repost Count"},"quote_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被转帖原帖自身被引用次数；不是 reposted_post 对象数量；不可用时为 null。","title":"Quote Count"},"bookmark_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被转帖原帖自身的累计书签数；不可用时为 null。","title":"Bookmark Count"},"view_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被转帖原帖自身的累计浏览/观看数；不可用时为 null。","title":"View Count"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"被转帖原帖发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"author":{"anyOf":[{"$ref":"#/$defs/XUserSummaryData"},{"type":"null"}],"description":"被转帖原帖作者信息；不可用时为 null。"}},"required":["post_id","post_url","text","media_items","like_count","reply_count","repost_count","quote_count","bookmark_count","view_count","publish_time","author"],"title":"XRepostedPostData","type":"object"},"XTopicTagData":{"properties":{"name":{"description":"话题标签名称，不带 #。","title":"Name","type":"string"}},"required":["name"],"title":"XTopicTagData","type":"object"},"XUserSummaryData":{"properties":{"user_id":{"description":"X 用户稳定数字 ID；不可用时为空字符串。","title":"User Id","type":"string"},"username":{"description":"X 用户名，不带 @；不可用时为空字符串。","title":"Username","type":"string"},"name":{"description":"用户展示名；不是 username；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户主页链接；不可用时为 null。","title":"Profile Url"},"bio":{"description":"用户个人简介；没有或不可用时为空字符串。","title":"Bio","type":"string"},"is_verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"是否显示 X 认证标识；不可用时为 null。","title":"Is Verified"},"verified_type":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"认证类型补充信息；可能在 is_verified 为 false 时仍有值；没有或不可用时为 null。","title":"Verified Type"},"follower_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"粉丝数；不可用时为 null。","title":"Follower Count"},"following_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"关注数；不可用时为 null。","title":"Following Count"},"location":{"description":"用户主页资料里填写的所在地；不是 IP 属地；不可用时为空字符串。","title":"Location","type":"string"},"external_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户主页填写的网站或外部链接；不是帖子链接；标准用户主页请使用 author.profile_url；不可用时为 null。","title":"External Url"}},"required":["user_id","username","name","avatar_url","profile_url","bio","is_verified","verified_type","follower_count","following_count","location","external_url"],"title":"XUserSummaryData","type":"object"}},"properties":{"items":{"description":"当前页 X 用户帖子列表；当前页可能为空，是否可继续翻页以 next_page_token 是否为空为准。","items":{"$ref":"#/$defs/XPostSearchItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多用户帖子。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；只用于当前用户帖子列表续页；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"XUserPostsResult","type":"object"},"example":{"items":[{"post_id":"2082616636989952217","post_url":"https://x.com/OpenAI/status/2082616636989952217","post_type":"video","text":"GPT-5.6 Sol has been used to solve open problems in mathematics.","lang":"en","topic_tags":[],"mentioned_users":[],"external_links":[],"cover_image_url":"https://example.invalid/x-user-post-cover.jpg","media_count":1,"media_items":[{"media_id":"2082615246855053312","media_type":"video","cover_image_url":"https://example.invalid/x-user-post-cover.jpg","video_url":"https://example.invalid/x-user-post.mp4","width":1920,"height":1080,"duration_ms":109033}],"like_count":6625,"reply_count":264,"repost_count":417,"quote_count":139,"bookmark_count":1181,"view_count":554468,"publish_time":1785369474,"conversation_id":"2082616636989952217","reply_to_post_id":"","quoted_post":null,"reposted_post":null,"author":{"user_id":"4398626122","username":"OpenAI","name":"OpenAI","avatar_url":"https://example.invalid/openai-avatar.jpg","profile_url":"https://x.com/OpenAI","bio":"","is_verified":true,"verified_type":null,"follower_count":null,"following_count":null,"location":"","external_url":null}}],"next_page_token":"opaque-user-posts-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["x_get_user_posts_by_user_id","x_get_user_posts_by_username","x_get_user_posts_by_profile_url"]}]},{"surface":"mcp","status":"available","endpoint":"https://mcp.socialdatax.com/x/mcp","authentication":{"required":true},"capabilities_resource":"x://guides/tool-capabilities","related_http_operation_ids":["x_search_posts","x_get_post_detail","x_get_post_comments","x_get_post_comment_replies","x_get_user_info","x_get_user_posts"]}]},{"platform_id":"youtube","label":"YouTube","english_label":"YouTube","status":"available","surfaces":[{"surface":"http","status":"available","base_path":"/socialdatax/api/v1/youtube","description":"公开 YouTube HTTP API 提供视频搜索接口、视频详情接口、视频评论接口、评论回复接口、频道资料接口和作者发布视频/Shorts列表接口；搜索支持排序、视频类型、发布时间、时长筛选和 page_token 分页。","operations":[{"operation_id":"youtube_search_videos","platform_id":"youtube","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/youtube/video/search","summary":"搜索 YouTube 视频","description":"按关键词搜索 YouTube 公开视频，支持排序、视频类型、发布时间和时长筛选，返回视频结果和下一页分页令牌。","tags":["视频搜索","YouTube"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"keyword":{"title":"Keyword","type":"string","description":"YouTube 视频搜索词，可传关键词或短语，例如品牌名、话题、人物名或内容需求；不要传 YouTube 视频链接、Shorts 链接、频道链接、播放列表链接、video_id 或 page_token。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"YouTube 搜索分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一关键词、排序和筛选链路；更换关键词、排序、视频类型、发布时间或时长筛选时，请清空 page_token 后从第一页重新搜索。"},"sort_type":{"default":"general","enum":["general","time_descending","view_count_descending","rating"],"title":"Sort Type","type":"string","description":"排序方式：general=相关性，time_descending=最新上传，view_count_descending=观看次数最多，rating=评分较高。如无明确排序需求，保持 general。","x-socialdatax-enum-labels":{"general":"相关性","time_descending":"最新上传","view_count_descending":"观看次数最多","rating":"评分较高"}},"video_type":{"default":"all","enum":["all","video","movie"],"title":"Video Type","type":"string","description":"视频类型筛选：all=不限类型，video=普通视频，movie=电影。all 会保留视频类搜索结果，输出项用 video_type 标记可明确识别的类型。可明确识别的 Shorts 会标为 short，其余视频结果标为 video。当前不支持 channel、short 或 playlist 作为筛选项；频道信息只作为视频作者信息返回。movie 是筛选条件，返回项使用同一搜索结果字段，并以 video_type=movie 标记。如无明确类型需求，保持 all。","x-socialdatax-enum-labels":{"all":"不限类型","video":"普通视频","movie":"电影"}},"publish_time_range":{"default":"all","enum":["all","last_hour","today","this_week","this_month","this_year"],"title":"Publish Time Range","type":"string","description":"发布时间筛选：all=不限，last_hour=过去 1 小时，today=今天，this_week=本周，this_month=本月，this_year=今年。如无明确发布时间需求，保持 all。","x-socialdatax-enum-labels":{"all":"不限","last_hour":"过去 1 小时","today":"今天","this_week":"本周","this_month":"本月","this_year":"今年"}},"duration_range":{"default":"all","enum":["all","under_4_min","between_4_and_20_min","over_20_min"],"title":"Duration Range","type":"string","description":"视频时长筛选：all=不限，under_4_min=4 分钟以内，between_4_and_20_min=4 到 20 分钟，over_20_min=20 分钟以上。只对视频类搜索结果有意义；如无明确时长需求，保持 all。","x-socialdatax-enum-labels":{"all":"不限","under_4_min":"4 分钟以内","between_4_and_20_min":"4 到 20 分钟","over_20_min":"20 分钟以上"}}},"required":["keyword"],"title":"InternalYoutubeVideoSearchRequest","type":"object"},"example":{"keyword":"camping"}},"response":{"content_type":"application/json","schema":{"$defs":{"YoutubeAuthorSummaryData":{"properties":{"channel_id":{"description":"YouTube 频道 ID；不可用时为空字符串。","title":"Channel Id","type":"string"},"name":{"description":"频道或作者名称；不可用时为空字符串。","title":"Name","type":"string"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"频道主页链接；不可用时为 null。","title":"Profile Url"}},"required":["channel_id","name","profile_url"],"title":"YoutubeAuthorSummaryData","type":"object"},"YoutubeSearchItemData":{"properties":{"video_id":{"description":"YouTube 视频 ID；可作为搜索结果去重和引用的稳定键。","title":"Video Id","type":"string"},"video_type":{"description":"搜索结果类型，不是搜索筛选参数：video=普通视频或未细分的视频结果，short=Shorts 短视频，movie=电影筛选结果；使用 all 搜索时，只有明确识别为 Shorts 的结果会标为 short，其余视频结果标为 video。","enum":["video","short","movie"],"title":"Video Type","type":"string","x-socialdatax-enum-labels":{"video":"普通视频或未细分的视频结果","short":"Shorts 短视频","movie":"电影筛选结果"}},"title":{"description":"搜索结果标题；不可用时为空字符串。","title":"Title","type":"string"},"summary":{"description":"搜索结果摘要；不是全文或转写；不可用时为空字符串。","title":"Summary","type":"string"},"share_url":{"description":"可打开或分享的 YouTube 视频页面链接；不是视频播放资源链接。","title":"Share Url","type":"string"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"视频封面或缩略图链接；不可用时为 null。","title":"Cover Image Url"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频时长，单位毫秒；仅在搜索结果时长可确定解析时返回，否则为 null。","title":"Duration Ms"},"view_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"观看次数；搜索结果可解析时返回数字，不可用时为 null。","title":"View Count"},"publish_time_text":{"description":"发布时间原始展示文本，通常是相对时间；不是秒级时间戳；不可用时为空字符串。","title":"Publish Time Text","type":"string"},"author":{"$ref":"#/$defs/YoutubeAuthorSummaryData","description":"作者或频道信息。"}},"required":["video_id","video_type","title","summary","share_url","cover_image_url","duration_ms","view_count","publish_time_text","author"],"title":"YoutubeSearchItemData","type":"object"}},"properties":{"items":{"description":"当前页 YouTube 搜索结果列表；当前页可能为空，是否可继续翻页以 next_page_token 是否为空为准。","items":{"$ref":"#/$defs/YoutubeSearchItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；只用于当前 YouTube 搜索续页；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"YoutubeVideoSearchResult","type":"object"},"example":{"items":[{"video_id":"UzLkcuAXevg","video_type":"video","title":"Rain camping inside a huge capsule air tent","summary":"A camping trip in heavy rain, with tent setup, camp cooking and overnight outdoor scenes.","share_url":"https://www.youtube.com/watch?v=UzLkcuAXevg","cover_image_url":"https://i.ytimg.com/vi/UzLkcuAXevg/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLAiKRPsB3gKlHeKyZoQQoUuJYrjAg","duration_ms":2149000,"view_count":11714266,"publish_time_text":"11 months ago","author":{"channel_id":"UC4zNtKX3XTplYQWNFPorvXQ","name":"Kirin Camp","profile_url":"https://www.youtube.com/channel/UC4zNtKX3XTplYQWNFPorvXQ"}}],"next_page_token":"opaque-search-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["youtube_search_videos"]},{"operation_id":"youtube_get_video_detail","platform_id":"youtube","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/youtube/video/detail","summary":"获取 YouTube 视频详情","description":"根据 YouTube 视频链接获取公开视频详情，返回完整描述、封面、时长、观看次数、点赞数、评论数、发布时间、关键词和频道信息。","tags":["视频详情","YouTube"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"video_url":{"title":"Video Url","type":"string","description":"YouTube 视频页面链接；支持 watch、youtu.be 短链和 Shorts 链接。从搜索结果读取详情时，直接传搜索结果里的 share_url（items[*].share_url）；不要传频道链接、播放列表链接、搜索页链接或裸 video_id。"}},"required":["video_url"],"title":"InternalYoutubeVideoDetailRequest","type":"object"},"example":{"video_url":"https://www.youtube.com/watch?v=UzLkcuAXevg"}},"response":{"content_type":"application/json","schema":{"$defs":{"YoutubeAuthorSummaryData":{"properties":{"channel_id":{"description":"YouTube 频道 ID；不可用时为空字符串。","title":"Channel Id","type":"string"},"name":{"description":"频道或作者名称；不可用时为空字符串。","title":"Name","type":"string"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"频道主页链接；不可用时为 null。","title":"Profile Url"}},"required":["channel_id","name","profile_url"],"title":"YoutubeAuthorSummaryData","type":"object"}},"properties":{"video_id":{"description":"YouTube 视频 ID；用于识别和去重。","title":"Video Id","type":"string"},"title":{"description":"视频标题；不可用时为空字符串。","title":"Title","type":"string"},"description":{"description":"视频详情页完整描述文本；不是摘要或视频转写；不可用时为空字符串。","title":"Description","type":"string"},"share_url":{"description":"可打开或分享的 YouTube 视频页面链接；不是视频播放资源链接。","title":"Share Url","type":"string"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"视频封面或缩略图链接；不可用时为 null。","title":"Cover Image Url"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频时长，单位毫秒；不可用时为 null。","title":"Duration Ms"},"view_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"观看次数；不可用时为 null。","title":"View Count"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"点赞数；不可用时为 null。","title":"Like Count"},"comment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论数；不可用时为 null。","title":"Comment Count"},"publish_time":{"description":"发布时间，ISO 8601 时间字符串；不可用时为空字符串。","title":"Publish Time","type":"string"},"topic_tags":{"description":"视频关键词或话题标签；无数据时为空数组。","items":{"type":"string"},"title":"Topic Tags","type":"array"},"author":{"$ref":"#/$defs/YoutubeAuthorSummaryData","description":"作者或频道信息。"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["video_id","title","description","share_url","cover_image_url","duration_ms","view_count","like_count","comment_count","publish_time","topic_tags","author","points"],"title":"YoutubeVideoDetailData","type":"object"},"example":{"video_id":"UzLkcuAXevg","title":"☔️CAMPING IN THE RAIN INSIDE A HUGE CAPSULE AIR TENT","description":"※ Subscriptions and likes are a great help in video production! ❤️\n※ Turn up the volume and enjoy watching!\n※ Multilingual subtitles are included.","share_url":"https://www.youtube.com/watch?v=UzLkcuAXevg","cover_image_url":"https://i.ytimg.com/vi/UzLkcuAXevg/sddefault.jpg","duration_ms":2148000,"view_count":11737134,"like_count":494,"comment_count":59,"publish_time":"2025-07-26T04:45:06-07:00","topic_tags":["camping","camping in the rain","outdoor"],"author":{"channel_id":"UC4zNtKX3XTplYQWNFPorvXQ","name":"Kirin Camp","profile_url":"https://www.youtube.com/channel/UC4zNtKX3XTplYQWNFPorvXQ"},"points":{"cost":10,"balance":990}}},"related_mcp_tools":["youtube_get_video_detail_by_url"]},{"operation_id":"youtube_get_video_comments","platform_id":"youtube","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/youtube/video/comment/list","summary":"获取 YouTube 视频评论","description":"根据 YouTube 视频链接获取公开视频一级评论，支持热门和较新评论优先排序，返回评论列表和下一页分页令牌；按时间排序时，YouTube 可能保留作者评论或置顶评论在当前页前部。","tags":["视频评论","YouTube"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"video_url":{"title":"Video Url","type":"string","description":"YouTube 视频页面链接；支持 watch、youtu.be 短链和 Shorts 链接。从搜索结果读取评论时，直接传搜索结果里的 share_url（items[*].share_url）；不要传频道链接、播放列表链接、搜索页链接或裸 video_id。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"YouTube 视频评论分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一视频和同一 sort_type 的评论续页；更换视频或 sort_type 时，请清空 page_token 后从第一页重新读取评论。"},"sort_type":{"default":"hot","enum":["hot","time_descending"],"title":"Sort Type","type":"string","description":"评论排序方式：hot=热门评论，time_descending=较新评论优先。YouTube 可能保留作者评论或置顶评论在当前页前部；如无明确排序需求，保持 hot。","x-socialdatax-enum-labels":{"hot":"热门评论","time_descending":"较新评论优先"}}},"required":["video_url"],"title":"InternalYoutubeVideoCommentsRequest","type":"object"},"example":{"video_url":"https://www.youtube.com/watch?v=UzLkcuAXevg"}},"response":{"content_type":"application/json","schema":{"$defs":{"YoutubeCommentAuthorData":{"properties":{"channel_id":{"description":"评论作者 YouTube 频道 ID；不可用时为空字符串。","title":"Channel Id","type":"string"},"name":{"description":"评论作者展示名称；不可用时为空字符串。","title":"Name","type":"string"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"评论作者频道主页链接；不可用时为 null。","title":"Profile Url"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"评论作者头像链接；不可用时为 null。","title":"Avatar Url"},"verified":{"description":"评论作者是否有认证标识。","title":"Verified","type":"boolean"}},"required":["channel_id","name","profile_url","avatar_url","verified"],"title":"YoutubeCommentAuthorData","type":"object"},"YoutubeCommentItemData":{"properties":{"comment_id":{"description":"YouTube 一级评论 ID；用于识别评论，不要当作视频 ID 使用。","title":"Comment Id","type":"string"},"content":{"description":"评论正文；不可用时为空字符串。","title":"Content","type":"string"},"publish_time_text":{"description":"评论发布时间原始展示文本，通常是相对时间；不是秒级时间戳；不可用时为空字符串。","title":"Publish Time Text","type":"string"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论点赞数；可解析时返回数字，不可用时为 null。","title":"Like Count"},"reply_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该一级评论下的回复数；可解析时返回数字，不可用时为 null。","title":"Reply Count"},"is_author_comment":{"description":"是否为视频作者发布的一级评论。","title":"Is Author Comment","type":"boolean"},"reply_token":{"description":"读取该评论回复所需的不透明令牌；为空表示当前未提供评论回复入口。它不是评论回复列表的翻页 token；读取回复时传给 youtube_get_video_comment_replies，不要修改、截断或自行生成。","title":"Reply Token","type":"string"},"author":{"$ref":"#/$defs/YoutubeCommentAuthorData","description":"评论作者信息。"}},"required":["comment_id","content","publish_time_text","like_count","reply_count","is_author_comment","reply_token","author"],"title":"YoutubeCommentItemData","type":"object"}},"properties":{"items":{"description":"当前页 YouTube 视频一级评论列表；当前页可能为空，是否可继续翻页以 next_page_token 是否为空为准。","items":{"$ref":"#/$defs/YoutubeCommentItemData"},"title":"Items","type":"array"},"comment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论总数；不是当前页 items 数量；不可用时为 null。","title":"Comment Count"},"next_page_token":{"description":"下一页评论不透明分页令牌；为空表示没有更多评论。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；只用于当前 YouTube 视频和同一 sort_type 的评论续页；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","comment_count","next_page_token","points"],"title":"YoutubeVideoCommentsResult","type":"object"},"example":{"comment_count":59,"items":[{"comment_id":"UgxhrMwm0Hb8FFT-GlB4AaABAg","content":"Tell us the time where you are!","publish_time_text":"11个月前","like_count":545,"reply_count":185,"is_author_comment":true,"reply_token":"opaque-reply-token","author":{"channel_id":"UC4zNtKX3XTplYQWNFPorvXQ","name":"@KirinCamp","profile_url":"https://www.youtube.com/@KirinCamp","avatar_url":"https://yt3.ggpht.com/example=s88-c-k-c0x00ffffff-no-rj","verified":true}}],"next_page_token":"opaque-comment-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["youtube_get_video_comments_by_url"]},{"operation_id":"youtube_get_video_comment_replies","platform_id":"youtube","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/youtube/video/comment/reply/list","summary":"获取 YouTube 评论回复","description":"根据一级评论返回的 reply_token 获取该视频评论下的回复，返回回复列表和下一页分页令牌。","tags":["评论回复","YouTube"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"reply_token":{"title":"Reply Token","type":"string","description":"读取某条 YouTube 视频一级评论回复所需的不透明令牌；用户已提供时直接原样使用；否则从 youtube_get_video_comments_by_url 返回的 items[*].reply_token 原样复制。只有有效且非空的 reply_token 才调用本工具；不要传 comment_id、video_url、video_id、频道链接、播放列表链接或搜索页链接。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"YouTube 评论回复分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一 reply_token 对应的评论回复续页；更换 reply_token 时，请清空 page_token 后从第一页重新读取评论回复。继续翻页时，reply_token 仍传同一条一级评论的原始 reply_token，同时把上一页返回的完整 next_page_token 原样作为 page_token 传回。"}},"required":["reply_token"],"title":"InternalYoutubeCommentRepliesRequest","type":"object"},"example":{"reply_token":"opaque-reply-token"}},"response":{"content_type":"application/json","schema":{"$defs":{"YoutubeCommentAuthorData":{"properties":{"channel_id":{"description":"评论作者 YouTube 频道 ID；不可用时为空字符串。","title":"Channel Id","type":"string"},"name":{"description":"评论作者展示名称；不可用时为空字符串。","title":"Name","type":"string"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"评论作者频道主页链接；不可用时为 null。","title":"Profile Url"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"评论作者头像链接；不可用时为 null。","title":"Avatar Url"},"verified":{"description":"评论作者是否有认证标识。","title":"Verified","type":"boolean"}},"required":["channel_id","name","profile_url","avatar_url","verified"],"title":"YoutubeCommentAuthorData","type":"object"},"YoutubeCommentReplyItemData":{"properties":{"comment_id":{"description":"YouTube 评论回复 ID；用于识别回复，不要当作视频 ID 或一级评论入口使用。","title":"Comment Id","type":"string"},"content":{"description":"回复正文；不可用时为空字符串。","title":"Content","type":"string"},"publish_time_text":{"description":"回复发布时间原始展示文本，通常是相对时间；不是秒级时间戳；不可用时为空字符串。","title":"Publish Time Text","type":"string"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"回复点赞数；可解析时返回数字，不可用时为 null。","title":"Like Count"},"is_author_comment":{"description":"是否为视频作者发布的评论回复。","title":"Is Author Comment","type":"boolean"},"author":{"$ref":"#/$defs/YoutubeCommentAuthorData","description":"回复作者信息。"}},"required":["comment_id","content","publish_time_text","like_count","is_author_comment","author"],"title":"YoutubeCommentReplyItemData","type":"object"}},"properties":{"items":{"description":"当前页 YouTube 评论回复列表；当前页可能为空，是否可继续翻页以 next_page_token 是否为空为准。","items":{"$ref":"#/$defs/YoutubeCommentReplyItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页评论回复不透明分页令牌；为空表示没有更多评论回复。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；只用于同一 reply_token 对应的评论回复续页；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"YoutubeCommentRepliesResult","type":"object"},"example":{"items":[{"comment_id":"UgxhrMwm0Hb8FFT-GlB4AaABAg.AMDIhKH13Y-AMDM3Gilo9y","content":"15:20 pm","publish_time_text":"11个月前","like_count":21,"is_author_comment":false,"author":{"channel_id":"UCcnswyUwcie3BSUIxaYWUWg","name":"@rewind.KworldReplay","profile_url":"https://www.youtube.com/@rewind.KworldReplay","avatar_url":"https://yt3.ggpht.com/example=s88-c-k-c0x00ffffff-no-rj","verified":false}}],"next_page_token":"opaque-comment-replies-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["youtube_get_video_comment_replies"]},{"operation_id":"youtube_get_channel_info","platform_id":"youtube","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/youtube/channel/info","summary":"获取 YouTube 频道资料","description":"根据 YouTube 频道主页链接获取频道资料，返回频道名称、简介、头像、横幅、订阅者数量、频道视频数量、累计观看次数、认证状态、地区和主页外链。","tags":["频道资料","YouTube"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"channel_url":{"title":"Channel Url","type":"string","description":"YouTube 频道主页链接；支持 https://www.youtube.com/@用户名、/channel/、/c/ 和 /user/ 链接形态。如果传入频道 tab 子页链接，会规范化到对应的 https://www.youtube.com/... 频道主页。从搜索、详情、评论或评论回复结果读取频道资料时，直接传 author.profile_url；不要传 channel_id、裸 @用户名、频道名称、视频链接、播放列表链接或搜索页链接。"}},"required":["channel_url"],"title":"InternalYoutubeChannelInfoRequest","type":"object"},"example":{"channel_url":"https://www.youtube.com/@KirinCamp"}},"response":{"content_type":"application/json","schema":{"$defs":{"YoutubeChannelExternalLinkData":{"properties":{"title":{"description":"频道主页外链标题；不可用时为空字符串。","title":"Title","type":"string"},"url":{"description":"可打开的频道主页外链。","title":"Url","type":"string"}},"required":["title","url"],"title":"YoutubeChannelExternalLinkData","type":"object"}},"properties":{"channel_id":{"description":"YouTube 频道 ID；用于识别和去重。","title":"Channel Id","type":"string"},"name":{"description":"频道名称；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"频道头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"频道主页链接；不可用时为 null。","title":"Profile Url"},"bio":{"description":"频道简介；不可用时为空字符串。","title":"Bio","type":"string"},"follower_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"订阅者数量；可能为近似值；不可用时为 null。","title":"Follower Count"},"posted_video_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"频道视频数量；不可用时为 null。","title":"Posted Video Count"},"view_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"频道累计观看次数；不可用时为 null。","title":"View Count"},"verified":{"description":"频道是否有认证标识。","title":"Verified","type":"boolean"},"country":{"description":"频道公开国家或地区；不可用时为空字符串。","title":"Country","type":"string"},"banner_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"频道横幅图链接；不可用时为 null。","title":"Banner Url"},"external_links":{"description":"频道主页外链列表；无外链时为空数组。","items":{"$ref":"#/$defs/YoutubeChannelExternalLinkData"},"title":"External Links","type":"array"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["channel_id","name","avatar_url","profile_url","bio","follower_count","posted_video_count","view_count","verified","country","banner_url","external_links","points"],"title":"YoutubeChannelInfoData","type":"object"},"example":{"channel_id":"UC4zNtKX3XTplYQWNFPorvXQ","name":"Kirin Camp","avatar_url":"https://yt3.googleusercontent.com/example=s160-c-k-c0x00ffffff-no-rj","profile_url":"https://www.youtube.com/channel/UC4zNtKX3XTplYQWNFPorvXQ","bio":"Korean Girl Camper","follower_count":2630000,"posted_video_count":189,"view_count":548017280,"verified":false,"country":"South Korea","banner_url":"https://yt3.googleusercontent.com/example=w2560","external_links":[{"title":"Instagram","url":"https://instagram.com/kirin_camp_"}],"points":{"cost":10,"balance":990}}},"related_mcp_tools":["youtube_get_channel_info_by_url"]},{"operation_id":"youtube_get_user_posted_videos","platform_id":"youtube","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/youtube/user/video/list","summary":"获取 YouTube 作者发布视频/Shorts","description":"根据 YouTube 频道主页链接获取频道发布视频或 Shorts 列表，返回视频列表和下一页分页令牌。","tags":["作者视频","YouTube"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"cost_points":10,"unit":"request","point_unit_price_cny":0.01,"description":"1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"channel_url":{"title":"Channel Url","type":"string","description":"YouTube 频道主页链接；支持 https://www.youtube.com/@用户名、/channel/、/c/ 和 /user/ 链接形态。如果传入频道 tab 子页链接，会规范化到对应的 https://www.youtube.com/... 频道主页。从搜索、详情、评论、评论回复或频道资料结果读取作者发布视频或 Shorts 时，直接传 author.profile_url 或 profile_url；不要传 channel_id、裸 @用户名、频道名称、视频链接、播放列表链接或搜索页链接。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"YouTube 频道发布列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一频道、同一 video_type 的视频续页；更换频道或 video_type 时，请清空 page_token 后从第一页重新读取。"},"video_type":{"default":"video","enum":["video","short"],"title":"Video Type","type":"string","description":"频道发布视频类型：video=频道“视频”tab，short=频道 Shorts tab。默认 video。当前不支持 live、course 或 playlist。更换 video_type 时，请清空 page_token 后从第一页重新读取。","x-socialdatax-enum-labels":{"video":"频道视频","short":"Shorts 短视频"}}},"required":["channel_url"],"title":"InternalYoutubeChannelVideosRequest","type":"object"},"example":{"channel_url":"https://www.youtube.com/@KirinCamp","video_type":"video"}},"response":{"content_type":"application/json","schema":{"$defs":{"YoutubeAuthorSummaryData":{"properties":{"channel_id":{"description":"YouTube 频道 ID；不可用时为空字符串。","title":"Channel Id","type":"string"},"name":{"description":"频道或作者名称；不可用时为空字符串。","title":"Name","type":"string"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"频道主页链接；不可用时为 null。","title":"Profile Url"}},"required":["channel_id","name","profile_url"],"title":"YoutubeAuthorSummaryData","type":"object"},"YoutubeUserPostedVideoItemData":{"properties":{"video_id":{"description":"YouTube 视频 ID；用于识别和去重。","title":"Video Id","type":"string"},"title":{"description":"视频标题；不可用时为空字符串。","title":"Title","type":"string"},"summary":{"description":"频道视频列表卡片摘要；不是全文或转写；不可用时为空字符串。","title":"Summary","type":"string"},"share_url":{"description":"可打开或分享的 YouTube 视频页面链接；不是视频播放资源链接。","title":"Share Url","type":"string"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"视频封面或缩略图链接；不可用时为 null。","title":"Cover Image Url"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"视频时长，单位毫秒；不可用时为 null。","title":"Duration Ms"},"view_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"观看次数；不可用时为 null。","title":"View Count"},"publish_time_text":{"description":"发布时间原始展示文本，通常是相对时间；不是秒级时间戳；不可用时为空字符串。","title":"Publish Time Text","type":"string"},"author":{"$ref":"#/$defs/YoutubeAuthorSummaryData","description":"作者或频道信息。"}},"required":["video_id","title","summary","share_url","cover_image_url","duration_ms","view_count","publish_time_text","author"],"title":"YoutubeUserPostedVideoItemData","type":"object"}},"properties":{"items":{"description":"当前页 YouTube 频道发布视频或 Shorts 列表；当前页可能为空，是否可继续翻页以 next_page_token 是否为空为准。","items":{"$ref":"#/$defs/YoutubeUserPostedVideoItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页频道发布列表不透明分页令牌；为空表示没有更多视频。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；只用于同一频道、同一 video_type 的视频续页；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成。","title":"Next Page Token","type":"string"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["items","next_page_token","points"],"title":"YoutubeUserPostedVideosResult","type":"object"},"example":{"items":[{"video_id":"thzH1DuybcU","title":"☔ 雨中露营，入住豪华双层充气帐篷","summary":"","share_url":"https://www.youtube.com/watch?v=thzH1DuybcU","cover_image_url":"https://i.ytimg.com/vi/thzH1DuybcU/hqdefault.jpg","duration_ms":1632000,"view_count":1620000,"publish_time_text":"4天前","author":{"channel_id":"UC4zNtKX3XTplYQWNFPorvXQ","name":"Kirin Camp","profile_url":"https://www.youtube.com/channel/UC4zNtKX3XTplYQWNFPorvXQ"}}],"next_page_token":"opaque-channel-video-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["youtube_get_user_posted_videos_by_channel_url"]}]},{"surface":"mcp","status":"available","endpoint":"https://mcp.socialdatax.com/youtube/mcp","authentication":{"required":true},"capabilities_resource":"youtube://guides/tool-capabilities","related_http_operation_ids":["youtube_search_videos","youtube_get_video_detail","youtube_get_video_comments","youtube_get_video_comment_replies","youtube_get_channel_info","youtube_get_user_posted_videos"]}]},{"platform_id":"media_transcript","label":"媒体转写","english_label":"Media Transcript","status":"available","surfaces":[{"surface":"http","status":"available","base_path":"/socialdatax/api/v1/media/video-speech-text","description":"公开视频口播转文字 HTTP API 提供跨平台视频口播内容提取；提交任务后可使用 job_id 查询任务状态和结果。","operations":[{"operation_id":"media_submit_video_speech_text","platform_id":"media_transcript","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/media/video-speech-text/submit","summary":"提交视频口播转文字任务","description":"从公开作品链接、分享文案、带音视频文件后缀的资源直链提交口播转文字任务。如果已保存平台原始内容 ID，也可使用 platform + source_id 提交。提交后返回 job_id 和当前任务状态，后续可使用 get 查询任务状态和结果。","tags":["口播转文字","Media"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"unit":"minute","cost_points":10,"point_unit_price_cny":0.01,"description":"按音视频计费时长计费，10 积分/分钟，不足 1 分钟按 1 分钟计费；任务未成功完成不扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Url","description":"公开视频、短链接、分享文案或带音视频文件后缀的资源直链。支持抖音、TikTok、小红书、快手、微博、视频号、Bilibili、Instagram、知乎独立视频或带视频回答、X / Twitter、YouTube 和带音视频文件后缀的资源直链；Bilibili 多 P 视频可用 p 参数指定一个分 P；Instagram 支持普通视频帖和 Reels，不支持图片帖和轮播帖；知乎 URL 入口支持 /zvideo/{zvideo_id} 独立视频和带视频回答页；普通无视频回答不可处理。"},"platform":{"anyOf":[{"enum":["douyin","xhs","kuaishou","weibo","wechat","tiktok","bilibili","instagram","x","youtube","zhihu"],"type":"string"},{"type":"null"}],"default":null,"title":"Platform","description":"已知平台内容 ID 时传平台名；普通场景建议直接传 url。仅支持 douyin、xhs、kuaishou、weibo、wechat、tiktok、bilibili、zhihu、instagram、x、youtube。"},"source_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Source Id","description":"平台内容 ID，需与 platform 一起使用。对应关系：douyin 传 aweme_id，tiktok 传视频 post_id，xhs 传 note_id，kuaishou 传 photo_id，weibo 传 post_id，wechat 传 encrypted_object_id，bilibili 传 bvid（默认转写 P1），zhihu 传独立视频 zvideo_id，instagram 传 post_id，x 传 post_id，youtube 传 video_id；如果只有链接、分享文案或需要指定 Bilibili 分 P，请使用 url。"}},"title":"PublicMediaVideoSpeechTextSubmitRequest","type":"object"},"example":{"url":"https://www.douyin.com/video/7648208200076573925"}},"response":{"content_type":"application/json","schema":{"$defs":{"VideoSpeechTextErrorData":{"additionalProperties":false,"properties":{"code":{"description":"稳定错误码。","title":"Code","type":"string"},"message":{"description":"任务状态说明。","title":"Message","type":"string"},"retryable":{"default":false,"description":"是否可重试。","title":"Retryable","type":"boolean"}},"required":["code","message"],"title":"VideoSpeechTextErrorData","type":"object"},"VideoSpeechTextNextActionData":{"additionalProperties":false,"properties":{"tool_name":{"description":"下一步查询接口的操作名称。","title":"Tool Name","type":"string"},"job_id":{"description":"用于查询任务状态和结果的任务 ID。","title":"Job Id","type":"string"},"arguments":{"additionalProperties":true,"description":"下一步查询接口可直接使用的 request body。","title":"Arguments","type":"object"},"instruction":{"description":"下一步查询说明。","title":"Instruction","type":"string"}},"required":["tool_name","job_id","arguments","instruction"],"title":"VideoSpeechTextNextActionData","type":"object"}},"additionalProperties":false,"properties":{"job_id":{"description":"用于查询任务状态和结果的任务 ID。","title":"Job Id","type":"string"},"status":{"description":"任务状态。","enum":["queued","running","succeeded","failed","expired"],"title":"Status","type":"string"},"is_terminal":{"description":"是否已终态。","title":"Is Terminal","type":"boolean"},"next_poll_after_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"建议下次查询前等待的秒数；非终态时可用。","title":"Next Poll After Seconds"},"next_action":{"anyOf":[{"$ref":"#/$defs/VideoSpeechTextNextActionData"},{"type":"null"}],"description":"非终态时的下一步查询信息，包含 get 查询所需参数。"},"error":{"anyOf":[{"$ref":"#/$defs/VideoSpeechTextErrorData"},{"type":"null"}],"description":"失败或过期时的错误结构；非终态或成功时为 null。"},"message":{"description":"任务状态说明。","title":"Message","type":"string"}},"required":["job_id","status","is_terminal","next_poll_after_seconds","next_action","error","message"],"title":"PublicMediaVideoSpeechTextSubmitResponse","type":"object"},"example":{"job_id":"tr_1784035200000_demo","status":"queued","is_terminal":false,"next_poll_after_seconds":2,"next_action":{"tool_name":"media_get_video_speech_text_job","job_id":"tr_1784035200000_demo","arguments":{"job_id":"tr_1784035200000_demo"},"instruction":"可在 next_poll_after_seconds 秒后使用 get 查询；request body 使用 next_action.arguments。"},"error":null,"message":"口播转文字任务已提交，正在处理中；可稍后使用 get 查询该任务状态和结果。"}},"related_mcp_tools":["douyin_submit_video_speech_text_by_video_url","douyin_submit_video_speech_text_by_aweme_id","xhs_submit_video_speech_text_by_note_url","xhs_submit_video_speech_text_by_note_id","kuaishou_submit_video_speech_text_by_video_url","kuaishou_submit_video_speech_text_by_photo_id","weibo_submit_video_speech_text_by_post_url","weibo_submit_video_speech_text_by_post_id","wechat_submit_video_speech_text_by_video_url","wechat_submit_video_speech_text_by_encrypted_object_id","bilibili_submit_video_speech_text_by_video_url","bilibili_submit_video_speech_text_by_bvid","instagram_submit_video_speech_text_by_post_url","instagram_submit_video_speech_text_by_post_id","zhihu_submit_video_speech_text_by_video_url","zhihu_submit_video_speech_text_by_zvideo_id","x_submit_video_speech_text_by_post_url","x_submit_video_speech_text_by_post_id","tiktok_submit_video_speech_text_by_url","tiktok_submit_video_speech_text_by_aweme_id","youtube_submit_video_speech_text_by_url","youtube_submit_video_speech_text_by_video_id"]},{"operation_id":"media_get_video_speech_text_job","platform_id":"media_transcript","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/media/video-speech-text/get","summary":"查询视频口播转文字任务","description":"按 job_id 查询口播转文字任务。创建任务后会返回 job_id，后续可使用 get 查询该任务的状态和结果，查询不额外扣费。","tags":["口播转文字","Media"],"auth":{"required":true,"schemes":[{"type":"http","scheme":"bearer","header":"Authorization","format":"Bearer <API_KEY>"}]},"billing":{"unit":"query","cost_points":0,"point_unit_price_cny":0.01,"description":"查询不额外扣费。"},"request":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"job_id":{"title":"Job Id","type":"string","description":"口播转文字任务 ID，用于继续查询该任务的状态和结果。"}},"required":["job_id"],"title":"PublicMediaVideoSpeechTextGetRequest","type":"object"},"example":{"job_id":"tr_1784035200000_demo"}},"response":{"content_type":"application/json","schema":{"$defs":{"VideoSpeechTextAuthorData":{"additionalProperties":false,"properties":{"user_id":{"description":"作者用户 ID。","title":"User Id","type":"string"},"name":{"description":"作者昵称。","title":"Name","type":"string"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者主页链接。","title":"Profile Url"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者头像链接。","title":"Avatar Url"}},"required":["user_id","name","profile_url","avatar_url"],"title":"VideoSpeechTextAuthorData","type":"object"},"VideoSpeechTextContentMetaData":{"additionalProperties":false,"properties":{"content_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作品链接。","title":"Content Url"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作品标题；平台无标题时为 null。","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"平台作品原始描述、正文或配文。","title":"Description"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"音视频时长，单位毫秒。","title":"Duration Ms"},"author":{"anyOf":[{"$ref":"#/$defs/VideoSpeechTextAuthorData"},{"type":"null"}],"description":"作者信息。"}},"required":["content_url","title","description","duration_ms","author"],"title":"VideoSpeechTextContentMetaData","type":"object"},"VideoSpeechTextErrorData":{"additionalProperties":false,"properties":{"code":{"description":"稳定错误码。","title":"Code","type":"string"},"message":{"description":"任务状态说明。","title":"Message","type":"string"},"retryable":{"default":false,"description":"是否可重试。","title":"Retryable","type":"boolean"}},"required":["code","message"],"title":"VideoSpeechTextErrorData","type":"object"},"VideoSpeechTextNextActionData":{"additionalProperties":false,"properties":{"tool_name":{"description":"下一步查询接口的操作名称。","title":"Tool Name","type":"string"},"job_id":{"description":"用于查询任务状态和结果的任务 ID。","title":"Job Id","type":"string"},"arguments":{"additionalProperties":true,"description":"下一步查询接口可直接使用的 request body。","title":"Arguments","type":"object"},"instruction":{"description":"下一步查询说明。","title":"Instruction","type":"string"}},"required":["tool_name","job_id","arguments","instruction"],"title":"VideoSpeechTextNextActionData","type":"object"},"VideoSpeechTextTranscriptData":{"additionalProperties":false,"properties":{"text":{"description":"完整口播转文字结果。","title":"Text","type":"string"},"segments":{"description":"按时间顺序排列的分段结果。","items":{"$ref":"#/$defs/VideoSpeechTextTranscriptSegmentData"},"title":"Segments","type":"array"}},"required":["text","segments"],"title":"VideoSpeechTextTranscriptData","type":"object"},"VideoSpeechTextTranscriptSegmentData":{"additionalProperties":false,"properties":{"start_ms":{"description":"分段开始时间，单位毫秒。","minimum":0,"title":"Start Ms","type":"integer"},"end_ms":{"description":"分段结束时间，单位毫秒。","minimum":0,"title":"End Ms","type":"integer"},"text":{"description":"分段文本。","title":"Text","type":"string"}},"required":["start_ms","end_ms","text"],"title":"VideoSpeechTextTranscriptSegmentData","type":"object"}},"additionalProperties":false,"properties":{"job_id":{"description":"用于查询任务状态和结果的任务 ID。","title":"Job Id","type":"string"},"status":{"description":"任务状态。","enum":["queued","running","succeeded","failed","expired"],"title":"Status","type":"string"},"is_terminal":{"description":"是否已终态。","title":"Is Terminal","type":"boolean"},"platform":{"description":"任务所属平台。","title":"Platform","type":"string"},"content_id":{"description":"平台内容 ID。","title":"Content Id","type":"string"},"source_id":{"description":"任务来源 ID。","title":"Source Id","type":"string"},"content_type":{"description":"内容类型。","title":"Content Type","type":"string"},"content_meta":{"$ref":"#/$defs/VideoSpeechTextContentMetaData","description":"作品上下文信息，便于结合转写内容做口播分析。"},"transcript":{"anyOf":[{"$ref":"#/$defs/VideoSpeechTextTranscriptData"},{"type":"null"}],"description":"成功时的口播转文字结果；非终态或失败时为 null。"},"error":{"anyOf":[{"$ref":"#/$defs/VideoSpeechTextErrorData"},{"type":"null"}],"description":"失败或过期时的稳定错误结构；非终态或成功时为 null。"},"next_poll_after_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"建议下次查询前等待的秒数；非终态时可用。","title":"Next Poll After Seconds"},"next_action":{"anyOf":[{"$ref":"#/$defs/VideoSpeechTextNextActionData"},{"type":"null"}],"description":"非终态时的下一步查询信息，包含 get 查询所需参数。"},"message":{"description":"任务状态说明。","title":"Message","type":"string"}},"required":["job_id","status","is_terminal","platform","content_id","source_id","content_type","content_meta","transcript","error","next_poll_after_seconds","next_action","message"],"title":"VideoSpeechTextJobResultData","type":"object"},"example":{"job_id":"tr_1784035200000_demo","status":"succeeded","is_terminal":true,"platform":"douyin","content_id":"7648208200076573925","source_id":"7648208200076573925","content_type":"video","content_meta":{"content_url":"https://www.douyin.com/video/7648208200076573925","title":null,"description":"露营路线和装备分享","duration_ms":83120,"author":{"user_id":"1234567890","name":"社媒研究员","profile_url":"https://www.douyin.com/user/MS4wLjABAAAAVbcQXT1UykaJ9ceFz","avatar_url":"https://example.invalid/avatar.webp"}},"transcript":{"text":"大家好，今天分享一个露营路线和装备清单。","segments":[{"start_ms":0,"end_ms":3200,"text":"大家好，今天分享一个露营路线和装备清单。"}]},"error":null,"next_poll_after_seconds":null,"next_action":null,"message":"口播转文字已完成。"}},"related_mcp_tools":["douyin_get_video_speech_text_job","xhs_get_video_speech_text_job","kuaishou_get_video_speech_text_job","weibo_get_video_speech_text_job","wechat_get_video_speech_text_job","bilibili_get_video_speech_text_job","instagram_get_video_speech_text_job","zhihu_get_video_speech_text_job","x_get_video_speech_text_job","tiktok_get_video_speech_text_job","youtube_get_video_speech_text_job"]}]}]}]}