{"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"],"request_timeout":{"recommended_seconds":60,"description":"建议客户端将请求超时时间设置为至少 60 秒；超时后请勿立即高频重试。"},"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":"按 code=1009 处理未入驻状态；不扣费，不换 ID/链接入口重试。超时、鉴权、余额不足等保留各自错误码。"},{"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_search_images","xhs_search_users","xhs_get_note_detail","xhs_get_topic_notes_by_page_id","xhs_get_note_comments","xhs_get_note_sub_comments","xhs_get_user_id_by_encrypted_user_id","xhs_get_share_info","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","xhs_get_product_review_replies","xhs_get_product_review_reply_replies"]},{"group_id":"pgy","label":"蒲公英相关","english_label":"PGY","operation_ids":["xhs_pgy_get_note_detail","xhs_pgy_get_creator_profile","xhs_pgy_get_creator_notes_performance","xhs_pgy_get_creator_fans_profile","xhs_pgy_get_creator_fans_summary","xhs_pgy_get_creator_commercial_overview","xhs_pgy_get_creator_metrics_trend"]}],"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":"按关键词和筛选条件搜索公开小红书笔记；默认搜索所有类型，设置 note_type=\"image\" 搜索图文笔记，设置 note_type=\"video\" 搜索视频笔记。返回结构化笔记摘要和下一页分页令牌。","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 时间戳；0 表示未知，不应解释为实际发布日期","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，表示未提供视频信息，不代表不是视频；图文为 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 仅限同一工具、关键词和调用方；保持该工具支持的筛选条件不变，不得跨搜索工具复用；items 为空时不要单独据此判断结束。不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。","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_images","platform_id":"xhs","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/xhs/image/search","summary":"搜索小红书图片","description":"按关键词从小红书图片搜索标签获取图片，每项返回图片标识、地址、尺寸及关联笔记信息；同一笔记可返回多张图片。下一页令牌仅表示可尝试续页，不保证下一页有结果。结果按平台相关性排序，不承诺每条标题或正文都包含原词，也不承诺完整召回；需要图文笔记而非单张图片时使用 xhs_search_notes(note_type=\"image\")；需要视频笔记时使用 xhs_search_notes(note_type=\"video\")。","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":"搜索词，可传关键词或短语，例如露营、建筑、穿搭；不要传笔记链接、主页链接、note_id、user_id 或 page_token。","title":"Keyword","type":"string"},"page_token":{"default":"","description":"媒体搜索分页令牌，首次请求留空；仅限同一工具、关键词和调用方，不得跨视频、图片或综合笔记搜索复用。将上一页完整 next_page_token 原样传回，不得截断、修改或自行生成。","title":"Page Token","type":"string"}},"required":["keyword"],"title":"InternalSearchImagesRequest","type":"object"},"example":{"keyword":"露营","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"},"SearchImageItem":{"properties":{"image_id":{"description":"图片标识，用于识别图片和按图片去重；不能作为笔记详情或评论工具的 note_id","title":"Image Id","type":"string"},"image_url":{"description":"当前图片的查看链接","title":"Image Url","type":"string"},"width":{"description":"图片宽度，像素","title":"Width","type":"integer"},"height":{"description":"图片高度，像素","title":"Height","type":"integer"},"note_id":{"description":"note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。同一笔记的多张图片共享 note_id；统计笔记数时按 note_id 去重，笔记互动数不要重复累加。","title":"Note Id","type":"string"},"note_url":{"description":"note_url 是可打开笔记内容所需的完整 URL。任何使用该返回链接的场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得修改、截断、脱敏、规范化、重组，也不得用 note_id 重新拼接链接。","title":"Note Url","type":"string"},"title":{"description":"关联笔记标题","title":"Title","type":"string"},"summary":{"description":"关联笔记摘要；不是全文","title":"Summary","type":"string"},"publish_time_text":{"description":"平台显示的发布时间文本；没有时为空字符串","title":"Publish Time Text","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"},"author":{"$ref":"#/$defs/AuthorSummary","description":"关联笔记作者"}},"required":["image_id","image_url","width","height","note_id","note_url","title","summary","publish_time_text","like_count","collect_count","comment_count","share_count","author"],"title":"SearchImageItem","type":"object"}},"properties":{"items":{"description":"图片列表；同一笔记的多张图片分别返回","items":{"$ref":"#/$defs/SearchImageItem"},"title":"Items","type":"array"},"next_page_token":{"description":"可尝试下一页的不透明分页令牌，不保证下一页有结果；为空表示无法继续翻页。续页保持关键词和调用方不变，并将完整令牌原样传回图片搜索入口。","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":"SearchImagesResult","type":"object"},"example":{"items":[{"note_url":"https://www.xiaohongshu.com/discovery/item/69e71b110000000022029e5e?xsec_source=app_share&xsec_token=CB8LYwuNCmdLCh4IingDx12rfddpSYoSu-dkiRRHnsk6o=","note_id":"69e71b110000000022029e5e","title":"露营装备清单","summary":"适合周末出行的装备组合。","image_id":"example-image-1","image_url":"https://example.invalid/image.webp","width":1280,"height":2276,"like_count":120,"collect_count":35,"comment_count":18,"share_count":4,"publish_time_text":"2025-08-21","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-image-search-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["xhs_search_images"]},{"operation_id":"xhs_search_users","platform_id":"xhs","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/xhs/user/search","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":{"keyword":{"description":"搜索词，可传昵称、账号名或小红书号；不要传主页链接、user_id 或分页令牌。","minLength":1,"title":"Keyword","type":"string"},"page_token":{"default":"","description":"用户搜索分页令牌，首次请求留空；续页保持 keyword 不变，将上一页完整 next_page_token 原样传回，不得截断、修改或自行生成。","title":"Page Token","type":"string"}},"required":["keyword"],"title":"InternalUserSearchRequest","type":"object"},"example":{"keyword":"咖啡","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"UserSearchItem":{"additionalProperties":false,"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"},"red_id":{"description":"小红书号，无值时为空字符串","title":"Red Id","type":"string"},"verified":{"description":"是否官方认证","title":"Verified","type":"boolean"}},"required":["user_id","name","avatar_url","red_id","verified"],"title":"UserSearchItem","type":"object"}},"additionalProperties":false,"properties":{"items":{"description":"搜索到的用户列表","items":{"$ref":"#/$defs/UserSearchItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页分页令牌，为空表示结束；续页保持 keyword 不变并完整原样传回。","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":"UserSearchResult","type":"object"},"example":{"items":[{"user_id":"67c25fdc000000000a03dae1","name":"咖啡日记","avatar_url":"https://example.invalid/avatar.webp","red_id":"coffee_diary","verified":false}],"next_page_token":"opaque-user-search-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["xhs_search_users"]},{"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":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"商品 SPU ID；不要作为商品详情接口入参，也不要作为商品评价接口入参；无法确认时为 null","title":"Spu Id"},"title":{"description":"商品标题","title":"Title","type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"商品搜索展示描述；可能与标题重复或包含规格信息，不保证是完整详情描述；无法确认时为 null","title":"Description"},"image_url":{"description":"商品图片链接","title":"Image Url","type":"string"},"price":{"description":"商品列表展示销售价，单位：元；与商品详情的原价口径不同，不保证是最终实付价","title":"Price","type":"number"},"coupon_price":{"description":"商品列表展示券后/成交价格，单位：元；没有独立券后金额时与 price 相同；不保证是最终实付价","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":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"库存数量；无法确认时为 null，不代表库存为 0","title":"Stock Quantity"},"purchasable":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"是否可购买；无法确认时为 null，不代表不可购买","title":"Purchasable"},"sold_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"已售数量；平台以带“+”的千级或万级文本展示时转换为对应整数下限（如“90.2k+ sold”返回 90200、“已售1.2万+”返回 12000），不是精确销量，须结合 sales_text 解读；缺失或无法解析时为 null，不代表零销量；0 表示明确已售 0。","title":"Sold Count"},"sales_text":{"description":"平台展示的商品销量文本；没有时为空字符串。带“+”的数量表示下限，不是精确销量；结合 sold_count 解读。","title":"Sales Text","type":"string"}},"required":["sku_id","spu_id","title","description","image_url","price","coupon_price","shop_id","shop_name","shop_avatar_url","stock_quantity","purchasable","sold_count","sales_text"],"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,"sales_text":"已售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 或商品链接读取小红书商品详情；sku_id 与 url 必须二选一，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":{"sku_id":{"default":"","description":"小红书商品 SKU ID；用户已提供完整 sku_id 时原样使用，否则可从商品搜索结果复制。与 url 二选一；不要在此字段传 spu_id、商品链接或搜索关键词。","title":"Sku Id","type":"string"},"url":{"default":"","description":"小红书商品详情链接、短链接或包含商品链接的分享文案；与 sku_id 二选一。","title":"Url","type":"string"}},"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":"当前 SKU 的商品原价，单位：元；不是商品搜索的展示销售价，也不是最终实付价","title":"Price","type":"number"},"coupon_price":{"description":"当前 SKU 展示的券后/成交价格，单位：元；不保证是最终实付价","title":"Coupon Price","type":"number"},"sold_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"已售数量；平台以带“+”的千级或万级文本展示时转换为对应整数下限（如“90.2k+ sold”返回 90200、“已售1.2万+”返回 12000），不是精确销量，须结合 sales_text 解读；缺失或无法解析时为 null，不代表零销量；0 表示明确已售 0。","title":"Sold Count"},"sales_text":{"description":"平台展示的商品销量文本；没有时为空字符串。带“+”的数量表示下限，不是精确销量；结合 sold_count 解读。","title":"Sales Text","type":"string"},"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"},"main_images":{"description":"商品顶部主图/轮播图列表","items":{"$ref":"#/$defs/ProductDetailImage"},"title":"Main 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":"商品属性/规格参数列表（name/value），不是可选 SKU 规格组","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","sales_text","stock_status","shop_id","shop_name","shop_avatar_url","main_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,"sales_text":"已售5","stock_status":1,"shop_id":"69d25a8635183b00159be6ef","shop_name":"露营装备店","shop_avatar_url":"https://example.invalid/shop.webp","main_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_by_sku_id","xhs_get_product_detail_by_url"]},{"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_product_review_replies","platform_id":"xhs","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/xhs/product/review/reply/list","summary":"读取小红书商品评价回复","description":"根据 review_id 读取商品评价回复；已有 ID 时直接使用，否则从 xhs_get_product_reviews 返回的 review_id 获取。支持 page_token 翻页，不接受 root_review_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":{"review_id":{"description":"一级商品评价 ID；用户已提供时原样使用，否则可从 xhs_get_product_reviews 的 items[*].review_id 原样复制。不支持 root_review_id。","title":"Review Id","type":"string"},"page_token":{"default":"","description":"商品评价回复分页令牌。首次请求留空；续页时将上一页返回的完整 next_page_token 原样传回。令牌只绑定同一一级评价和调用方，不能跨链路复用。","title":"Page Token","type":"string"}},"required":["review_id"],"title":"InternalProductReviewRepliesRequest","type":"object"},"example":{"review_id":"498254417103766817","page_token":""}},"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"},"ProductReviewMentionedUser":{"additionalProperties":false,"properties":{"user_id":{"description":"被 @ 用户的 user_id；无法获取时为空字符串","title":"User Id","type":"string"},"name":{"description":"被 @ 用户名称；无法获取时为空字符串","title":"Name","type":"string"}},"required":["user_id","name"],"title":"ProductReviewMentionedUser","type":"object"},"ProductReviewReplyItem":{"additionalProperties":false,"properties":{"review_id":{"description":"当前回复自身 ID","title":"Review Id","type":"string"},"root_review_id":{"description":"完整商品评价线程 ID","title":"Root Review Id","type":"string"},"reply_to_review_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"直接回复对象 ID；直接回复一级评价时为 null","title":"Reply To Review Id"},"content":{"description":"回复内容；无法获取时为空字符串","title":"Content","type":"string"},"like_count":{"description":"回复点赞数；无法获取时为 0","title":"Like Count","type":"integer"},"publish_time_text":{"description":"回复时间展示文本；无法获取时为空字符串","title":"Publish Time Text","type":"string"},"ip_location":{"description":"回复 IP 属地；无法获取时为空字符串","title":"Ip Location","type":"string"},"mentioned_users":{"description":"回复正文中 @ 到的用户列表","items":{"$ref":"#/$defs/ProductReviewMentionedUser"},"title":"Mentioned Users","type":"array"},"author":{"$ref":"#/$defs/ProductReviewAuthor","description":"回复作者信息"}},"required":["review_id","root_review_id","reply_to_review_id","content","like_count","publish_time_text","ip_location","mentioned_users","author"],"title":"ProductReviewReplyItem","type":"object"}},"additionalProperties":false,"properties":{"items":{"description":"当前页商品评价回复列表","items":{"$ref":"#/$defs/ProductReviewReplyItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明商品评价回复分页令牌；为空表示没有更多结果或当前无法继续翻页。继续翻页时必须原样传回，只能用于同一一级评价和调用方。","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":"ProductReviewRepliesResult","type":"object"},"example":{"items":[],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["xhs_get_product_review_replies"]},{"operation_id":"xhs_get_product_review_reply_replies","platform_id":"xhs","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/xhs/product/review/reply/reply/list","summary":"读取小红书商品评价嵌套回复","description":"根据 review_id 读取商品评价嵌套回复；已有 ID 时直接使用，否则从 xhs_get_product_review_replies 返回的 review_id 获取。支持 page_token 翻页，不接受 root_review_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":{"review_id":{"description":"商品评价回复 ID；用户已提供时原样使用，否则可从 xhs_get_product_review_replies 的 items[*].review_id 原样复制。不支持 root_review_id。","title":"Review Id","type":"string"},"page_token":{"default":"","description":"商品评价回复的回复分页令牌。首次请求留空；续页时将上一页返回的完整 next_page_token 原样传回。令牌只绑定同一父级回复和调用方，不能跨链路复用。","title":"Page Token","type":"string"}},"required":["review_id"],"title":"InternalProductReviewReplyRepliesRequest","type":"object"},"example":{"review_id":"498254417103766817","page_token":""}},"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"},"ProductReviewMentionedUser":{"additionalProperties":false,"properties":{"user_id":{"description":"被 @ 用户的 user_id；无法获取时为空字符串","title":"User Id","type":"string"},"name":{"description":"被 @ 用户名称；无法获取时为空字符串","title":"Name","type":"string"}},"required":["user_id","name"],"title":"ProductReviewMentionedUser","type":"object"},"ProductReviewReplyItem":{"additionalProperties":false,"properties":{"review_id":{"description":"当前回复自身 ID","title":"Review Id","type":"string"},"root_review_id":{"description":"完整商品评价线程 ID","title":"Root Review Id","type":"string"},"reply_to_review_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"直接回复对象 ID；直接回复一级评价时为 null","title":"Reply To Review Id"},"content":{"description":"回复内容；无法获取时为空字符串","title":"Content","type":"string"},"like_count":{"description":"回复点赞数；无法获取时为 0","title":"Like Count","type":"integer"},"publish_time_text":{"description":"回复时间展示文本；无法获取时为空字符串","title":"Publish Time Text","type":"string"},"ip_location":{"description":"回复 IP 属地；无法获取时为空字符串","title":"Ip Location","type":"string"},"mentioned_users":{"description":"回复正文中 @ 到的用户列表","items":{"$ref":"#/$defs/ProductReviewMentionedUser"},"title":"Mentioned Users","type":"array"},"author":{"$ref":"#/$defs/ProductReviewAuthor","description":"回复作者信息"}},"required":["review_id","root_review_id","reply_to_review_id","content","like_count","publish_time_text","ip_location","mentioned_users","author"],"title":"ProductReviewReplyItem","type":"object"}},"additionalProperties":false,"properties":{"items":{"description":"当前页商品评价回复的回复列表","items":{"$ref":"#/$defs/ProductReviewReplyItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明商品评价回复的回复分页令牌；为空表示没有更多结果或当前无法继续翻页。继续翻页时必须原样传回，只能用于同一父级回复和调用方。","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":"ProductReviewReplyRepliesResult","type":"object"},"example":{"items":[],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["xhs_get_product_review_reply_replies"]},{"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 或小红书笔记链接、短链接、分享文案读取蒲公英单篇笔记商业增强详情，返回正文、图片或视频摘要、作者、曝光量、阅读量、点赞、收藏、评论、分享和创作者图文/视频合作报价（单位：人民币元；不是当前笔记的成交金额；零值不表示免费合作）。这是蒲公英商业口径数据，不等同普通公开笔记详情；只支持查询单篇笔记，不支持博主全量笔记汇总。仅适用于已入驻蒲公英博主的笔记；note_id 与 note_url 必须且只能提供一个。查询明确无商业合作数据时按博主未入驻处理，HTTP 200 返回 code=1009；不要换 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"}},"required":["image_url","width","height"],"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":"静态图片明细；不包含 Live 图视频摘要，需要 Live 视频时使用普通笔记详情接口","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}],"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_pgy_get_creator_profile","platform_id":"xhs","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/xhs/pgy/creator/profile","summary":"读取小红书蒲公英创作者档案","description":"根据完整 user_id 查询蒲公英创作者资料、粉丝数、商业笔记数、合作行业、近 30 天合作笔记数、笔记阅读与互动中位数、内容分类、特征标签和创作者图文/视频合作报价。普通账号资料使用用户信息接口；创作者笔记表现使用蒲公英创作者笔记表现工具；粉丝画像使用蒲公英创作者粉丝画像接口；指标随日期变化使用创作者指标趋势接口。HTTP 和 MCP 成功都直接返回档案字段和 points，不包 data。成功调用扣减 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":{"user_id":{"description":"小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。","pattern":"^[0-9a-f]{24}$","title":"User Id","type":"string"}},"required":["user_id"],"title":"PgyCreatorProfileRequest","type":"object"},"example":{"user_id":"67c25fdc000000000a03dae1"}},"response":{"content_type":"application/json","schema":{"$defs":{"PgyContentCategory":{"additionalProperties":false,"properties":{"category":{"description":"一级内容分类","title":"Category","type":"string"},"subcategories":{"description":"二级内容分类；明确无二级分类时为空数组","items":{"type":"string"},"title":"Subcategories","type":"array"}},"required":["category","subcategories"],"title":"PgyContentCategory","type":"object"}},"additionalProperties":false,"properties":{"user_id":{"description":"小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。","pattern":"^[0-9a-f]{24}$","title":"User Id","type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"创作者昵称；上游未提供时为 null","title":"Name"},"red_id":{"description":"公开小红书号；缺失时为空字符串，不能作为 user_id 使用","title":"Red Id","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"头像地址；缺失时为 null","title":"Avatar Url"},"profile_url":{"description":"由 user_id 生成的用户主页地址","title":"Profile Url","type":"string"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"创作者资料所在地，不是 IP 属地；缺失时为 null","title":"Location"},"gender":{"anyOf":[{"enum":["male","female"],"type":"string"},{"type":"null"}],"description":"创作者性别：male 表示男，female 表示女；无法确认时为 null","title":"Gender","x-socialdatax-enum-labels":{"male":"男","female":"女"}},"follower_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"蒲公英口径粉丝数，单位人；未知时为 null","title":"Follower Count"},"business_note_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"商业笔记数；未知时为 null","title":"Business Note Count"},"cooperation_industries":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"合作行业名称列表；未知时为 null，明确为空时为 []","title":"Cooperation Industries"},"cooperation_note_count_30d":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"近 30 天合作笔记数；未知时为 null","title":"Cooperation Note Count 30D"},"note_read_median":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"蒲公英口径笔记阅读数中位数；未知时为 null","title":"Note Read Median"},"received_like_and_collect_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"获赞与收藏合计；不能拆算为独立点赞数或收藏数；未知时为 null","title":"Received Like And Collect Count"},"note_interaction_median":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"蒲公英口径笔记互动数中位数；具体互动构成以上游口径为准；未知时为 null","title":"Note Interaction Median"},"content_categories":{"anyOf":[{"items":{"$ref":"#/$defs/PgyContentCategory"},"type":"array"},{"type":"null"}],"description":"内容分类；未知时为 null，明确为空时为 []","title":"Content Categories"},"feature_tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"创作者特征标签；不是主页标签；未知时为 null，明确为空时为 []","title":"Feature Tags"},"picture_price":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"description":"创作者图文笔记合作报价，单位：人民币元；未知时为 null，零值不表示免费合作","title":"Picture Price"},"video_price":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"description":"创作者视频笔记合作报价，单位：人民币元；未知时为 null，零值不表示免费合作","title":"Video Price"},"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","red_id","avatar_url","profile_url","location","gender","follower_count","business_note_count","cooperation_industries","cooperation_note_count_30d","note_read_median","received_like_and_collect_count","note_interaction_median","content_categories","feature_tags","picture_price","video_price","points"],"title":"PgyCreatorProfile","type":"object"},"example":{"user_id":"67c25fdc000000000a03dae1","name":"示例创作者","red_id":"26752930781","avatar_url":"https://example.invalid/avatar.jpg","profile_url":"https://www.xiaohongshu.com/user/profile/67c25fdc000000000a03dae1","location":"湖北 武汉 江夏区","gender":"female","follower_count":3048,"business_note_count":225,"cooperation_industries":["3c及电器","日用百货","母婴","食品饮料","服装配饰","医疗健康","美妆个护"],"cooperation_note_count_30d":18,"note_read_median":1279,"received_like_and_collect_count":116911,"note_interaction_median":237,"content_categories":[{"category":"健康养生","subcategories":[]}],"feature_tags":["测评","油皮"],"picture_price":150.0,"video_price":150.0,"points":{"cost":20,"balance":980}}},"related_mcp_tools":["xhs_pgy_get_creator_profile"]},{"operation_id":"xhs_pgy_get_creator_notes_performance","platform_id":"xhs","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/xhs/pgy/creator/notes/performance","summary":"读取蒲公英创作者笔记表现","description":"根据 user_id 和 note_scope 读取日常或合作笔记数量、曝光/阅读/互动中位数、互动率、视频完播率、图文 3 秒阅读率、内容标签和最近笔记明细。固定近30日、图文＋视频、全流量，不支持自选日期或笔记类型；明细最多 15 篇，不是全量列表。仅 notes[] 内的笔记级 *_benchmark_rate 表示相较于平台中位数的相对差异，允许负数和超过 1，不是排名比例；汇总层同名字段仍是平台返回的 0 到 1 对比值，计算方式未公开，不能混用。商业汇总与成本参考使用商业概览接口。HTTP 和 MCP 成功响应都直接返回业务字段和 points，不包 data。成功调用扣减 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":{"user_id":{"description":"小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。","pattern":"^[0-9a-f]{24}$","title":"User Id","type":"string"},"note_scope":{"default":"daily","description":"笔记统计口径：日常笔记选 daily（默认，不是按天汇总）；商单或品牌合作笔记选 cooperation。固定近30日、图文＋视频、全流量；输出回显口径","enum":["daily","cooperation"],"title":"Note Scope","type":"string"}},"required":["user_id"],"title":"PgyCreatorNotesPerformanceRequest","type":"object"},"example":{"user_id":"67c25fdc000000000a03dae1"}},"response":{"content_type":"application/json","schema":{"$defs":{"PgyNoteContentTag":{"additionalProperties":false,"properties":{"tag":{"description":"笔记内容标签","title":"Tag","type":"string"},"ratio":{"description":"该内容标签占比，0.1 表示 10%","maximum":1,"minimum":0,"title":"Ratio","type":"number"}},"required":["tag","ratio"],"title":"PgyNoteContentTag","type":"object"},"PgyNotePerformanceItem":{"additionalProperties":false,"properties":{"note_id":{"description":"小红书笔记 ID。必须原样使用完整 note_id；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。","pattern":"^[0-9a-f]{24}$","title":"Note Id","type":"string"},"publish_date":{"anyOf":[{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},{"type":"null"}],"description":"发布日期（YYYY-MM-DD）；上游未提供时为 null","title":"Publish Date"},"note_type":{"anyOf":[{"enum":["image","video"],"type":"string"},{"type":"null"}],"description":"笔记类型：image 表示图文，video 表示视频；未知时为 null","title":"Note Type","x-socialdatax-enum-labels":{"image":"图文","video":"视频"}},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"笔记缩略图地址；缺失时为 null","title":"Thumbnail Url"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"笔记标题；缺失时为 null","title":"Title"},"impression_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"笔记曝光量；未知时为 null","title":"Impression Count"},"impression_benchmark_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"笔记该指标相较于平台中位数的相对差异；0 表示持平，-0.5 表示低于 50%，1.282 表示高于 128.2%，允许负数和超过 1；不是排名或百分位。保留平台口径，不可用返回计数自行复算；未知时为 null","title":"Impression Benchmark Rate"},"read_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"笔记阅读量；未知时为 null","title":"Read Count"},"read_benchmark_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"笔记该指标相较于平台中位数的相对差异；0 表示持平，-0.5 表示低于 50%，1.282 表示高于 128.2%，允许负数和超过 1；不是排名或百分位。保留平台口径，不可用返回计数自行复算；未知时为 null","title":"Read Benchmark Rate"},"interaction_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"蒲公英口径综合互动量；具体构成以上游口径为准；未知时为 null","title":"Interaction Count"},"interaction_benchmark_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"笔记该指标相较于平台中位数的相对差异；0 表示持平，-0.5 表示低于 50%，1.282 表示高于 128.2%，允许负数和超过 1；不是排名或百分位。保留平台口径，不可用返回计数自行复算；未知时为 null","title":"Interaction Benchmark Rate"},"collect_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"笔记收藏量；未知时为 null","title":"Collect Count"},"like_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"笔记点赞量；未知时为 null","title":"Like Count"},"collect_benchmark_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"笔记该指标相较于平台中位数的相对差异；0 表示持平，-0.5 表示低于 50%，1.282 表示高于 128.2%，允许负数和超过 1；不是排名或百分位。保留平台口径，不可用返回计数自行复算；未知时为 null","title":"Collect Benchmark Rate"},"like_benchmark_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"笔记该指标相较于平台中位数的相对差异；0 表示持平，-0.5 表示低于 50%，1.282 表示高于 128.2%，允许负数和超过 1；不是排名或百分位。保留平台口径，不可用返回计数自行复算；未知时为 null","title":"Like Benchmark Rate"}},"required":["note_id","publish_date","note_type","thumbnail_url","title","impression_count","impression_benchmark_rate","read_count","read_benchmark_rate","interaction_count","interaction_benchmark_rate","collect_count","like_count","collect_benchmark_rate","like_benchmark_rate"],"title":"PgyNotePerformanceItem","type":"object"}},"additionalProperties":false,"properties":{"user_id":{"description":"小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。","pattern":"^[0-9a-f]{24}$","title":"User Id","type":"string"},"note_scope":{"description":"笔记统计口径：日常笔记选 daily（默认，不是按天汇总）；商单或品牌合作笔记选 cooperation。固定近30日、图文＋视频、全流量；输出回显口径","enum":["daily","cooperation"],"title":"Note Scope","type":"string"},"note_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"统计范围内笔记数；未知时为 null","title":"Note Count"},"video_note_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"统计范围内视频笔记数；未知时为 null","title":"Video Note Count"},"hundred_like_ratio":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"description":"获赞不少于 100 的笔记占比，0.1 表示 10%；未知时为 null","title":"Hundred Like Ratio"},"thousand_like_ratio":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"description":"获赞不少于 1000 的笔记占比，0.1 表示 10%；未知时为 null","title":"Thousand Like Ratio"},"content_tags":{"anyOf":[{"items":{"$ref":"#/$defs/PgyNoteContentTag"},"type":"array"},{"type":"null"}],"description":"笔记内容标签分布；返回标签不保证覆盖全部内容，占比之和不保证为 1；不要自行归一化或补齐其他类别；未知时为 null，明确为空时为 []","title":"Content Tags"},"impression_median":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"笔记曝光量中位数；未知时为 null","title":"Impression Median"},"impression_benchmark_rate":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"description":"平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null","title":"Impression Benchmark Rate"},"read_median":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"笔记阅读量中位数；未知时为 null","title":"Read Median"},"read_benchmark_rate":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"description":"平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null","title":"Read Benchmark Rate"},"interaction_median":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"平台汇总口径的笔记互动量中位数；不保证与 notes[].interaction_count 的统计口径一致，不可直接用返回的笔记明细复算；未知时为 null","title":"Interaction Median"},"interaction_rate":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"description":"平台返回的笔记互动率，0.195 表示 19.5%；本响应未提供可确认的计算分母和完整统计口径，不可用返回计数自行复算；未知时为 null","title":"Interaction Rate"},"interaction_benchmark_rate":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"description":"平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null","title":"Interaction Benchmark Rate"},"like_median":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"笔记点赞量中位数；未知时为 null","title":"Like Median"},"collect_median":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"笔记收藏量中位数；未知时为 null","title":"Collect Median"},"comment_median":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"笔记评论量中位数；未知时为 null","title":"Comment Median"},"share_median":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"笔记分享量中位数；未知时为 null","title":"Share Median"},"video_full_view_rate":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"description":"视频完播率，0.195 表示 19.5%；仅在 video_note_count 大于 0 时用于表现判断；否则 0 值不表示完播率为 0%；未知时为 null","title":"Video Full View Rate"},"video_full_view_benchmark_rate":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"description":"平台返回的视频完播指标对比值，范围 0~1；仅在 video_note_count 大于 0 时用于表现判断；否则 0 值不表示表现为 0；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null","title":"Video Full View Benchmark Rate"},"image_3s_view_rate":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"description":"图文笔记 3 秒阅读率，0.195 表示 19.5%；仅在统计范围内有图文笔记时用于表现判断；否则 0 值不表示 3 秒阅读率为 0%；未知时为 null","title":"Image 3S View Rate"},"notes":{"anyOf":[{"items":{"$ref":"#/$defs/PgyNotePerformanceItem"},"type":"array"},{"type":"null"}],"description":"统计范围内最近发布的最多 15 篇笔记表现明细，不是全量列表；未知时为 null，明确为空时为 []","title":"Notes"},"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","note_scope","note_count","video_note_count","hundred_like_ratio","thousand_like_ratio","content_tags","impression_median","impression_benchmark_rate","read_median","read_benchmark_rate","interaction_median","interaction_rate","interaction_benchmark_rate","like_median","collect_median","comment_median","share_median","video_full_view_rate","video_full_view_benchmark_rate","image_3s_view_rate","notes","points"],"title":"PgyCreatorNotesPerformance","type":"object"},"example":{"user_id":"67c25fdc000000000a03dae1","note_scope":"daily","note_count":1,"video_note_count":0,"hundred_like_ratio":1.0,"thousand_like_ratio":0.0,"content_tags":[{"tag":"护肤","ratio":1.0}],"impression_median":12437,"impression_benchmark_rate":0.97,"read_median":1279,"read_benchmark_rate":0.952,"interaction_median":237,"interaction_rate":0.195,"interaction_benchmark_rate":0.984,"like_median":146,"collect_median":91,"comment_median":0,"share_median":12,"video_full_view_rate":0.0,"video_full_view_benchmark_rate":0.0,"image_3s_view_rate":1.0,"notes":[{"note_id":"6aa63fb9000000000b00d8e5","publish_date":"2026-09-13","note_type":"image","thumbnail_url":"https://example.invalid/note.jpg","title":"温柔肤感，是简单的护肤仪式感","impression_count":12437,"impression_benchmark_rate":0.0,"read_count":1279,"read_benchmark_rate":0.0,"interaction_count":249,"interaction_benchmark_rate":0.05,"collect_count":91,"like_count":146,"collect_benchmark_rate":0.0,"like_benchmark_rate":0.0}],"points":{"cost":20,"balance":980}}},"related_mcp_tools":["xhs_pgy_get_creator_notes_performance"]},{"operation_id":"xhs_pgy_get_creator_fans_profile","platform_id":"xhs","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/xhs/pgy/creator/fans/profile","summary":"读取蒲公英创作者粉丝画像","description":"根据完整 user_id 读取粉丝年龄、性别、地域、城市、兴趣和设备品牌分布及数据日期。比例为 0 到 1 的小数；各分布不保证完整或互斥，不归一化、不补其他类别、不推算人数。使用平台默认统计范围，不支持指定日期。粉丝规模、增长和活跃情况使用粉丝汇总接口；创作者资料和报价使用档案接口。HTTP 和 MCP 成功直接返回画像字段和 points，不包 data。成功调用扣减 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":{"user_id":{"description":"小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。","pattern":"^[0-9a-f]{24}$","title":"User Id","type":"string"}},"required":["user_id"],"title":"PgyCreatorRequest","type":"object"},"example":{"user_id":"67c25fdc000000000a03dae1"}},"response":{"content_type":"application/json","schema":{"$defs":{"PgyFansDeviceDistributionItem":{"additionalProperties":false,"properties":{"name":{"description":"平台返回的设备品牌名称；不是设备型号","title":"Name","type":"string"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"设备品牌展示名称；未知时为 null","title":"Display Name"},"ratio":{"description":"平台返回的占比，0.1 表示 10%；不按已返回品牌重新归一化","maximum":1,"minimum":0,"title":"Ratio","type":"number"}},"required":["name","display_name","ratio"],"title":"PgyFansDeviceDistributionItem","type":"object"},"PgyFansDistributionItem":{"additionalProperties":false,"properties":{"label":{"description":"平台返回的分类标签；原样保留，不重新划分类别","title":"Label","type":"string"},"ratio":{"description":"平台返回的占比，0.1 表示 10%；不按已返回分类重新归一化","maximum":1,"minimum":0,"title":"Ratio","type":"number"}},"required":["label","ratio"],"title":"PgyFansDistributionItem","type":"object"},"PgyFansGenderDistribution":{"additionalProperties":false,"properties":{"male_ratio":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"description":"男性粉丝占比，0.1 表示 10%；未知时为 null","title":"Male Ratio"},"female_ratio":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"description":"女性粉丝占比，0.1 表示 10%；未知时为 null","title":"Female Ratio"}},"required":["male_ratio","female_ratio"],"title":"PgyFansGenderDistribution","type":"object"}},"additionalProperties":false,"properties":{"user_id":{"description":"小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。","pattern":"^[0-9a-f]{24}$","title":"User Id","type":"string"},"data_date":{"anyOf":[{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},{"type":"null"}],"description":"平台标注的数据日期（YYYY-MM-DD），不代表查询时间或统计起止范围；未知时为 null","title":"Data Date"},"age_distribution":{"anyOf":[{"items":{"$ref":"#/$defs/PgyFansDistributionItem"},"type":"array"},{"type":"null"}],"description":"粉丝年龄分布；保留平台年龄区间标签，不推断端点含义；不保证完整，未知时为 null，明确为空时为 []","title":"Age Distribution"},"gender_distribution":{"anyOf":[{"$ref":"#/$defs/PgyFansGenderDistribution"},{"type":"null"}],"description":"粉丝性别分布；不推算缺失占比，未知时为 null"},"interest_distribution":{"anyOf":[{"items":{"$ref":"#/$defs/PgyFansDistributionItem"},"type":"array"},{"type":"null"}],"description":"粉丝兴趣分布；不保证分类完整或互斥，不用占比之和推算其他兴趣；未知时为 null，明确为空时为 []","title":"Interest Distribution"},"region_distribution":{"anyOf":[{"items":{"$ref":"#/$defs/PgyFansDistributionItem"},"type":"array"},{"type":"null"}],"description":"粉丝地域分布；标签可包含省份、中国、海外等，不统一视为省份；不保证完整，未知时为 null，明确为空时为 []","title":"Region Distribution"},"city_distribution":{"anyOf":[{"items":{"$ref":"#/$defs/PgyFansDistributionItem"},"type":"array"},{"type":"null"}],"description":"平台返回的粉丝城市分布；不保证列出全部城市，不重新归一化或补其他；未知时为 null，明确为空时为 []","title":"City Distribution"},"device_distribution":{"anyOf":[{"items":{"$ref":"#/$defs/PgyFansDeviceDistributionItem"},"type":"array"},{"type":"null"}],"description":"粉丝设备品牌分布；不保证列出全部品牌，不重新归一化或补其他；未知时为 null，明确为空时为 []","title":"Device Distribution"},"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","data_date","age_distribution","gender_distribution","interest_distribution","region_distribution","city_distribution","device_distribution","points"],"title":"PgyCreatorFansProfile","type":"object"},"example":{"user_id":"67c25fdc000000000a03dae1","data_date":"2026-09-18","age_distribution":[{"label":"18-24","ratio":0.1934398654331371}],"gender_distribution":{"male_ratio":0.16989066442388562,"female_ratio":0.8301093355761143},"interest_distribution":[{"label":"美食","ratio":0.09759016916693265}],"region_distribution":[{"label":"广东","ratio":0.12964969302997473}],"city_distribution":[{"label":"北京","ratio":0.05236547490068617}],"device_distribution":[{"name":"apple inc.","display_name":"苹果","ratio":0.39039364391477066}],"points":{"cost":20,"balance":980}}},"related_mcp_tools":["xhs_pgy_get_creator_fans_profile"]},{"operation_id":"xhs_pgy_get_creator_fans_summary","platform_id":"xhs","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/xhs/pgy/creator/fans/summary","summary":"读取蒲公英创作者粉丝汇总","description":"根据完整 user_id 获取蒲公英粉丝总数、平台增长指标、活跃、阅读和互动粉丝人数及占比。粉丝构成使用粉丝画像接口。仅接受 user_id，不支持指定日期或统计周期；增长周期及统计窗口截止日期未提供，不能按查询日期推算。保留平台比例精度，不用人数复算占比，不将不同人群相加。HTTP/MCP 成功直接返回汇总字段和 points，不包 data。成功调用扣减 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":{"user_id":{"description":"小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。","pattern":"^[0-9a-f]{24}$","title":"User Id","type":"string"}},"required":["user_id"],"title":"PgyCreatorRequest","type":"object"},"example":{"user_id":"67c25fdc000000000a03dae1"}},"response":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"user_id":{"description":"小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。","pattern":"^[0-9a-f]{24}$","title":"User Id","type":"string"},"follower_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"蒲公英口径粉丝总数，单位人；未知时为 null","title":"Follower Count"},"follower_growth_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"平台返回的粉丝增长数量；统计周期及是否扣除流失未明确，不可直接解释为近 30 天新增关注人数或净增人数；未知时为 null","title":"Follower Growth Count"},"follower_growth_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"平台返回的粉丝增长率，0.1 表示 10%；不是粉丝构成占比，不限于 0–1。统计周期和计算基数未明确，不用返回人数复算；未知时为 null","title":"Follower Growth Rate"},"active_follower_count_28d":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"平台 28 天统计窗口内的活跃粉丝数，单位人；截止日期未提供，不能按本次查询日期推算起止日期；活跃判定按平台口径，不等同阅读或互动人数；活跃、阅读、互动人数不能假定互斥，不可相加作为总人数；未知时为 null","title":"Active Follower Count 28D"},"active_follower_ratio":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"description":"平台返回的活跃粉丝占比，0.419 表示 41.9%；保留平台精度，分母及统计周期未确认，不能沿用相邻人数字段的 28/30 天周期，不用返回人数复算；未知时为 null","title":"Active Follower Ratio"},"engaged_follower_count_30d":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"平台 30 天统计窗口内的互动粉丝数，单位人；截止日期未提供，不能按本次查询日期推算起止日期；不是互动次数，具体互动构成按平台口径；活跃、阅读、互动人数不能假定互斥，不可相加作为总人数；未知时为 null","title":"Engaged Follower Count 30D"},"engaged_follower_ratio":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"description":"平台返回的互动粉丝占比，0.1 表示 10%；保留平台精度，0 不表示互动人数一定为 0；分母及统计周期未确认，不能沿用相邻人数字段的 28/30 天周期，不用返回人数复算；未知时为 null","title":"Engaged Follower Ratio"},"read_follower_count_30d":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"平台 30 天统计窗口内的阅读粉丝数，单位人；截止日期未提供，不能按本次查询日期推算起止日期；不是阅读次数；活跃、阅读、互动人数不能假定互斥，不可相加作为总人数；未知时为 null","title":"Read Follower Count 30D"},"read_follower_ratio":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"description":"平台返回的阅读粉丝占比，0.001 表示 0.1%；保留平台精度，分母及统计周期未确认，不能沿用相邻人数字段的 28/30 天周期，不用返回人数复算；未知时为 null","title":"Read Follower Ratio"},"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","follower_count","follower_growth_count","follower_growth_rate","active_follower_count_28d","active_follower_ratio","engaged_follower_count_30d","engaged_follower_ratio","read_follower_count_30d","read_follower_ratio","points"],"title":"PgyCreatorFansSummary","type":"object"},"example":{"user_id":"67c25fdc000000000a03dae1","follower_count":3048,"follower_growth_count":1,"follower_growth_rate":0.0,"active_follower_count_28d":1277,"active_follower_ratio":0.419,"engaged_follower_count_30d":1,"engaged_follower_ratio":0.0,"read_follower_count_30d":3,"read_follower_ratio":0.001,"points":{"cost":20,"balance":980}}},"related_mcp_tools":["xhs_pgy_get_creator_fans_summary"]},{"operation_id":"xhs_pgy_get_creator_metrics_trend","platform_id":"xhs","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/xhs/pgy/creator/metrics/trend","summary":"获取蒲公英创作者指标趋势","description":"观察曝光、阅读、互动中位数及预估成本随日期变化时使用。中位数按 note_scope 选择日常或合作笔记，固定图文＋视频、近30日、全流量，不支持自选日期。合作口径包含进店指标，日常口径的进店字段为 null；输出回显口径，不能混用。指标不是每日新增量或累计总量，不可跨日期求和；缺失日期不补零。历史点的具体滚动窗口未明确。成本估算口径见字段说明，不代表实际成交成本；按图文/视频拆分的成本及商业汇总使用商业概览工具，逐篇表现使用笔记表现工具。成功直接返回业务字段及 points，不包 data；成功扣 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":{"user_id":{"description":"小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。","pattern":"^[0-9a-f]{24}$","title":"User Id","type":"string"},"note_scope":{"default":"daily","description":"笔记统计口径：日常笔记趋势选 daily（默认，不是按天汇总）；合作笔记或进店趋势选 cooperation。输出回显口径，不可混用；成本估算依据见各字段说明","enum":["daily","cooperation"],"title":"Note Scope","type":"string"}},"required":["user_id"],"title":"PgyCreatorMetricsTrendRequest","type":"object"},"example":{"user_id":"67c25fdc000000000a03dae1"}},"response":{"content_type":"application/json","schema":{"$defs":{"PgyCreatorMetricsTrendItem":{"additionalProperties":false,"properties":{"date":{"description":"平台指标日期（YYYY-MM-DD），不是查询日期；历史点的具体滚动窗口未明确","pattern":"^\\d{4}-\\d{2}-\\d{2}$","title":"Date","type":"string"},"impression_median":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"该日期对应的笔记曝光量中位数；不是当日新增或累计总量，不可跨日期求和；未知时为 null","title":"Impression Median"},"read_median":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"该日期对应的笔记阅读量中位数；不是当日新增或累计总量，不可跨日期求和；未知时为 null","title":"Read Median"},"interaction_median":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"该日期对应的笔记互动量中位数；不是当日新增或累计总量，不可跨日期求和；未知时为 null","title":"Interaction Median"},"estimated_cpm":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}],"description":"该日期对应的预估千次曝光成本，单位元/千次曝光；daily 结合报价及近30日日常和合作笔记的自然流量曝光中位数估算，cooperation 结合近30日合作笔记价格和曝光量估算；不按本响应中位数反算报价，仅供参考，不是实际成交成本；零值或缺失时为 null，不表示免费","title":"Estimated Cpm"},"estimated_interaction_cost":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}],"description":"该日期对应的预估单次互动成本，单位元/互动；daily 结合报价及近30日日常和合作笔记的互动中位数估算，cooperation 结合近30日合作笔记价格和互动量估算；不按本响应中位数反算报价，仅供参考，不是实际成交成本；零值或缺失时为 null，不表示免费","title":"Estimated Interaction Cost"},"estimated_read_cost":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}],"description":"该日期对应的预估单次阅读成本，单位元/阅读；daily 结合报价及近30日日常和合作笔记的自然流量阅读中位数估算，cooperation 结合近30日合作笔记价格和阅读量估算；不按本响应中位数反算报价，仅供参考，不是实际成交成本；零值或缺失时为 null，不表示免费","title":"Estimated Read Cost"},"outbound_store_visit_median":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"该日期对应的合作笔记外溢进店量中位数，不是进店总人数、订单或成交量；仅 cooperation 返回，真实0保留，daily 或未知时为 null；不能与进店成本反算价格或人数","title":"Outbound Store Visit Median"},"estimated_store_visit_cost":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}],"description":"该日期对应的预估进店成本，单位元/进店；结合近30日跨域（小红星/小红盟等）合作笔记价格与跨域进店UV计算，仅供参考，不是实际成交成本或ROI；仅 cooperation 返回，daily、零值或缺失时为 null；进店中位数为0时仍可能有有效成本","title":"Estimated Store Visit Cost"}},"required":["date","impression_median","read_median","interaction_median","estimated_cpm","estimated_interaction_cost","estimated_read_cost","outbound_store_visit_median","estimated_store_visit_cost"],"title":"PgyCreatorMetricsTrendItem","type":"object"}},"additionalProperties":false,"properties":{"user_id":{"description":"小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。","pattern":"^[0-9a-f]{24}$","title":"User Id","type":"string"},"note_scope":{"description":"笔记统计口径：日常笔记趋势选 daily（默认，不是按天汇总）；合作笔记或进店趋势选 cooperation。输出回显口径，不可混用；成本估算依据见各字段说明","enum":["daily","cooperation"],"title":"Note Scope","type":"string"},"summary":{"anyOf":[{"$ref":"#/$defs/PgyCreatorMetricsTrendItem"},{"type":"null"}],"description":"平台提供的概览指标及其日期，不是趋势各点之和；缺失时为 null"},"items":{"anyOf":[{"items":{"$ref":"#/$defs/PgyCreatorMetricsTrendItem"},"type":"array"},{"type":"null"}],"description":"平台返回的日期序列；中位数按 note_scope 选择日常或合作笔记，固定图文＋视频、近30日、全流量，成本口径见各字段说明；可能缺少日期，不补零、不插值；未知时为 null，明确为空时为 []","title":"Items"},"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","note_scope","summary","items","points"],"title":"PgyCreatorMetricsTrend","type":"object"},"example":{"user_id":"67c25fdc000000000a03dae1","note_scope":"daily","summary":{"date":"2026-09-18","impression_median":12437,"read_median":1279,"interaction_median":249,"estimated_cpm":12.060786363270886,"estimated_interaction_cost":0.6024096385542169,"estimated_read_cost":null,"outbound_store_visit_median":null,"estimated_store_visit_cost":null},"items":[{"date":"2026-09-17","impression_median":12422,"read_median":1277,"interaction_median":248,"estimated_cpm":12.075350185155369,"estimated_interaction_cost":0.6048387096774194,"estimated_read_cost":null,"outbound_store_visit_median":null,"estimated_store_visit_cost":null},{"date":"2026-09-18","impression_median":12437,"read_median":1279,"interaction_median":249,"estimated_cpm":12.060786363270886,"estimated_interaction_cost":0.6024096385542169,"estimated_read_cost":null,"outbound_store_visit_median":null,"estimated_store_visit_cost":null}],"points":{"cost":20,"balance":980}}},"related_mcp_tools":["xhs_pgy_get_creator_metrics_trend"]},{"operation_id":"xhs_pgy_get_creator_commercial_overview","platform_id":"xhs","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/xhs/pgy/creator/commercial/overview","summary":"读取蒲公英创作者商业概览","description":"读取笔记规模和中位数、服务表现、增长、平台标签、预估成本及对比值。仅接受完整 user_id 和 note_scope：日常内容选 daily（默认，不是按天汇总），商单、品牌合作笔记或外溢进店选 cooperation；输出回显口径；不是对全部字段统一筛选，note_count 不能解释为所选口径的笔记数。本接口只返回汇总，不返回逐篇明细。逐篇表现使用创作者笔记表现接口，也可选择日常或合作口径。合作口径才返回外溢进店指标，日常口径对应字段为 null。两种口径的成本估计依据不同，不代表实际成交成本或ROI。统计截止日期未提供，不支持指定日期；进店不等于订单或成交，不据此推断调用方自己的投放成绩。HTTP/MCP 成功直接返回业务字段及 points，不包 data；成功扣 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":{"user_id":{"description":"小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。","pattern":"^[0-9a-f]{24}$","title":"User Id","type":"string"},"note_scope":{"default":"daily","description":"笔记统计口径：查看日常内容表现选 daily（默认），不是按天汇总；查看商单、品牌合作笔记或外溢进店表现选 cooperation；输出回显实际口径，不能混用；不表示所有字段均按此口径拆分，note_count 等字段按各自说明解读","enum":["daily","cooperation"],"title":"Note Scope","type":"string"}},"required":["user_id"],"title":"PgyCreatorCommercialOverviewRequest","type":"object"},"example":{"user_id":"67c25fdc000000000a03dae1","note_scope":"cooperation"}},"response":{"content_type":"application/json","schema":{"$defs":{"PgyNoteContentTag":{"additionalProperties":false,"properties":{"tag":{"description":"笔记内容标签","title":"Tag","type":"string"},"ratio":{"description":"该内容标签占比，0.1 表示 10%","maximum":1,"minimum":0,"title":"Ratio","type":"number"}},"required":["tag","ratio"],"title":"PgyNoteContentTag","type":"object"}},"additionalProperties":false,"properties":{"user_id":{"description":"小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。","pattern":"^[0-9a-f]{24}$","title":"User Id","type":"string"},"note_scope":{"description":"笔记统计口径：查看日常内容表现选 daily（默认），不是按天汇总；查看商单、品牌合作笔记或外溢进店表现选 cooperation；输出回显实际口径，不能混用；不表示所有字段均按此口径拆分，note_count 等字段按各自说明解读","enum":["daily","cooperation"],"title":"Note Scope","type":"string"},"data_date":{"anyOf":[{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},{"type":"null"}],"description":"平台标注的数据日期（YYYY-MM-DD）；不代表查询时间或各指标统计截止日期；未知时为 null","title":"Data Date"},"invitation_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"平台返回的邀约数量；统计周期、邀约方向及状态范围未明确，不等于成交或成功合作数量；未知时为 null","title":"Invitation Count"},"response_rate":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"description":"历史邀约合作消息在 48 小时内回复的比例，0.852 表示 85.2%；48 小时是回复时限，不是统计周期；累计周期和完整分母未提供，不用邀约数推算回复次数；邀约数不足 3 时不用于评价回复表现，不视为合作接受率；未知时为 null","title":"Response Rate"},"active_days_7d":{"anyOf":[{"maximum":7,"minimum":0,"type":"integer"},{"type":"null"}],"description":"平台 7 天统计窗口内登录小红书 App 的天数；截止日期未提供，不按查询日期或 data_date 推算起止日期，不等同发布笔记天数；未知时为 null","title":"Active Days 7D"},"industry_labels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"平台 30 天窗口内 TOP2 合作品牌行业；原样保留，不代表全部行业或具体品牌合作清单，不保证与创作者档案同口径；未知时为 null，明确为空时为 []","title":"Industry Labels"},"note_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"平台 30 天窗口内发布笔记数；不能因 note_scope=daily/cooperation 就解释为日常/合作笔记数量，不作为所选口径中位数的样本数量；不代表全部历史，截止日期未提供；未知时为 null","title":"Note Count"},"read_median":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"平台 30 天窗口内所选口径笔记的阅读量中位数，不是累计阅读量；截止日期未提供，不用其他接口明细复算；未知时为 null","title":"Read Median"},"interaction_median":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"平台 30 天窗口内所选口径笔记的互动量中位数，不是累计互动量；截止日期未提供，互动构成按平台口径，不用其他接口明细复算；未知时为 null","title":"Interaction Median"},"content_tags":{"anyOf":[{"items":{"$ref":"#/$defs/PgyNoteContentTag"},"type":"array"},{"type":"null"}],"description":"平台 30 天窗口发布笔记的 TOP2 内容类目及笔记数量占比；不代表完整分布，不归一化或补其他，不保证与笔记表现接口同口径；未知时为 null，明确为空时为 []","title":"Content Tags"},"commercial_label":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"平台给出的商业标签原文，仅作平台评价展示，不作为独立评价结论；未知时为 null","title":"Commercial Label"},"commercial_label_description":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"平台商业标签说明原文；涉及排名或比较的文字仅代表平台说法，不提取为独立排名或百分位数值；未知时为 null","title":"Commercial Label Description"},"follower_growth_rate_30d":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"平台 30 天统计窗口的粉丝增长率，0.1 表示 10%；不是构成占比，不限于 0–1。截止日期和计算基数未提供，不按查询日期或 data_date 推算窗口，不与其他周期增长率混用；未知时为 null","title":"Follower Growth Rate 30D"},"read_benchmark_rate":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"description":"平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应平台 30 天窗口的所选口径笔记中位数，不保证与笔记表现接口同口径","title":"Read Benchmark Rate"},"interaction_benchmark_rate":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"description":"平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应平台 30 天窗口的所选口径笔记中位数，不保证与笔记表现接口同口径","title":"Interaction Benchmark Rate"},"follower_growth_benchmark_rate_30d":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"description":"平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应平台 30 天粉丝增长指标，窗口截止日期未提供；不是实际粉丝增长率","title":"Follower Growth Benchmark Rate 30D"},"impression_median":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"平台 30 天窗口内所选口径笔记的曝光量中位数，不是累计曝光量；截止日期未提供，不用其他接口明细复算；未知时为 null","title":"Impression Median"},"impression_benchmark_rate":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"description":"平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应平台 30 天窗口的所选口径笔记曝光中位数，不保证与笔记表现接口同口径","title":"Impression Benchmark Rate"},"estimated_picture_cpm":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}],"description":"平台预估图文 CPM，单位人民币元/千次曝光；daily 根据报价与相关笔记中位数预估，cooperation 根据近30天合作笔记价格和表现估计；不按本响应的中位数自行复算，不是实际成交成本或效果承诺；无法预估、未知或零值时为 null","title":"Estimated Picture Cpm"},"estimated_video_cpm":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}],"description":"平台预估视频 CPM，单位人民币元/千次曝光；daily 根据报价与相关笔记中位数预估，cooperation 根据近30天合作笔记价格和表现估计；不按本响应的中位数自行复算，不是实际成交成本或效果承诺；无法预估、未知或零值时为 null","title":"Estimated Video Cpm"},"estimated_picture_read_cost":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}],"description":"平台预估图文阅读单价，单位人民币元/次阅读；daily 根据报价与相关笔记中位数预估，cooperation 根据近30天合作笔记价格和表现估计；不按本响应的中位数自行复算，不是实际成交成本或效果承诺；无法预估、未知或零值时为 null","title":"Estimated Picture Read Cost"},"estimated_video_read_cost":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}],"description":"平台预估视频阅读单价，单位人民币元/次阅读；daily 根据报价与相关笔记中位数预估，cooperation 根据近30天合作笔记价格和表现估计；不按本响应的中位数自行复算，不是实际成交成本或效果承诺；无法预估、未知或零值时为 null","title":"Estimated Video Read Cost"},"estimated_picture_interaction_cost":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}],"description":"平台预估图文互动单价，单位人民币元/次互动；daily 根据报价与相关笔记中位数预估，cooperation 根据近30天合作笔记价格和表现估计；不按本响应的中位数自行复算，不是实际成交成本或效果承诺；无法预估、未知或零值时为 null","title":"Estimated Picture Interaction Cost"},"estimated_video_interaction_cost":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}],"description":"平台预估视频互动单价，单位人民币元/次互动；daily 根据报价与相关笔记中位数预估，cooperation 根据近30天合作笔记价格和表现估计；不按本响应的中位数自行复算，不是实际成交成本或效果承诺；无法预估、未知或零值时为 null","title":"Estimated Video Interaction Cost"},"estimated_picture_cpm_benchmark_rate":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"description":"平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估图文 CPM，不是实际成本或 ROI；相应预估成本不可用时为 null","title":"Estimated Picture Cpm Benchmark Rate"},"estimated_video_cpm_benchmark_rate":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"description":"平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估视频 CPM，不是实际成本或 ROI；相应预估成本不可用时为 null","title":"Estimated Video Cpm Benchmark Rate"},"estimated_picture_read_cost_benchmark_rate":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"description":"平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估图文阅读单价，不是实际成本或 ROI；相应预估成本不可用时为 null","title":"Estimated Picture Read Cost Benchmark Rate"},"estimated_video_read_cost_benchmark_rate":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"description":"平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估视频阅读单价，不是实际成本或 ROI；相应预估成本不可用时为 null","title":"Estimated Video Read Cost Benchmark Rate"},"estimated_picture_interaction_cost_benchmark_rate":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"description":"平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估图文互动单价，不是实际成本或 ROI；相应预估成本不可用时为 null","title":"Estimated Picture Interaction Cost Benchmark Rate"},"estimated_video_interaction_cost_benchmark_rate":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"description":"平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估视频互动单价，不是实际成本或 ROI；相应预估成本不可用时为 null","title":"Estimated Video Interaction Cost Benchmark Rate"},"outbound_store_visit_median":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"平台30天合作笔记范围内的外溢进店量中位数；不是累计人数、订单数或成交额，窗口截止日未明确；daily 或未知时为 null","title":"Outbound Store Visit Median"},"outbound_store_visit_benchmark_rate":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"description":"平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应合作笔记外溢进店中位数；daily 时为 null","title":"Outbound Store Visit Benchmark Rate"},"estimated_picture_store_visit_cost":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}],"description":"平台预估图文外溢进店单价，人民币元/进店；依据近30天跨域合作笔记价格及进店UV估计，不是成交成本或ROI；daily、不可预估、零值或未知时为 null","title":"Estimated Picture Store Visit Cost"},"estimated_video_store_visit_cost":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}],"description":"平台预估视频外溢进店单价，人民币元/进店；依据近30天跨域合作笔记价格及进店UV估计，不是成交成本或ROI；daily、不可预估、零值或未知时为 null","title":"Estimated Video Store Visit Cost"},"estimated_picture_store_visit_cost_benchmark_rate":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"description":"平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估图文进店单价，不是实际成本或ROI；daily 或对应成本不可用时为 null","title":"Estimated Picture Store Visit Cost Benchmark Rate"},"estimated_video_store_visit_cost_benchmark_rate":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"description":"平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null；对应预估视频进店单价，不是实际成本或ROI；daily 或对应成本不可用时为 null","title":"Estimated Video Store Visit Cost Benchmark Rate"},"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","note_scope","data_date","invitation_count","response_rate","active_days_7d","industry_labels","note_count","read_median","interaction_median","content_tags","commercial_label","commercial_label_description","follower_growth_rate_30d","read_benchmark_rate","interaction_benchmark_rate","follower_growth_benchmark_rate_30d","impression_median","impression_benchmark_rate","estimated_picture_cpm","estimated_video_cpm","estimated_picture_read_cost","estimated_video_read_cost","estimated_picture_interaction_cost","estimated_video_interaction_cost","estimated_picture_cpm_benchmark_rate","estimated_video_cpm_benchmark_rate","estimated_picture_read_cost_benchmark_rate","estimated_video_read_cost_benchmark_rate","estimated_picture_interaction_cost_benchmark_rate","estimated_video_interaction_cost_benchmark_rate","outbound_store_visit_median","outbound_store_visit_benchmark_rate","estimated_picture_store_visit_cost","estimated_video_store_visit_cost","estimated_picture_store_visit_cost_benchmark_rate","estimated_video_store_visit_cost_benchmark_rate","points"],"title":"PgyCreatorCommercialOverview","type":"object"},"example":{"user_id":"67c25fdc000000000a03dae1","note_scope":"cooperation","data_date":"2026-09-27","invitation_count":29,"response_rate":0.862,"active_days_7d":6,"industry_labels":["服装配饰","美妆个护"],"note_count":13,"read_median":1990,"interaction_median":446,"content_tags":[{"tag":"个人护理","ratio":0.231},{"tag":"护肤","ratio":0.231}],"commercial_label":null,"commercial_label_description":null,"follower_growth_rate_30d":0.0,"read_benchmark_rate":0.7221,"interaction_benchmark_rate":0.8841,"follower_growth_benchmark_rate_30d":0.0,"impression_median":13336,"impression_benchmark_rate":0.6515,"estimated_picture_cpm":16.179051408239943,"estimated_video_cpm":107.15601488648697,"estimated_picture_read_cost":0.43116965907345317,"estimated_video_read_cost":2.127061997745379,"estimated_picture_interaction_cost":0.6241767431545259,"estimated_video_interaction_cost":17.370382047300343,"estimated_picture_cpm_benchmark_rate":0.6216,"estimated_video_cpm_benchmark_rate":0.1201,"estimated_picture_read_cost_benchmark_rate":0.6983,"estimated_video_read_cost_benchmark_rate":0.2031,"estimated_picture_interaction_cost_benchmark_rate":0.7615,"estimated_video_interaction_cost_benchmark_rate":0.066,"outbound_store_visit_median":1,"outbound_store_visit_benchmark_rate":0.4821,"estimated_picture_store_visit_cost":5.096140707973625,"estimated_video_store_visit_cost":null,"estimated_picture_store_visit_cost_benchmark_rate":0.4503,"estimated_video_store_visit_cost_benchmark_rate":null,"points":{"cost":20,"balance":980}}},"related_mcp_tools":["xhs_pgy_get_creator_commercial_overview"]},{"operation_id":"xhs_get_user_id_by_encrypted_user_id","platform_id":"xhs","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/xhs/user/id/decrypt","summary":"解析小红书加密用户 ID","description":"根据完整加密用户 ID 获取稳定 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":{"encrypted_user_id":{"description":"小红书加密用户 ID。用户已提供时直接原样使用；请传入完整 29 位小写十六进制值；不要传 24 位 user_id、小红书号、昵称或主页链接","title":"Encrypted User Id","type":"string"}},"required":["encrypted_user_id"],"title":"InternalUserIdDecryptRequest","type":"object"},"example":{"encrypted_user_id":"a01513967364874bd9aeb7131a293"}},"response":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"user_id":{"description":"稳定用户 user_id","title":"User Id","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","points"],"title":"UserIdDecryptData","type":"object"},"example":{"user_id":"5c8c53570000000011003f64","points":{"cost":10,"balance":990}}},"related_mcp_tools":["xhs_get_user_id_by_encrypted_user_id"]},{"operation_id":"xhs_get_share_info","platform_id":"xhs","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/xhs/share/info","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":{"share_text":{"description":"小红书笔记分享短链接，或包含该链接的完整分享文案。","minLength":1,"title":"Share Text","type":"string"}},"required":["share_text"],"title":"ShareInfoRequest","type":"object"},"example":{"share_text":"https://xhslink.cn/o/example"}},"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"},"ShareNoteInfo":{"additionalProperties":false,"properties":{"note_id":{"description":"小红书笔记 ID。必须原样使用完整 note_id；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。","title":"Note Id","type":"string"},"note_type":{"anyOf":[{"enum":["image","video"],"type":"string"},{"type":"null"}],"description":"笔记类型；上游类型未识别时为 null","title":"Note Type","x-socialdatax-enum-labels":{"image":"图文","video":"视频"}},"summary":{"description":"分享信息中的笔记摘要；缺失时为空字符串","title":"Summary","type":"string"},"cover_image_url":{"description":"笔记封面链接；缺失时为空字符串","title":"Cover Image Url","type":"string"},"author":{"anyOf":[{"$ref":"#/$defs/BaseAuthorSummary"},{"type":"null"}],"description":"笔记作者；缺失时为 null"}},"required":["note_id","note_type","summary","cover_image_url","author"],"title":"ShareNoteInfo","type":"object"},"ShareUserInfo":{"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":"ShareUserInfo","type":"object"}},"additionalProperties":false,"properties":{"share_user_info":{"anyOf":[{"$ref":"#/$defs/ShareUserInfo"},{"type":"null"}],"description":"该链接的分享人；缺失时为 null"},"note_info":{"anyOf":[{"$ref":"#/$defs/ShareNoteInfo"},{"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":["share_user_info","note_info","points"],"title":"ShareInfoData","type":"object"},"example":{"share_user_info":{"user_id":"67c25fdc000000000a03dae1","name":"分享用户","avatar_url":"https://example.invalid/sharer.webp","profile_url":null},"note_info":{"note_id":"69e71b110000000022029e5e","note_type":"image","summary":"两步复刻6款热门奶茶！宅家实现奶茶自由","cover_image_url":"https://example.invalid/cover.webp","author":{"user_id":"ae33373e21b0ef7d235fa646c95b7","name":"奶茶研究员","avatar_url":null,"profile_url":null}},"points":{"cost":10,"balance":990}}},"related_mcp_tools":["xhs_get_share_info"]},{"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"},"referenced_notes":{"description":"评论中引用的笔记信息；无引用笔记时为空数组","items":{"$ref":"#/$defs/ReferencedNote"},"title":"Referenced Notes","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","referenced_notes","publish_time","like_count","reply_count","parent_comment_id","is_pinned","is_author_comment","ip_location","author"],"title":"NoteCommentItem","type":"object"},"ReferencedNote":{"properties":{"note_id":{"description":"小红书笔记 ID。必须原样使用完整 note_id；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。","title":"Note Id","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":"视频"}}},"required":["note_id","title","note_type"],"title":"ReferencedNote","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":[],"referenced_notes":[],"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"},"referenced_notes":{"description":"评论中引用的笔记信息；无引用笔记时为空数组","items":{"$ref":"#/$defs/ReferencedNote"},"title":"Referenced Notes","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","referenced_notes","publish_time","like_count","reply_count","parent_comment_id","is_pinned","is_author_comment","ip_location","author"],"title":"NoteCommentItem","type":"object"},"ReferencedNote":{"properties":{"note_id":{"description":"小红书笔记 ID。必须原样使用完整 note_id；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。","title":"Note Id","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":"视频"}}},"required":["note_id","title","note_type"],"title":"ReferencedNote","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":[],"referenced_notes":[],"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_images","xhs_search_users","xhs_search_products","xhs_get_product_detail","xhs_get_product_reviews","xhs_get_product_review_replies","xhs_get_product_review_reply_replies","xhs_get_note_detail","xhs_pgy_get_note_detail","xhs_pgy_get_creator_profile","xhs_pgy_get_creator_notes_performance","xhs_pgy_get_creator_fans_profile","xhs_pgy_get_creator_fans_summary","xhs_pgy_get_creator_metrics_trend","xhs_pgy_get_creator_commercial_overview","xhs_get_user_id_by_encrypted_user_id","xhs_get_share_info","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_suggestions","platform_id":"douyin","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/douyin/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":{"description":"用于获取普通搜索输入框联想词的搜索词","title":"Keyword","type":"string"}},"required":["keyword"],"title":"PublicSearchSuggestionsRequest","type":"object"},"example":{"keyword":"露营"}},"response":{"content_type":"application/json","schema":{"$defs":{"DouyinSearchSuggestionItemData":{"additionalProperties":false,"properties":{"text":{"description":"普通搜索输入框中的联想词","title":"Text","type":"string"}},"required":["text"],"title":"DouyinSearchSuggestionItemData","type":"object"}},"additionalProperties":false,"properties":{"items":{"description":"联想词列表","items":{"$ref":"#/$defs/DouyinSearchSuggestionItemData"},"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":"DouyinSearchSuggestionsResult","type":"object"},"example":{"items":[{"text":"露营地"}],"points":{"cost":10,"balance":990}}},"related_mcp_tools":["douyin_search_suggestions"]},{"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_product_detail","platform_id":"douyin","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/douyin/product/detail","summary":"读取抖音商品详情","description":"根据完整 product_id 或抖音商品短链接、商品页面链接、分享文案读取商品详情；已有 ID 时无需先搜索，返回价格、店铺、商品图片、详情图、保障、物流和规格信息。product_id 与 url 二选一；不接受 sku_id 或搜索关键词。商品已删除时返回 HTTP 200、业务 code=1008，错误文案为“当前商品已删除。”；请停止对同一商品自动重试，并确认商品是否仍可访问或更换商品 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":{"product_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"抖音商品 ID；用户已提供完整商品 ID 时原样使用，无需先搜索；否则从商品搜索结果的 product_id 原样复制。与 url 二选一；不接受 sku_id 或搜索关键词。","title":"Product Id"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"抖音商品短链接、商品页面链接或包含商品链接的分享文案；与 product_id 二选一","title":"Url"}},"title":"InternalProductDetailRequest","type":"object"},"example":{"product_id":"3838200348212854845"}},"response":{"content_type":"application/json","schema":{"$defs":{"DouyinProductDetailImageData":{"additionalProperties":false,"properties":{"image_url":{"description":"商品图片链接","title":"Image Url","type":"string"},"width":{"description":"平台返回的图片宽度","title":"Width","type":"number"},"height":{"description":"平台返回的图片高度","title":"Height","type":"number"}},"required":["image_url","width","height"],"title":"DouyinProductDetailImageData","type":"object"},"DouyinProductShippingData":{"additionalProperties":false,"properties":{"fee":{"description":"运费展示文本；没有运费信息时为空字符串","title":"Fee","type":"string"},"text":{"description":"发货说明；没有发货说明时为空字符串","title":"Text","type":"string"}},"required":["fee","text"],"title":"DouyinProductShippingData","type":"object"},"DouyinProductVariantGroupData":{"additionalProperties":false,"properties":{"name":{"description":"规格组名称","title":"Name","type":"string"},"options":{"description":"规格选项列表","items":{"$ref":"#/$defs/DouyinProductVariantOptionData"},"title":"Options","type":"array"}},"required":["name","options"],"title":"DouyinProductVariantGroupData","type":"object"},"DouyinProductVariantOptionData":{"additionalProperties":false,"properties":{"spec_id":{"description":"规格选项 ID，不是 SKU ID，不能用作商品详情查询的 product_id","title":"Spec Id","type":"string"},"name":{"description":"规格选项名称","title":"Name","type":"string"}},"required":["spec_id","name"],"title":"DouyinProductVariantOptionData","type":"object"}},"additionalProperties":false,"properties":{"product_id":{"description":"商品 ID；可直接使用商品搜索结果中的 product_id","title":"Product Id","type":"string"},"title":{"description":"商品标题","title":"Title","type":"string"},"price":{"description":"商品起售价，单位：元；不是指定 SKU 的价格，也不保证是最终实付价","title":"Price","type":"number"},"discount_price":{"description":"优惠后起售价，单位：元；不限定为券后价，也不保证是最终实付价；没有单独优惠价时与 price 相同","title":"Discount Price","type":"number"},"sales_text":{"description":"平台展示的商品销量文本；没有时为空字符串；带“+”的数量表示下限，不是精确销量","title":"Sales Text","type":"string"},"sold_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"从销量文本解析的已售数量；不带“+”的万级展示数量换算为整数（如已售 1.5万返回 15000），不代表精确销量，须结合 sales_text 解读；缺失或无法解析时为 null，不代表零销量；0 表示明确已售 0","title":"Sold Count"},"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"},"main_images":{"description":"商品顶部主图/轮播图列表；空列表表示当前未返回对应图片","items":{"$ref":"#/$defs/DouyinProductDetailImageData"},"title":"Main Images","type":"array"},"detail_images":{"description":"商品详情图列表；空列表表示当前未返回对应图片","items":{"$ref":"#/$defs/DouyinProductDetailImageData"},"title":"Detail Images","type":"array"},"assurances":{"description":"商品保障服务列表；空列表表示当前未返回保障信息，不代表商品没有保障服务","items":{"type":"string"},"title":"Assurances","type":"array"},"shipping":{"$ref":"#/$defs/DouyinProductShippingData","description":"发货信息；不包含发货地"},"variant_groups":{"description":"可选商品规格组（name/options），不是商品属性参数或已选 SKU；空列表表示当前未返回规格信息，不代表商品只有一种规格","items":{"$ref":"#/$defs/DouyinProductVariantGroupData"},"title":"Variant Groups","type":"array"},"on_sale":{"description":"商品当前是否在售；不等同于指定 SKU 有库存或当前用户可购买","title":"On Sale","type":"boolean"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["product_id","title","price","discount_price","sales_text","sold_count","shop_id","shop_name","shop_avatar_url","main_images","detail_images","assurances","shipping","variant_groups","on_sale","points"],"title":"DouyinProductDetailResult","type":"object"},"example":{"product_id":"3838200348212854845","title":"每日坚果混合坚果礼盒","price":8.33,"discount_price":3.33,"sales_text":"已售 178","sold_count":178,"shop_id":"123207101","shop_name":"零食优选店","shop_avatar_url":"https://example.invalid/shop.webp","main_images":[{"image_url":"https://example.invalid/product.webp","width":800,"height":800}],"detail_images":[{"image_url":"https://example.invalid/detail.webp","width":750,"height":1000}],"assurances":["7 天无理由退货"],"shipping":{"text":"48 小时内发货","fee":"包邮"},"variant_groups":[{"name":"规格","options":[{"spec_id":"1","name":"默认规格"}]}],"on_sale":true,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["douyin_get_product_detail_by_product_id","douyin_get_product_detail_by_url"]},{"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_share_link","platform_id":"douyin","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/douyin/video/share/link","summary":"生成抖音作品分享链接","description":"按 aweme_id 或作品页面链接、短链接、分享文案生成抖音分享短链接和完整分享文案。aweme_id 与 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":{"aweme_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"抖音作品 ID，与 url 二选一。","title":"Aweme Id"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"作品页面链接、短链接或包含作品链接的分享文案，与 aweme_id 二选一。","title":"Url"}},"title":"DouyinShareLinkRequest","type":"object"},"example":{"aweme_id":"7648208200076573925"}},"response":{"content_type":"application/json","schema":{"properties":{"share_text":{"description":"包含短链接的完整分享文案，可复制分享。","title":"Share Text","type":"string"},"short_url":{"description":"抖音作品分享短链接。","title":"Short Url","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":["share_text","short_url","points"],"title":"DouyinShareLinkData","type":"object"},"example":{"share_text":"复制打开抖音，看看作品 https://v.douyin.com/example/","short_url":"https://v.douyin.com/example/","points":{"cost":10,"balance":990}}},"related_mcp_tools":["douyin_get_video_share_link_by_aweme_id","douyin_get_video_share_link_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。"}},"title":"PublicVideoCommentsRequest","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"},"douyin_follower_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"抖音单端粉丝数；当前不可用时为 null","title":"Douyin Follower Count"},"cross_platform_follower_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"关联平台合计粉丝数；当前不可用时为 null","title":"Cross Platform Follower Count"},"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":{"is_pinned":{"default":false,"description":"是否为用户主页置顶作品。","title":"Is Pinned","type":"boolean"},"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,"is_pinned":false}],"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_suggestions","douyin_search_videos","douyin_search_users","douyin_search_products","douyin_get_product_detail","douyin_get_video_detail","douyin_get_video_share_link","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 提供用户搜索、作品搜索、作品详情、作品一级评论、评论回复、作者信息和用户作品列表；用户搜索按关键词返回用户公开资料并支持 page_token 分页；作品搜索可返回视频和图片作品，支持 content_type 筛选和 page_token 分页；详情按搜索结果 share_url 或作品页面链接读取；评论可按 post_id 或作品页面链接读取，回复按 post_id、一级评论 comment_id 与 page_token 分页读取；作者信息和用户作品列表可按 tiktok_id 或用户主页链接读取。支持按关键词获取搜索框联想词，不支持建议分页。","operations":[{"operation_id":"tiktok_search_suggestions","platform_id":"tiktok","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/tiktok/search/suggestions","summary":"获取 TikTok 搜索建议","description":"获取 TikTok 搜索框的联想词，不返回视频或用户详情，不支持分页。可将返回的 text 用于作品搜索；已有明确搜索词时可直接搜索作品。已有视频或用户链接时使用对应详情接口。","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":"非空搜索关键词或短语，例如 camping、美食；不要传视频链接、用户链接、ID 或分页令牌。","minLength":1,"pattern":".*\\S.*","title":"Keyword","type":"string"}},"required":["keyword"],"title":"TikTokSearchSuggestionsRequest","type":"object"},"example":{"keyword":"food"}},"response":{"content_type":"application/json","schema":{"$defs":{"TikTokSearchSuggestionItem":{"properties":{"text":{"description":"TikTok 搜索框联想词。","minLength":1,"title":"Text","type":"string"}},"required":["text"],"title":"TikTokSearchSuggestionItem","type":"object"}},"properties":{"items":{"description":"搜索建议列表，保持返回顺序；没有匹配建议时为空数组。","items":{"$ref":"#/$defs/TikTokSearchSuggestionItem"},"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":"TikTokSearchSuggestionsResult","type":"object"},"example":{"items":[{"text":"food recipes"}],"points":{"cost":10,"balance":990}}},"related_mcp_tools":["tiktok_search_suggestions"]},{"operation_id":"tiktok_search_users","platform_id":"tiktok","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/tiktok/user/search","summary":"搜索 TikTok 用户","description":"按非空搜索词搜索 TikTok 用户，返回公开用户资料与下一页分页令牌；按用户名、昵称或品牌名查找候选用户；搜索结果不提供 private_account、following_count 和 posted_content_count，省略这些字段；需要时可通过用户资料接口查询；已知准确账号且只需其资料或作品时，使用相应用户接口，无需先搜索；结果中非空的 items[*].tiktok_id 可直接作为后续用户接口输入；非空的 items[*].profile_url 也可直接作为后续用户接口输入。","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":"keyword 为非空搜索词，可传用户名、账号名、昵称、品牌名或机构名，例如 teamtrump、campinglife；不要传用户主页链接、作品链接、用户数字 ID、post_id 或分页令牌 page_token。","minLength":1,"pattern":".*\\S.*","title":"Keyword","type":"string"},"page_token":{"default":"","description":"用户搜索请求分页令牌是不透明令牌。请求的 page_token 为空字符串表示首页；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；不能修改、截断、脱敏、格式化、重组，也不能跨关键词或不同请求链路复用。","title":"Page Token","type":"string"}},"required":["keyword"],"title":"TikTokUserSearchRequest","type":"object"},"example":{"keyword":"camping","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"TikTokPublicUserSearchItem":{"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":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"用户是否为认证账号；未知时省略","title":"Verified"},"private_account":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"用户账号是否为私密账号；true 表示私密，false 表示非私密；当前用户搜索不提供隐私状态，省略该字段，不可据此判断账号是否公开","title":"Private Account"},"follower_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"粉丝数；未知时省略","title":"Follower Count"},"following_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"关注数；用户搜索当前不提供，省略该字段","title":"Following Count"},"received_like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"用户作品累计获赞数；未知时省略","title":"Received Like Count"},"posted_content_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"用户已发布作品数；用户搜索当前不提供，省略该字段","title":"Posted Content Count"}},"required":["user_id","tiktok_id","name","avatar_url","profile_url","bio"],"title":"TikTokPublicUserSearchItem","type":"object"}},"properties":{"items":{"description":"当前页 TikTok 用户搜索结果；没有匹配用户时为空数组；是否继续翻页仅以 next_page_token 是否为空为准","items":{"$ref":"#/$defs/TikTokPublicUserSearchItem"},"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":"TikTokPublicUserSearchResult","type":"object"},"example":{"items":[{"user_id":"134941634731003904","tiktok_id":"campinglife","name":"Camping Life","avatar_url":"https://example.invalid/camping-avatar.jpeg","profile_url":"https://www.tiktok.com/@campinglife","bio":"Camping routes, gear checklists and outdoor tips.","verified":true,"follower_count":2710000,"received_like_count":43600000}],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["tiktok_search_users"]},{"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。","minLength":1,"pattern":".*\\S.*","title":"Keyword","type":"string"},"page_token":{"default":"","description":"请求分页令牌是不透明令牌。请求的 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 为空字符串表示没有更多结果；非空时必须将完整令牌原样作为下一次请求的 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":"请求分页令牌是不透明令牌。请求的 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 为空字符串表示没有更多结果；非空时必须将完整令牌原样作为下一次请求的 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":"请求分页令牌是不透明令牌。请求的 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 为空字符串表示没有更多结果；非空时必须将完整令牌原样作为下一次请求的 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 其中一个。","oneOf":[{"properties":{"tiktok_id":{"type":"string"},"profile_url":{"description":"使用 TikTok 号时省略或传 null。","type":"null"}},"required":["tiktok_id"]},{"properties":{"profile_url":{"description":"非空 TikTok 用户主页链接，例如 https://www.tiktok.com/@teamtrump","type":"string"},"tiktok_id":{"type":"null"}},"required":["profile_url"]}],"properties":{"tiktok_id":{"anyOf":[{"minLength":1,"pattern":".*\\S.*","type":"string"},{"type":"null"}],"default":null,"description":"非空 TikTok 号，即用户主页 @ 后的标识；可使用用户搜索结果中的 TikTok 号，也可使用其他搜索、详情、评论或评论回复结果中 author.tiktok_id 的值；不要带 @，不要传用户主页链接","title":"Tiktok Id"},"profile_url":{"anyOf":[{"minLength":1,"pattern":".*\\S.*","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":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"用户是否为认证账号；未知时省略","title":"Verified"},"private_account":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"用户账号是否为私密账号；未知时省略","title":"Private Account"},"follower_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"粉丝数；未知时省略","title":"Follower Count"},"following_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"关注数；未知时省略","title":"Following Count"},"received_like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"用户作品累计获赞数；未知时省略","title":"Received Like Count"},"posted_content_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"用户已发布作品数；未知时省略","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","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 其中一个。","oneOf":[{"properties":{"tiktok_id":{"type":"string"},"profile_url":{"description":"使用 TikTok 号时省略或传 null。","type":"null"}},"required":["tiktok_id"]},{"properties":{"profile_url":{"description":"非空 TikTok 用户主页链接，例如 https://www.tiktok.com/@teamtrump","type":"string"},"tiktok_id":{"type":"null"}},"required":["profile_url"]}],"properties":{"tiktok_id":{"anyOf":[{"minLength":1,"pattern":".*\\S.*","type":"string"},{"type":"null"}],"default":null,"description":"非空 TikTok 号，即用户主页 @ 后的标识；可使用用户搜索结果中的 TikTok 号，也可使用其他搜索、详情、评论或评论回复结果中 author.tiktok_id 的值；不要带 @，不要传用户主页链接","title":"Tiktok Id"},"profile_url":{"anyOf":[{"minLength":1,"pattern":".*\\S.*","type":"string"},{"type":"null"}],"default":null,"description":"非空 TikTok 用户主页链接，例如 https://www.tiktok.com/@teamtrump","title":"Profile Url"},"page_token":{"default":"","description":"请求分页令牌是不透明令牌。请求的 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":{"is_pinned":{"default":false,"description":"是否为主页置顶作品","title":"Is Pinned","type":"boolean"},"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 为空字符串表示没有更多结果；非空时必须将完整令牌原样作为下一次请求的 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_suggestions","tiktok_search_users","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_suggestions","platform_id":"kuaishou","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/kuaishou/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":"获取快手普通搜索输入框中的联想词，可传关键词或短语；不要传作品链接、用户主页链接、photo_id、user_id 或 page_token。"}},"required":["keyword"],"title":"InternalSearchSuggestionsRequest","type":"object"},"example":{"keyword":"露营"}},"response":{"content_type":"application/json","schema":{"$defs":{"KuaishouSearchSuggestionItemData":{"additionalProperties":false,"properties":{"text":{"description":"普通搜索输入框中的联想词。","title":"Text","type":"string"}},"required":["text"],"title":"KuaishouSearchSuggestionItemData","type":"object"}},"additionalProperties":false,"properties":{"items":{"description":"快手普通搜索输入框中的联想词列表。","items":{"$ref":"#/$defs/KuaishouSearchSuggestionItemData"},"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":"KuaishouSearchSuggestionsResult","type":"object"},"example":{"items":[{"text":"露营装备"}],"points":{"cost":10,"balance":990}}},"related_mcp_tools":["kuaishou_search_suggestions"]},{"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":{"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"},"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":{"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"},"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":"作品作者信息。"},"images":{"description":"图片作品的图集，按原始顺序返回；无图集时为空数组。","items":{"$ref":"#/$defs/KuaishouImageData"},"title":"Images","type":"array"}},"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":"作品作者信息。"},"is_pinned":{"default":false,"description":"是否为用户主页置顶作品。","title":"Is Pinned","type":"boolean"}},"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_suggestions","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_users","platform_id":"bilibili","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/bilibili/user/search","summary":"Bilibili用户搜索","description":"按关键词搜索 Bilibili 用户；已有用户 ID 或主页链接时使用用户资料接口。支持 page_token 翻页。","tags":["内容搜索","Bilibili"],"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 或 page_token。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"首页留空，后续原样传入同一关键词用户搜索返回的 next_page_token，不可跨接口使用。"}},"required":["keyword"],"title":"InternalSearchUsersRequest","type":"object"},"example":{"keyword":"美食"}},"response":{"content_type":"application/json","schema":{"$defs":{"BilibiliUserSearchItemData":{"properties":{"user_id":{"description":"B 站用户 UID；可直接作为用户资料、用户发布视频、专栏或动态列表接口的 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":{"description":"用户主页链接，可用于现有用户资料和用户作品列表接口。","title":"Profile Url","type":"string"},"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"},"verification_label":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"B 站认证说明；没有认证或不可用时为 null。","title":"Verification Label"},"member_level":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"用户 B 站会员等级；不可用时为 null。","title":"Member Level"}},"required":["user_id","name","avatar_url","profile_url","bio","follower_count","posted_video_count","verification_label","member_level"],"title":"BilibiliUserSearchItemData","type":"object"}},"properties":{"items":{"description":"当前页用户搜索结果。","items":{"$ref":"#/$defs/BilibiliUserSearchItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示结束。必须原样传回同一用户搜索入口，不可跨关键词或能力使用。","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":"BilibiliUserSearchResult","type":"object"},"example":{"items":[{"user_id":"1908551987","name":"段小段美食教程","avatar_url":"https://i1.hdslb.com/bfs/face/a25c4459a0b3009cb30f63878cbcb2dfdb2cbd7e.jpg","profile_url":"https://space.bilibili.com/1908551987","bio":"夫唯不争，故天下无能与之争。","follower_count":1572917,"posted_video_count":600,"verification_label":"bilibili 知名美食UP主","member_level":6}],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["bilibili_search_users"]},{"operation_id":"bilibili_search_suggestions","platform_id":"bilibili","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/bilibili/search/suggestions","summary":"Bilibili搜索建议","description":"获取Bilibili搜索输入框联想词；不用于搜索用户或内容。","tags":["内容搜索","Bilibili"],"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 或 page_token。"}},"required":["keyword"],"title":"InternalSearchSuggestionsRequest","type":"object"},"example":{"keyword":"美食"}},"response":{"content_type":"application/json","schema":{"$defs":{"BilibiliSearchSuggestionItemData":{"properties":{"text":{"description":"搜索输入框联想词。","title":"Text","type":"string"}},"required":["text"],"title":"BilibiliSearchSuggestionItemData","type":"object"}},"properties":{"items":{"description":"搜索建议列表。","items":{"$ref":"#/$defs/BilibiliSearchSuggestionItemData"},"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":"BilibiliSearchSuggestionsResult","type":"object"},"example":{"items":[{"text":"美食"}],"points":{"cost":10,"balance":990}}},"related_mcp_tools":["bilibili_search_suggestions"]},{"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_users","bilibili_search_suggestions","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":"微博帖子页面链接、头条文章链接（ttarticle/p/show?id=...）、短链接或包含链接的分享文案；文章详情返回文章正文，评论、点赞和转发使用文章关联的微博帖子；不要传用户主页链接或 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"},"read_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"头条文章页阅读数的数值下界；含‘+’或中文单位时是近似值，非精确阅读量；非头条文章或未提供时为 null。","title":"Read Count"},"read_count_display":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"头条文章页显示的原始阅读数文本，例如‘102万+’；非头条文章或未提供时为 null。","title":"Read Count Display"},"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","read_count","read_count_display","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"},"read_count":null,"read_count_display":null,"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":"微博帖子页面链接、头条文章链接（ttarticle/p/show?id=...）、短链接或包含链接的分享文案；文章详情返回文章正文，评论、点赞和转发使用文章关联的微博帖子；不要传用户主页链接或 post_id。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"微博评论分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；只能用于同一帖子评论分页链路、同一 sort_type，不能跨帖子或排序方式复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"},"sort_type":{"default":"hot","enum":["hot","time_descending"],"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":{"fan_badge":{"anyOf":[{"$ref":"#/$defs/WeiboFanBadgeData"},{"type":"null"}],"description":"评论作者相对于当前帖子作者的粉丝徽章；当前评论未展示徽章或信息无法确认时为 null，不代表该用户一定不是帖子作者的粉丝。"},"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":["fan_badge","post_id","comment_id","content","publish_time","like_count","has_replies","ip_location","image_urls","author"],"title":"WeiboCommentItemData","type":"object"},"WeiboFanBadgeData":{"properties":{"fan_type":{"description":"微博粉丝类型：iron 表示铁粉，gold 表示金粉，diamond 表示钻粉。","enum":["iron","gold","diamond"],"title":"Fan Type","type":"string"},"fan_level":{"description":"微博粉丝徽章等级，为正整数；不要与微博会员等级混淆。","minimum":1,"title":"Fan Level","type":"integer"},"icon_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"粉丝徽章图标链接；不可用时为 null。","title":"Icon Url"}},"required":["fan_type","fan_level","icon_url"],"title":"WeiboFanBadgeData","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","fan_badge":{"fan_type":"iron","fan_level":5,"icon_url":"https://h5.sinaimg.cn/upload/114/962/2022/07/08/member_0_bigfan1_5.png"},"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":{"fan_badge":{"anyOf":[{"$ref":"#/$defs/WeiboFanBadgeData"},{"type":"null"}],"description":"回复作者相对于当前帖子作者的粉丝徽章；当前回复未展示徽章或信息无法确认时为 null，不代表该用户一定不是帖子作者的粉丝。"},"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":["fan_badge","comment_id","content","publish_time","like_count","ip_location","image_urls","author"],"title":"WeiboCommentReplyItemData","type":"object"},"WeiboFanBadgeData":{"properties":{"fan_type":{"description":"微博粉丝类型：iron 表示铁粉，gold 表示金粉，diamond 表示钻粉。","enum":["iron","gold","diamond"],"title":"Fan Type","type":"string"},"fan_level":{"description":"微博粉丝徽章等级，为正整数；不要与微博会员等级混淆。","minimum":1,"title":"Fan Level","type":"integer"},"icon_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"粉丝徽章图标链接；不可用时为 null。","title":"Icon Url"}},"required":["fan_type","fan_level","icon_url"],"title":"WeiboFanBadgeData","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","fan_badge":null,"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":"微博帖子页面链接、头条文章链接（ttarticle/p/show?id=...）、短链接或包含链接的分享文案；文章详情返回文章正文，评论、点赞和转发使用文章关联的微博帖子；不要传用户主页链接或 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":"微博帖子页面链接、头条文章链接（ttarticle/p/show?id=...）、短链接或包含链接的分享文案；文章详情返回文章正文，评论、点赞和转发使用文章关联的微博帖子；不要传用户主页链接或 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"},"verification_label":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"认证说明；不可用时为 null。","title":"Verification Label"},"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","verification_label","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,"verification_label":"微博认证用户","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"},"WeiboTopicTagData":{"additionalProperties":false,"properties":{"name":{"description":"话题标签名称。","title":"Name","type":"string"}},"required":["name"],"title":"WeiboTopicTagData","type":"object"},"WeiboUserPostItemData":{"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。"},"is_pinned":{"default":false,"description":"是否为用户主页置顶微博。","title":"Is Pinned","type":"boolean"}},"required":["post_id","content","publish_time","post_url","like_count","comment_count","repost_count","play_count","image_urls","images","topic_tags","author"],"title":"WeiboUserPostItemData","type":"object"}},"properties":{"items":{"description":"当前页微博用户帖子列表。","items":{"$ref":"#/$defs/WeiboUserPostItemData"},"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"},"is_pinned":false}],"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"]},{"operation_id":"weibo_search_suggestions","platform_id":"weibo","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/weibo/search/suggestions","summary":"获取微博搜索建议","description":"获取微博搜索框的联想词，不返回帖子或用户详情，不支持分页。可将返回的 text 用于帖子搜索；已有明确搜索词时可直接搜索帖子。已有帖子或用户主页链接时使用对应详情接口。","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":"搜索关键词或短语，例如 美食、旅行；不要传帖子链接、用户主页链接、ID 或分页令牌。","minLength":1,"title":"Keyword","type":"string"}},"required":["keyword"],"title":"WeiboSearchSuggestionsRequest","type":"object"},"example":{"keyword":"美食"}},"response":{"content_type":"application/json","schema":{"$defs":{"WeiboSearchSuggestionItem":{"properties":{"text":{"description":"微博搜索框联想词。","minLength":1,"title":"Text","type":"string"}},"required":["text"],"title":"WeiboSearchSuggestionItem","type":"object"}},"properties":{"items":{"description":"搜索建议列表，保持返回顺序；没有匹配建议时为空数组。","items":{"$ref":"#/$defs/WeiboSearchSuggestionItem"},"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":"WeiboSearchSuggestionsResult","type":"object"},"example":{"items":[{"text":"美食图片"}],"points":{"cost":10,"balance":990}}},"related_mcp_tools":["weibo_search_suggestions"]},{"operation_id":"weibo_search_users","platform_id":"weibo","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/weibo/user/search","summary":"搜索微博用户","description":"按关键词搜索微博用户，返回用户标识、名称、头像、主页、粉丝数和认证说明。查找帖子使用帖子搜索；已有 user_id 或主页链接时使用用户详情接口。支持 page_token 翻页，各页结果可能重复；是否结束以 next_page_token 为空为准。","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":"用户搜索词，例如 美食、月半美食记；不要传链接、用户 ID 或分页令牌。","minLength":1,"title":"Keyword","type":"string"},"page_token":{"default":"","description":"首次留空；续页原样传入上一页的 next_page_token，并保持 keyword 不变。","title":"Page Token","type":"string"}},"required":["keyword"],"title":"WeiboSearchUsersRequest","type":"object"},"example":{"keyword":"美食","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"WeiboSearchUserItem":{"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":{"description":"微博用户主页链接。","title":"Profile Url","type":"string"},"follower_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"粉丝数；由展示值换算，可能为近似值；不可用时为 null。","title":"Follower Count"},"verification_label":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"认证说明；不可用时为 null。","title":"Verification Label"}},"required":["user_id","name","avatar_url","profile_url","follower_count","verification_label"],"title":"WeiboSearchUserItem","type":"object"}},"properties":{"items":{"description":"当前页用户列表，保持搜索结果顺序。","items":{"$ref":"#/$defs/WeiboSearchUserItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页令牌；为空表示结束，非空时可原样传回继续翻页。","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":"WeiboSearchUsersResult","type":"object"},"example":{"items":[{"user_id":"2697416452","name":"月半美食记","avatar_url":null,"profile_url":"https://weibo.com/u/2697416452","follower_count":17200000,"verification_label":"知名美食博主"}],"next_page_token":"opaque-weibo-user-search-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["weibo_search_users"]},{"operation_id":"weibo_search_user_suggestions","platform_id":"weibo","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/weibo/user/suggestions","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":{"keyword":{"description":"用户名称或关键词，例如 汽车之家、美食；不要传用户 ID、主页链接或分页令牌。","minLength":1,"title":"Keyword","type":"string"}},"required":["keyword"],"title":"WeiboSearchUserSuggestionsRequest","type":"object"},"example":{"keyword":"美食"}},"response":{"content_type":"application/json","schema":{"$defs":{"WeiboSearchUserSuggestionItem":{"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":{"description":"微博用户主页链接。","title":"Profile Url","type":"string"},"is_live":{"description":"请求时用户是否正在直播；true 表示正在直播，false 表示当前未直播，包含预告尚未开始的情况。","title":"Is Live","type":"boolean"},"bio":{"description":"用户简介；不可用时为空字符串。","title":"Bio","type":"string"},"follower_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"粉丝数；不可用时为 null。","title":"Follower Count"},"verified":{"description":"是否为认证账号。","title":"Verified","type":"boolean"},"verification_label":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"认证说明；不可用时为 null。","title":"Verification Label"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户地区；不可用时为 null。","title":"Location"}},"required":["user_id","name","avatar_url","profile_url","is_live","bio","follower_count","verified","verification_label","location"],"title":"WeiboSearchUserSuggestionItem","type":"object"}},"properties":{"items":{"description":"搜索框用户联想列表，保持返回顺序；没有候选时为空数组。","items":{"$ref":"#/$defs/WeiboSearchUserSuggestionItem"},"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":"WeiboSearchUserSuggestionsResult","type":"object"},"example":{"items":[{"user_id":"2095326403","name":"美食美客DIY","avatar_url":null,"profile_url":"https://weibo.com/u/2095326403","is_live":false,"bio":"自媒体账号，美食分享平台，首批美食红博。♡商家推广、投稿合作请私信。合作推广请联系vx：ldtg2018","follower_count":13817086,"verified":true,"verification_label":"美食博主 美食美客DIY项目组 主任 美食点评团成员","location":"广东"}],"points":{"cost":10,"balance":990}}},"related_mcp_tools":["weibo_search_user_suggestions"]}]},{"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","weibo_search_suggestions","weibo_search_users","weibo_search_user_suggestions"]}]},{"platform_id":"haokan","label":"好看视频","english_label":"Haokan","status":"available","surfaces":[{"surface":"http","status":"available","base_path":"/socialdatax/api/v1/haokan","description":"好看视频详情、视频评论、用户资料、用户发布视频、视频搜索、用户搜索、搜索联想和搜索热词。","operations":[{"operation_id":"haokan_get_comment_replies","platform_id":"haokan","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/haokan/video/comment/reply/list","summary":"读取好看视频评论回复","description":"按视频 ID 或链接（二选一）和一级评论 ID 分页读取回复；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":{"video_id":{"anyOf":[{"pattern":"^[0-9]+$","type":"string"},{"type":"null"}],"default":null,"description":"好看视频数字 ID，以字符串传入，例如 6148991337208256393；可从视频搜索结果的 video_id 获取。与 url 二选一。","title":"Video Id"},"url":{"anyOf":[{"minLength":1,"type":"string"},{"type":"null"}],"default":null,"description":"好看视频页面链接，格式为 https://haokan.baidu.com/v?vid=数字ID，可取视频搜索结果的 share_url。与 video_id 二选一。","title":"Url"},"comment_id":{"description":"所属一级评论 ID，取视频评论列表中的 comment_id；不要传回复自身的 ID。","pattern":"^[1-9][0-9]*$","title":"Comment Id","type":"string"},"page_token":{"default":"","description":"分页令牌，首次留空；续页原样传回 next_page_token，保持同一视频和一级评论。","title":"Page Token","type":"string"}},"required":["comment_id"],"title":"HaokanCommentRepliesRequest","type":"object"},"example":{"video_id":"4648035534327022153","comment_id":"1109730918474277611","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"HaokanCommentAuthor":{"additionalProperties":false,"properties":{"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"好看视频用户标识，可用于用户资料查询；不可用时为 null。","title":"User Id"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"评论作者的好看视频主页链接；不可用时为 null。","title":"Profile Url"},"name":{"description":"评论作者名称。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"评论作者头像；不可用时为 null。","title":"Avatar Url"}},"required":["name","avatar_url"],"title":"HaokanCommentAuthor","type":"object"},"HaokanCommentReplyItem":{"additionalProperties":false,"properties":{"comment_id":{"description":"回复自身的评论 ID。","minLength":1,"title":"Comment Id","type":"string"},"content":{"description":"评论正文，保留表情文字。","title":"Content","type":"string"},"image_urls":{"description":"评论附带的图片或图片表情链接；没有时为空数组。","items":{"type":"string"},"title":"Image Urls","type":"array"},"create_time":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"发布时间，Unix 秒级时间戳；不可用时为 null。","title":"Create Time"},"like_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"点赞数；不可用时为 null。","title":"Like Count"},"author":{"$ref":"#/$defs/HaokanCommentAuthor","description":"评论作者摘要。"},"video_id":{"description":"所属视频 ID。","title":"Video Id","type":"string"},"parent_comment_id":{"description":"所属一级评论 ID。","title":"Parent Comment Id","type":"string"},"reply_to_comment_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"被回复的评论 ID；平台未明确提供时为 null。","title":"Reply To Comment Id"}},"required":["comment_id","content","image_urls","create_time","like_count","author","video_id","parent_comment_id","reply_to_comment_id"],"title":"HaokanCommentReplyItem","type":"object"}},"additionalProperties":false,"properties":{"items":{"description":"当前页评论回复，保持平台返回顺序。","items":{"$ref":"#/$defs/HaokanCommentReplyItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页分页令牌；为空表示没有下一页。","title":"Next Page Token","type":"string"},"reply_count":{"description":"平台返回的该一级评论下的回复总数。","minimum":0,"title":"Reply 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","reply_count","points"],"title":"HaokanCommentRepliesResult","type":"object"},"example":{"items":[],"next_page_token":"","reply_count":0,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["haokan_get_comment_replies_by_video_id","haokan_get_comment_replies_by_url"]},{"operation_id":"haokan_get_video_comments","platform_id":"haokan","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/haokan/video/comment/list","summary":"读取好看视频一级评论","description":"按 video_id 或 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":{"video_id":{"anyOf":[{"pattern":"^[0-9]+$","type":"string"},{"type":"null"}],"default":null,"description":"好看视频数字 ID，以字符串传入，例如 6148991337208256393；可从视频搜索结果的 video_id 获取。与 url 二选一。","title":"Video Id"},"url":{"anyOf":[{"minLength":1,"type":"string"},{"type":"null"}],"default":null,"description":"好看视频页面链接，格式为 https://haokan.baidu.com/v?vid=数字ID，可取视频搜索结果的 share_url。与 video_id 二选一。","title":"Url"},"page_token":{"default":"","description":"分页令牌，首次留空；续页原样传回 next_page_token，保持同一视频。","title":"Page Token","type":"string"}},"title":"HaokanVideoCommentsRequest","type":"object"},"example":{"video_id":"6148991337208256393","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"HaokanCommentAuthor":{"additionalProperties":false,"properties":{"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"好看视频用户标识，可用于用户资料查询；不可用时为 null。","title":"User Id"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"评论作者的好看视频主页链接；不可用时为 null。","title":"Profile Url"},"name":{"description":"评论作者名称。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"评论作者头像；不可用时为 null。","title":"Avatar Url"}},"required":["name","avatar_url"],"title":"HaokanCommentAuthor","type":"object"},"HaokanCommentItem":{"additionalProperties":false,"properties":{"comment_id":{"description":"回复自身的评论 ID。","minLength":1,"title":"Comment Id","type":"string"},"content":{"description":"评论正文，保留表情文字。","title":"Content","type":"string"},"image_urls":{"description":"评论附带的图片或图片表情链接；没有时为空数组。","items":{"type":"string"},"title":"Image Urls","type":"array"},"create_time":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"发布时间，Unix 秒级时间戳；不可用时为 null。","title":"Create Time"},"like_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"点赞数；不可用时为 null。","title":"Like Count"},"author":{"$ref":"#/$defs/HaokanCommentAuthor","description":"评论作者摘要。"},"video_id":{"description":"所属视频 ID。","title":"Video Id","type":"string"},"reply_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"平台展示的回复数量；不可用时为 null。","title":"Reply Count"},"replies":{"description":"随一级评论返回的回复预览，不代表全部回复。","items":{"$ref":"#/$defs/HaokanCommentReply"},"title":"Replies","type":"array"}},"required":["comment_id","content","image_urls","create_time","like_count","author","video_id","reply_count","replies"],"title":"HaokanCommentItem","type":"object"},"HaokanCommentReply":{"additionalProperties":false,"properties":{"comment_id":{"description":"回复自身的评论 ID。","minLength":1,"title":"Comment Id","type":"string"},"content":{"description":"评论正文，保留表情文字。","title":"Content","type":"string"},"image_urls":{"description":"评论附带的图片或图片表情链接；没有时为空数组。","items":{"type":"string"},"title":"Image Urls","type":"array"},"create_time":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"发布时间，Unix 秒级时间戳；不可用时为 null。","title":"Create Time"},"like_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"点赞数；不可用时为 null。","title":"Like Count"},"author":{"$ref":"#/$defs/HaokanCommentAuthor","description":"评论作者摘要。"}},"required":["comment_id","content","image_urls","create_time","like_count","author"],"title":"HaokanCommentReply","type":"object"}},"additionalProperties":false,"properties":{"items":{"description":"当前页一级评论，保持平台顺序。","items":{"$ref":"#/$defs/HaokanCommentItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页分页令牌；为空表示没有下一页。","title":"Next Page Token","type":"string"},"comment_count":{"description":"平台展示的评论总数，不等于当前页一级评论数量。","minimum":0,"title":"Comment 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","comment_count","points"],"title":"HaokanVideoCommentsResult","type":"object"},"example":{"items":[],"next_page_token":"","comment_count":0,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["haokan_get_video_comments_by_video_id","haokan_get_video_comments_by_url"]},{"operation_id":"haokan_get_user_posted_videos","platform_id":"haokan","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/haokan/user/video/list","summary":"读取好看视频用户发布视频","description":"按 user_id 或 profile_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":{"user_id":{"anyOf":[{"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"default":null,"description":"好看视频用户 ID，可取用户搜索结果的 user_id，或视频详情、评论作者的 author.user_id；支持数字和字母数字标识，不要传空值。与 profile_url 二选一。","title":"User Id"},"profile_url":{"anyOf":[{"minLength":1,"type":"string"},{"type":"null"}],"default":null,"description":"好看视频用户主页链接，格式为 https://haokan.baidu.com/author/用户ID，可取用户搜索结果的 profile_url，或视频详情、评论作者的 author.profile_url。与 user_id 二选一。","title":"Profile Url"},"page_token":{"default":"","description":"分页令牌，首次留空；续页原样传回上一页 next_page_token，且保持同一用户。","title":"Page Token","type":"string"}},"title":"HaokanUserPostedVideosRequest","type":"object"},"example":{"user_id":"1608208713901205","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"HaokanUserPostedVideoItem":{"additionalProperties":false,"properties":{"video_id":{"description":"好看视频 ID，以字符串表示。","minLength":1,"title":"Video Id","type":"string"},"title":{"description":"视频标题；不可用时为空字符串。","title":"Title","type":"string"},"share_url":{"description":"视频页面链接。","title":"Share Url","type":"string"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"视频封面链接；不可用时为 null。","title":"Cover Image Url"},"duration_seconds":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"视频时长，单位秒；不可用时为 null。","title":"Duration Seconds"},"publish_time_text":{"description":"发布时间展示文本；不可用时为空字符串。","title":"Publish Time Text","type":"string"},"view_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"平台返回的播放次数；不可用时为 null。","title":"View Count"},"view_count_text":{"description":"播放量展示文本，可能为缩略值；不可用时为空字符串。","title":"View Count Text","type":"string"}},"required":["video_id","title","share_url","cover_image_url","duration_seconds","publish_time_text","view_count","view_count_text"],"title":"HaokanUserPostedVideoItem","type":"object"}},"additionalProperties":false,"properties":{"items":{"description":"当前页用户发布视频，保持平台返回顺序。","items":{"$ref":"#/$defs/HaokanUserPostedVideoItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页分页令牌；为空表示没有下一页，续页需保持同一用户。","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":"HaokanUserPostedVideosResult","type":"object"},"example":{"items":[{"video_id":"12535351339256330380","title":"推荐！这五部经典电影，圣诞节看超有氛围！","share_url":"https://haokan.baidu.com/v?vid=12535351339256330380","cover_image_url":null,"duration_seconds":202,"publish_time_text":"2025年12月29日","view_count":186,"view_count_text":"186次播放"}],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["haokan_get_user_posted_videos_by_user_id","haokan_get_user_posted_videos_by_profile_url"]},{"operation_id":"haokan_get_user_info","platform_id":"haokan","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/haokan/user/info","summary":"获取好看视频用户资料","description":"按 user_id 或 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":{"user_id":{"anyOf":[{"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"default":null,"description":"好看视频用户 ID，可取用户搜索结果的 user_id，或视频详情、评论作者的 author.user_id；支持数字和字母数字标识，不要传空值。与 url 二选一。","title":"User Id"},"url":{"anyOf":[{"minLength":1,"type":"string"},{"type":"null"}],"default":null,"description":"好看视频用户主页链接，格式为 https://haokan.baidu.com/author/用户ID，可取用户搜索结果的 profile_url，或视频详情、评论作者的 author.profile_url。与 user_id 二选一。","title":"Url"}},"title":"HaokanUserInfoRequest","type":"object"},"example":{"user_id":"1550992385283544"}},"response":{"content_type":"application/json","schema":{"additionalProperties":false,"description":"Profile fields shared with user search, read from the author's page.","properties":{"user_id":{"description":"好看视频用户标识，可能包含非数字字符。","minLength":1,"title":"User Id","type":"string"},"name":{"description":"用户名称；不可用时为空字符串。","title":"Name","type":"string"},"profile_url":{"description":"用户的好看视频主页链接。","title":"Profile Url","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户头像链接；不可用时为 null。","title":"Avatar Url"},"bio":{"description":"用户简介；不可用时为空字符串。","title":"Bio","type":"string"},"follower_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"粉丝数量；不可用时为 null。","title":"Follower Count"},"posted_video_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"已发布视频数量；不可用时为 null。","title":"Posted Video Count"},"is_verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"是否已认证；不可用时为 null。","title":"Is Verified"},"verification_label":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"平台展示的认证说明原文；没有或不可用时为 null。","title":"Verification Label"},"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","profile_url","avatar_url","bio","follower_count","posted_video_count","is_verified","verification_label","points"],"title":"HaokanUserInfoResult","type":"object"},"example":{"user_id":"1550992385283544","name":"数码人科技","profile_url":"https://haokan.baidu.com/author/1550992385283544","avatar_url":null,"bio":"关注数码人科技，获取更多前沿新品评测资讯","follower_count":91112,"posted_video_count":7385,"is_verified":false,"verification_label":null,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["haokan_get_user_info_by_user_id","haokan_get_user_info_by_url"]},{"operation_id":"haokan_get_video_detail","platform_id":"haokan","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/haokan/video/detail","summary":"获取好看视频详情","description":"按 video_id 或 url（二选一）获取视频详情、播放地址与作者摘要；播放地址可能过期，缺失的数量返回 null。","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":{"video_id":{"anyOf":[{"pattern":"^[0-9]+$","type":"string"},{"type":"null"}],"default":null,"description":"好看视频数字 ID，以字符串传入，例如 6148991337208256393；可从视频搜索结果的 video_id 获取。与 url 二选一。","title":"Video Id"},"url":{"anyOf":[{"minLength":1,"type":"string"},{"type":"null"}],"default":null,"description":"好看视频页面链接，格式为 https://haokan.baidu.com/v?vid=数字ID，可取视频搜索结果的 share_url。与 video_id 二选一。","title":"Url"}},"title":"HaokanVideoDetailRequest","type":"object"},"example":{"video_id":"6148991337208256393"}},"response":{"content_type":"application/json","schema":{"$defs":{"HaokanDetailAuthor":{"additionalProperties":false,"properties":{"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"好看视频用户标识，可用于用户资料查询；不可用时为 null。","title":"User Id"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"作者的好看视频主页链接；不可用时为 null。","title":"Profile Url"},"name":{"description":"作者名称。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者头像链接；不可用时为 null。","title":"Avatar Url"},"follower_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"作者粉丝数量；不可用时为 null。","title":"Follower Count"}},"required":["name","avatar_url","follower_count"],"title":"HaokanDetailAuthor","type":"object"},"HaokanPlaybackVariant":{"additionalProperties":false,"properties":{"quality":{"description":"平台清晰度标识，例如 sd、hd、sc、1080p。","title":"Quality","type":"string"},"label":{"description":"清晰度展示名称，例如超清 720P。","title":"Label","type":"string"},"url":{"description":"该清晰度的播放地址，可能过期。","minLength":1,"title":"Url","type":"string"}},"required":["quality","label","url"],"title":"HaokanPlaybackVariant","type":"object"}},"additionalProperties":false,"properties":{"video_id":{"description":"好看视频 ID。","minLength":1,"title":"Video Id","type":"string"},"title":{"description":"视频标题。","title":"Title","type":"string"},"share_url":{"description":"视频页面链接。","title":"Share Url","type":"string"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"视频封面链接；不可用时为 null。","title":"Cover Image Url"},"duration_seconds":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"时长，单位秒；不可用时为 null。","title":"Duration Seconds"},"publish_time":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"发布时间，Unix 秒级时间戳；不可用时为 null。","title":"Publish Time"},"view_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"平台返回的播放次数；缺失时为 null。","title":"View Count"},"like_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"平台返回的点赞数量；缺失时为 null。","title":"Like Count"},"comment_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"平台返回的评论数量；缺失时为 null。","title":"Comment Count"},"play_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"优先选取平台清晰度等级最高的非空播放地址，无候选时使用默认地址；均缺失时为 null，地址可能过期。","title":"Play Url"},"playback_variants":{"description":"按平台清晰度等级从高到低排列的非空播放地址，包含 quality、label、url；无候选时为空数组，非空时 play_url 等于第一项 url。","items":{"$ref":"#/$defs/HaokanPlaybackVariant"},"title":"Playback Variants","type":"array"},"author":{"$ref":"#/$defs/HaokanDetailAuthor","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","share_url","cover_image_url","duration_seconds","publish_time","view_count","like_count","comment_count","play_url","playback_variants","author","points"],"title":"HaokanVideoDetailResult","type":"object"},"example":{"video_id":"6148991337208256393","title":"公司带科技好还是不带好","share_url":"https://haokan.baidu.com/v?vid=6148991337208256393","cover_image_url":null,"duration_seconds":75,"publish_time":1761244702,"view_count":514,"like_count":0,"comment_count":0,"play_url":null,"playback_variants":[],"author":{"user_id":"-45HIRwqvesYm0j4S66u5Q","profile_url":"https://haokan.baidu.com/author/-45HIRwqvesYm0j4S66u5Q","name":"染辖吧灯芭姿","avatar_url":null,"follower_count":404},"points":{"cost":10,"balance":990}}},"related_mcp_tools":["haokan_get_video_detail_by_video_id","haokan_get_video_detail_by_url"]},{"operation_id":"haokan_search_videos","platform_id":"haokan","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/haokan/video/search","summary":"搜索好看视频","description":"按关键词搜索好看视频，返回视频摘要并支持 page_token 分页。","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":"视频搜索词，例如科技、美食或品牌名；不要传视频链接、用户主页链接或分页令牌。","minLength":1,"title":"Keyword","type":"string"},"page_token":{"default":"","description":"分页令牌，首次请求留空；继续翻页时将上一页完整 next_page_token 原样传回，不得修改、截断或自行生成；只能用于相同工具和相同关键词。","title":"Page Token","type":"string"}},"required":["keyword"],"title":"HaokanSearchVideosRequest","type":"object"},"example":{"keyword":"科技","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"HaokanSearchVideoItem":{"additionalProperties":false,"properties":{"video_id":{"description":"好看视频 ID，以字符串表示。","minLength":1,"title":"Video Id","type":"string"},"title":{"description":"视频标题；不可用时为空字符串。","title":"Title","type":"string"},"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"},"duration_seconds":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"视频时长，单位秒；无法确认时为 null。","title":"Duration Seconds"},"publish_time_text":{"description":"发布时间展示文本，例如“7年前”；不可用时为空字符串。","title":"Publish Time Text","type":"string"},"view_count_text":{"description":"播放量展示文本，可能为缩略值；不可用时为空字符串。","title":"View Count Text","type":"string"},"view_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"播放次数；缩略展示值换算为近似数值，例如11万返回110000；无法解析时为 null。","title":"View Count"},"author":{"$ref":"#/$defs/HaokanVideoAuthor","description":"视频作者摘要。"}},"required":["video_id","title","share_url","cover_image_url","duration_seconds","publish_time_text","view_count_text","view_count","author"],"title":"HaokanSearchVideoItem","type":"object"},"HaokanVideoAuthor":{"additionalProperties":false,"properties":{"user_id":{"description":"作者用户 ID；缺失或无法确认时为空字符串，不能用于用户查询。","title":"User Id","type":"string"},"name":{"description":"作者名称；不可用时为空字符串。","title":"Name","type":"string"}},"required":["user_id","name"],"title":"HaokanVideoAuthor","type":"object"}},"additionalProperties":false,"properties":{"items":{"description":"当前页视频搜索结果，按搜索结果顺序返回。","items":{"$ref":"#/$defs/HaokanSearchVideoItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有下一页。继续翻页时原样作为 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":"HaokanVideoSearchResult","type":"object"},"example":{"items":[{"video_id":"4838938202289793303","title":"科技。","share_url":"https://haokan.baidu.com/v?vid=4838938202289793303","cover_image_url":null,"duration_seconds":20,"publish_time_text":"1年前","view_count_text":"11万次播放","view_count":110000,"author":{"user_id":"","name":"博览众长"}}],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["haokan_search_videos"]},{"operation_id":"haokan_search_users","platform_id":"haokan","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/haokan/user/search","summary":"搜索好看视频用户","description":"按关键词搜索好看视频用户，返回用户摘要和主页链接，支持 page_token 分页。","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":"用户搜索词，例如账号名、创作者名称或品牌名；不要传视频链接、用户主页链接或分页令牌。","minLength":1,"title":"Keyword","type":"string"},"page_token":{"default":"","description":"分页令牌，首次请求留空；继续翻页时将上一页完整 next_page_token 原样传回，不得修改、截断或自行生成；只能用于相同工具和相同关键词。","title":"Page Token","type":"string"}},"required":["keyword"],"title":"HaokanSearchUsersRequest","type":"object"},"example":{"keyword":"科技","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"HaokanSearchUserItem":{"additionalProperties":false,"properties":{"user_id":{"description":"好看视频用户标识，可能包含非数字字符。","minLength":1,"title":"User Id","type":"string"},"name":{"description":"用户名称；不可用时为空字符串。","title":"Name","type":"string"},"profile_url":{"description":"用户的好看视频主页链接。","title":"Profile Url","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"用户头像链接；不可用时为 null。","title":"Avatar Url"},"bio":{"description":"用户简介；不可用时为空字符串。","title":"Bio","type":"string"},"follower_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"粉丝数量；不可用时为 null。","title":"Follower Count"},"posted_video_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"已发布视频数量；不可用时为 null。","title":"Posted Video Count"}},"required":["user_id","name","profile_url","avatar_url","bio","follower_count","posted_video_count"],"title":"HaokanSearchUserItem","type":"object"}},"additionalProperties":false,"properties":{"items":{"description":"当前页用户搜索结果。","items":{"$ref":"#/$defs/HaokanSearchUserItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示没有下一页。继续翻页时原样作为 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":"HaokanUserSearchResult","type":"object"},"example":{"items":[{"user_id":"1550992385283544","name":"数码人科技","profile_url":"https://haokan.baidu.com/author/1550992385283544","avatar_url":null,"bio":"科技资讯","follower_count":91111,"posted_video_count":7385}],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["haokan_search_users"]},{"operation_id":"haokan_search_suggestions","platform_id":"haokan","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/haokan/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":{"description":"需要补全或扩展的搜索词；不要传链接或分页令牌。","minLength":1,"title":"Keyword","type":"string"}},"required":["keyword"],"title":"HaokanSearchSuggestionsRequest","type":"object"},"example":{"keyword":"科技"}},"response":{"content_type":"application/json","schema":{"$defs":{"HaokanSearchSuggestionItem":{"additionalProperties":false,"properties":{"text":{"description":"搜索联想词。","minLength":1,"title":"Text","type":"string"}},"required":["text"],"title":"HaokanSearchSuggestionItem","type":"object"}},"additionalProperties":false,"properties":{"items":{"description":"按建议顺序排列的搜索联想词。","items":{"$ref":"#/$defs/HaokanSearchSuggestionItem"},"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":"HaokanSearchSuggestionsResult","type":"object"},"example":{"items":[{"text":"科技创新"}],"points":{"cost":10,"balance":990}}},"related_mcp_tools":["haokan_search_suggestions"]},{"operation_id":"haokan_get_hot_search_list","platform_id":"haokan","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/haokan/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":"HaokanHotSearchListRequest","type":"object"},"example":{}},"response":{"content_type":"application/json","schema":{"$defs":{"HaokanHotSearchItem":{"additionalProperties":false,"properties":{"keyword":{"description":"搜索热词。","minLength":1,"title":"Keyword","type":"string"},"hot_value":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"平台提供的热词热度值，不代表搜索次数或播放量；不可用时为 null。","title":"Hot Value"}},"required":["keyword","hot_value"],"title":"HaokanHotSearchItem","type":"object"}},"additionalProperties":false,"properties":{"items":{"description":"当前搜索热词，保持平台返回顺序。","items":{"$ref":"#/$defs/HaokanHotSearchItem"},"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":"HaokanHotSearchResult","type":"object"},"example":{"items":[{"keyword":"示例热词","hot_value":123456}],"points":{"cost":10,"balance":990}}},"related_mcp_tools":["haokan_get_hot_search_list"]}]},{"surface":"mcp","status":"available","endpoint":"https://mcp.socialdatax.com/haokan/mcp","authentication":{"required":true},"related_http_operation_ids":["haokan_get_comment_replies","haokan_get_video_comments","haokan_get_user_posted_videos","haokan_get_user_info","haokan_get_video_detail","haokan_search_videos","haokan_search_users","haokan_search_suggestions","haokan_get_hot_search_list"]}]},{"platform_id":"toutiao","label":"今日头条","english_label":"Toutiao","status":"available","surfaces":[{"surface":"http","status":"available","base_path":"/socialdatax/api/v1/toutiao","description":"公开头条 HTTP API 提供热搜、内容关键词搜索、搜索建议、用户搜索、内容详情、一级评论、评论回复、用户资料和用户作品列表。","operations":[{"operation_id":"toutiao_search_users","platform_id":"toutiao","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/toutiao/user/search","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":{"keyword":{"description":"用户名称或关键词，例如 NBA、美食；不要传内容链接或用户主页链接。","minLength":1,"title":"Keyword","type":"string"},"page_token":{"default":"","description":"首次留空；续页原样传入同一用户搜索上一页的 next_page_token，并保持 keyword 不变；不能使用内容搜索令牌。","title":"Page Token","type":"string"}},"required":["keyword"],"title":"ToutiaoSearchUsersRequest","type":"object"},"example":{"keyword":"美食","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"ToutiaoSearchUserItem":{"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":{"description":"头条用户主页链接。","title":"Profile Url","type":"string"},"bio":{"description":"用户简介；未填写时为空字符串。","title":"Bio","type":"string"},"follower_count":{"description":"粉丝数。","title":"Follower Count","type":"integer"},"verification_label":{"description":"搜索结果展示的认证或身份说明；本次搜索未提供时为空字符串，不代表账号未认证。","title":"Verification Label","type":"string"}},"required":["user_id","name","avatar_url","profile_url","bio","follower_count","verification_label"],"title":"ToutiaoSearchUserItem","type":"object"}},"properties":{"items":{"description":"当前页用户列表。","items":{"$ref":"#/$defs/ToutiaoSearchUserItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页完整分页令牌；为空表示结束。","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":"ToutiaoSearchUsersResult","type":"object"},"example":{"items":[{"user_id":"66101418860","name":"苗阿朵美食","avatar_url":null,"profile_url":"https://www.toutiao.com/c/user/66101418860/","bio":"阿朵为你分享农村美食。","follower_count":2437485,"verification_label":"优质三农领域创作者"}],"next_page_token":"opaque-toutiao-user-search-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["toutiao_search_users"]},{"operation_id":"toutiao_search_suggestions","platform_id":"toutiao","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/toutiao/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":{"description":"搜索关键词或短语，例如美食、旅行；不要传链接、用户 ID 或 page_token。","minLength":1,"title":"Keyword","type":"string"}},"required":["keyword"],"title":"ToutiaoSearchSuggestionsRequest","type":"object"},"example":{"keyword":"美食"}},"response":{"content_type":"application/json","schema":{"$defs":{"ToutiaoSearchSuggestionItem":{"properties":{"text":{"description":"搜索输入框联想词。","minLength":1,"title":"Text","type":"string"}},"required":["text"],"title":"ToutiaoSearchSuggestionItem","type":"object"}},"properties":{"items":{"description":"搜索建议列表；无匹配建议时为空数组。","items":{"$ref":"#/$defs/ToutiaoSearchSuggestionItem"},"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":"ToutiaoSearchSuggestionsResult","type":"object"},"example":{"items":[{"text":"美食"},{"text":"美食吃播"}],"points":{"cost":10,"balance":990}}},"related_mcp_tools":["toutiao_search_suggestions"]},{"operation_id":"toutiao_get_hot_search_list","platform_id":"toutiao","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/toutiao/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":"ToutiaoHotSearchListRequest","type":"object"},"example":{}},"response":{"content_type":"application/json","schema":{"$defs":{"ToutiaoHotSearchItem":{"properties":{"rank":{"description":"热搜排名，按头条返回顺序生成。","title":"Rank","type":"integer"},"hot_id":{"description":"热点 ID。","title":"Hot Id","type":"string"},"title":{"description":"热点标题。","title":"Title","type":"string"},"keyword":{"description":"热点关键词。","title":"Keyword","type":"string"},"hot_value":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"热度值；未提供时为 null。","title":"Hot Value"},"url":{"description":"热点链接。","title":"Url","type":"string"},"cover_image_url":{"description":"热点封面图；没有时为空字符串。","title":"Cover Image Url","type":"string"},"tag":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"热点标签；没有时省略。","title":"Tag"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"热点分类；没有时省略。","title":"Category"}},"required":["rank","hot_id","title","keyword","hot_value","url","cover_image_url"],"title":"ToutiaoHotSearchItem","type":"object"},"ToutiaoPinnedHotItem":{"properties":{"title":{"description":"置顶内容标题。","title":"Title","type":"string"},"url":{"description":"置顶内容链接。","title":"Url","type":"string"}},"required":["title","url"],"title":"ToutiaoPinnedHotItem","type":"object"}},"properties":{"items":{"description":"普通热搜条目。","items":{"$ref":"#/$defs/ToutiaoHotSearchItem"},"title":"Items","type":"array"},"pinned_items":{"description":"平台置顶内容。","items":{"$ref":"#/$defs/ToutiaoPinnedHotItem"},"title":"Pinned 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","pinned_items","points"],"title":"ToutiaoHotSearchResult","type":"object"},"example":{"items":[],"pinned_items":[],"points":{"cost":10,"balance":990}}},"related_mcp_tools":["toutiao_get_hot_search_list"]},{"operation_id":"toutiao_get_post_comment_replies","platform_id":"toutiao","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/toutiao/post/comment/reply/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":{"comment_id":{"description":"一级评论 ID，取一级评论结果的 comment_id；不要传内容 ID、链接或回复项自身的 comment_id。","pattern":"^[0-9]+$","title":"Comment Id","type":"string"},"page_token":{"default":"","description":"首次留空；续页原样传入同一一级评论上一页回复结果的 next_page_token，并保持 comment_id 不变；不要使用一级评论或搜索的分页令牌。","title":"Page Token","type":"string"}},"required":["comment_id"],"title":"ToutiaoCommentRepliesRequest","type":"object"},"example":{"comment_id":"7666488597058863906","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"ToutiaoCommentAuthor":{"properties":{"profile_url":{"description":"评论作者头条主页链接。","title":"Profile Url","type":"string"},"user_id":{"description":"评论作者用户 ID。","title":"User Id","type":"string"},"name":{"description":"评论作者显示名称。","title":"Name","type":"string"},"avatar_url":{"description":"评论作者头像链接。","title":"Avatar Url","type":"string"}},"required":["profile_url","user_id","name","avatar_url"],"title":"ToutiaoCommentAuthor","type":"object"},"ToutiaoCommentReplyItem":{"properties":{"comment_id":{"description":"回复项自身的评论 ID；不要作为回复列表的入口 ID。","title":"Comment Id","type":"string"},"parent_comment_id":{"description":"所属一级评论 ID，用于继续查询该评论的回复。","title":"Parent Comment Id","type":"string"},"reply_to_comment_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"被回复的评论 ID；上游未提供时省略。","title":"Reply To Comment Id"},"content":{"description":"回复正文。","title":"Content","type":"string"},"image_urls":{"description":"回复图片的大图链接列表；无图片时为空数组。","items":{"type":"string"},"title":"Image Urls","type":"array"},"publish_time":{"description":"回复发布时间，秒级 Unix 时间戳。","title":"Publish Time","type":"integer"},"like_count":{"description":"回复点赞数。","title":"Like Count","type":"integer"},"ip_location":{"description":"回复 IP 属地；未提供时为空字符串。","title":"Ip Location","type":"string"},"author":{"$ref":"#/$defs/ToutiaoCommentAuthor","description":"回复作者。"}},"required":["comment_id","parent_comment_id","content","image_urls","publish_time","like_count","ip_location","author"],"title":"ToutiaoCommentReplyItem","type":"object"}},"properties":{"items":{"description":"当前页评论回复列表。","items":{"$ref":"#/$defs/ToutiaoCommentReplyItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页完整分页令牌；为空表示结束。","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":"ToutiaoCommentRepliesResult","type":"object"},"example":{"items":[{"comment_id":"7666500322722333480","parent_comment_id":"7666488597058863906","reply_to_comment_id":"7666476897337148201","content":"[赞]","image_urls":[],"publish_time":1784996233,"like_count":1,"ip_location":"广东","author":{"user_id":"5570477421","name":"云铺旺","avatar_url":"https://example.com/avatar.jpg","profile_url":"https://www.toutiao.com/c/user/5570477421/"}}],"next_page_token":"opaque-toutiao-replies-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["toutiao_get_post_comment_replies_by_comment_id"]},{"operation_id":"toutiao_get_user_info","platform_id":"toutiao","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/toutiao/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":{"user_id":{"description":"头条数字用户 ID、用户主页链接或包含主页链接的分享文案；不接受内容链接。","minLength":1,"title":"User Id","type":"string"}},"required":["user_id"],"title":"ToutiaoUserInfoRequest","type":"object"},"example":{"user_id":"5003463346"}},"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":{"description":"用户主页链接，可用于再次查询用户资料。","title":"Profile Url","type":"string"},"bio":{"description":"用户简介；未填写时为空字符串。","title":"Bio","type":"string"},"verified":{"description":"用户是否已认证。","title":"Verified","type":"boolean"},"verification_label":{"description":"认证说明；无认证说明时为空字符串。","title":"Verification Label","type":"string"},"ip_location":{"description":"主页显示的 IP 属地；未提供时为空字符串。","title":"Ip Location","type":"string"},"follower_count":{"description":"粉丝数；头条使用万等缩略显示时为换算的近似值。","title":"Follower Count","type":"integer"},"following_count":{"description":"关注数；头条使用万等缩略显示时为换算的近似值。","title":"Following Count","type":"integer"},"received_like_count":{"description":"累计获赞数；头条使用万等缩略显示时为换算的近似值。","title":"Received Like 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","profile_url","bio","verified","verification_label","ip_location","follower_count","following_count","received_like_count","points"],"title":"ToutiaoUserInfoResult","type":"object"},"example":{"user_id":"5003463346","name":"京报网","avatar_url":null,"profile_url":"https://www.toutiao.com/c/user/5003463346/","bio":"北京日报官方网站·首都视角天下观","verified":true,"verification_label":"京报网官方账号","ip_location":"北京","follower_count":2997000,"following_count":12,"received_like_count":45391000,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["toutiao_get_user_info_by_user_id","toutiao_get_user_info_by_profile_url"]},{"operation_id":"toutiao_get_post_comments","platform_id":"toutiao","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/toutiao/post/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":{"post_id":{"description":"头条内容 ID（可取搜索结果 post_id）、完整内容链接或包含该链接的分享文案；支持 /article/ID/、/aID/、/video/ID/ 和 /w/ID/。","minLength":1,"title":"Post Id","type":"string"},"page_token":{"default":"","description":"首次留空；续页原样传入同一内容上一页评论结果的 next_page_token；不要使用搜索结果的分页令牌。","title":"Page Token","type":"string"}},"required":["post_id"],"title":"ToutiaoCommentsRequest","type":"object"},"example":{"post_id":"7666443607460676134","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"ToutiaoCommentAuthor":{"properties":{"profile_url":{"description":"评论作者头条主页链接。","title":"Profile Url","type":"string"},"user_id":{"description":"评论作者用户 ID。","title":"User Id","type":"string"},"name":{"description":"评论作者显示名称。","title":"Name","type":"string"},"avatar_url":{"description":"评论作者头像链接。","title":"Avatar Url","type":"string"}},"required":["profile_url","user_id","name","avatar_url"],"title":"ToutiaoCommentAuthor","type":"object"},"ToutiaoCommentItem":{"properties":{"comment_id":{"description":"一级评论 ID，以字符串表示。","title":"Comment Id","type":"string"},"content":{"description":"评论正文。","title":"Content","type":"string"},"image_urls":{"description":"评论图片的大图链接列表；无图片时为空数组。","items":{"type":"string"},"title":"Image Urls","type":"array"},"publish_time":{"description":"评论发布时间，秒级 Unix 时间戳。","title":"Publish Time","type":"integer"},"like_count":{"description":"评论点赞数。","title":"Like Count","type":"integer"},"has_replies":{"description":"评论是否有回复。","title":"Has Replies","type":"boolean"},"ip_location":{"description":"评论 IP 属地；未提供时为空字符串。","title":"Ip Location","type":"string"},"author":{"$ref":"#/$defs/ToutiaoCommentAuthor","description":"评论作者。"}},"required":["comment_id","content","image_urls","publish_time","like_count","has_replies","ip_location","author"],"title":"ToutiaoCommentItem","type":"object"}},"properties":{"items":{"description":"当前页一级评论列表。","items":{"$ref":"#/$defs/ToutiaoCommentItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页完整分页令牌；为空表示结束。","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":"ToutiaoCommentsResult","type":"object"},"example":{"items":[{"comment_id":"7666586125364118308","content":"这篇文章很有启发。","image_urls":[],"publish_time":1785016207,"like_count":10,"has_replies":false,"ip_location":"海南","author":{"user_id":"254683282674616","profile_url":"https://www.toutiao.com/c/user/254683282674616/","name":"读者","avatar_url":"https://example.com/avatar.jpg"}}],"next_page_token":"opaque-toutiao-comments-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["toutiao_get_post_comments_by_post_id","toutiao_get_post_comments_by_url"]},{"operation_id":"toutiao_get_user_posts","platform_id":"toutiao","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/toutiao/user/post/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":{"user_id":{"description":"头条数字用户 ID、用户主页链接或包含主页链接的分享文案；不接受内容链接。","minLength":1,"title":"User Id","type":"string"},"content_type":{"default":"all","description":"作品筛选：all、article、video、micro_post。","enum":["all","article","video","micro_post"],"title":"Content Type","type":"string","x-socialdatax-enum-labels":{"all":"全部作品","article":"只看文章","video":"只看视频","micro_post":"只看微头条"}},"page_token":{"default":"","description":"上一页返回的分页令牌；首次留空，不能跨用户或作品类型复用。","title":"Page Token","type":"string"}},"required":["user_id"],"title":"ToutiaoUserPostsRequest","type":"object"},"example":{"user_id":"5003463346","content_type":"all","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"ToutiaoImageData":{"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":"ToutiaoImageData","type":"object"},"ToutiaoUserPostAuthor":{"properties":{"user_id":{"description":"作者数字用户 ID，可用于查询用户资料或作品。","title":"User Id","type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者显示名称；未提供时为 null。","title":"Name"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者头像链接；未提供时为 null。","title":"Avatar Url"},"profile_url":{"description":"作者头条主页链接。","title":"Profile Url","type":"string"}},"required":["user_id","name","avatar_url","profile_url"],"title":"ToutiaoUserPostAuthor","type":"object"},"ToutiaoUserPostItem":{"properties":{"post_id":{"description":"作品 ID。","title":"Post Id","type":"string"},"is_pinned":{"default":false,"description":"是否在用户主页置顶。","title":"Is Pinned","type":"boolean"},"content_type":{"description":"作品类型：article、video 或 micro_post。","enum":["article","video","micro_post"],"title":"Content Type","type":"string","x-socialdatax-enum-labels":{"article":"文章","video":"视频","micro_post":"微头条"}},"title":{"description":"作品标题；微头条没有独立标题时为空字符串。","title":"Title","type":"string"},"content":{"description":"文章为列表摘要，微头条为正文，视频通常为空字符串；完整内容请查询作品详情。","title":"Content","type":"string"},"post_url":{"description":"作品链接。","title":"Post Url","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/ToutiaoImageData"},"title":"Images","type":"array"},"video":{"anyOf":[{"$ref":"#/$defs/ToutiaoVideoData"},{"type":"null"}],"default":null,"description":"视频播放信息；非视频作品省略。"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"点赞数；未提供时为 null。","title":"Like Count"},"comment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论数；未提供时为 null。","title":"Comment Count"},"read_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"阅读数；未提供时为 null。","title":"Read Count"},"author":{"$ref":"#/$defs/ToutiaoUserPostAuthor","description":"作品作者。"}},"required":["post_id","content_type","title","content","post_url","publish_time","cover_image_url","images","like_count","comment_count","read_count","author"],"title":"ToutiaoUserPostItem","type":"object"},"ToutiaoVideoData":{"properties":{"video_url":{"description":"视频播放链接，有效期有限，建议获取后及时使用。","title":"Video Url","type":"string"},"duration_ms":{"description":"视频时长，单位毫秒。","title":"Duration Ms","type":"integer"},"width":{"description":"视频宽度，像素。","title":"Width","type":"integer"},"height":{"description":"视频高度，像素。","title":"Height","type":"integer"}},"required":["video_url","duration_ms","width","height"],"title":"ToutiaoVideoData","type":"object"}},"properties":{"items":{"description":"用户发布的作品列表。","items":{"$ref":"#/$defs/ToutiaoUserPostItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页分页令牌；为空表示结束。","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":"ToutiaoUserPostsResult","type":"object"},"example":{"items":[{"post_id":"1863428102330444","content_type":"micro_post","title":"","content":"北京车展现场分享。","post_url":"https://www.toutiao.com/w/1863428102330444/","publish_time":1777103522,"cover_image_url":"https://example.com/image.jpg","images":[{"url":"https://example.com/image.jpg","width":1280,"height":853}],"like_count":2750,"comment_count":665,"read_count":6287367,"author":{"user_id":"5003463346","name":"京报网","avatar_url":"https://example.com/avatar.jpg","profile_url":"https://www.toutiao.com/c/user/5003463346/"}}],"next_page_token":"opaque-toutiao-user-posts-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["toutiao_get_user_posts_by_user_id","toutiao_get_user_posts_by_profile_url"]},{"operation_id":"toutiao_get_post_detail","platform_id":"toutiao","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/toutiao/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":{"description":"头条内容 ID（可取搜索结果 post_id）、完整内容链接或包含该链接的分享文案；支持 /article/ID/、/aID/、/video/ID/ 和 /w/ID/。","minLength":1,"title":"Post Id","type":"string"}},"required":["post_id"],"title":"ToutiaoDetailRequest","type":"object"},"example":{"post_id":"7683148660128924211"}},"response":{"content_type":"application/json","schema":{"$defs":{"ToutiaoDetailAuthor":{"properties":{"profile_url":{"description":"作者头条主页链接。","title":"Profile Url","type":"string"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者用户 ID；未提供时为 null。","title":"User Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者显示名称；未提供时为 null。","title":"Name"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者头像链接；未提供时为 null。","title":"Avatar Url"}},"required":["profile_url","user_id","name","avatar_url"],"title":"ToutiaoDetailAuthor","type":"object"},"ToutiaoImageData":{"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":"ToutiaoImageData","type":"object"},"ToutiaoVideoData":{"properties":{"video_url":{"description":"视频播放链接，有效期有限，建议获取后及时使用。","title":"Video Url","type":"string"},"duration_ms":{"description":"视频时长，单位毫秒。","title":"Duration Ms","type":"integer"},"width":{"description":"视频宽度，像素。","title":"Width","type":"integer"},"height":{"description":"视频高度，像素。","title":"Height","type":"integer"}},"required":["video_url","duration_ms","width","height"],"title":"ToutiaoVideoData","type":"object"}},"properties":{"post_id":{"description":"内容 ID，以字符串表示。","title":"Post Id","type":"string"},"title":{"description":"内容标题；无独立标题的微头条可为空，请阅读 content。","title":"Title","type":"string"},"content":{"description":"正文纯文本；纯图片内容或视频可能为空，请结合 images 和 video 阅读。视频说明不是语音转写。","title":"Content","type":"string"},"post_url":{"description":"头条内容页面链接。","title":"Post Url","type":"string"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"发布时间，秒级 Unix 时间戳；未提供时为 null。","title":"Publish Time"},"images":{"description":"按正文顺序返回的图片，包含链接和像素宽高；无图片时为空数组。","items":{"$ref":"#/$defs/ToutiaoImageData"},"title":"Images","type":"array"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"封面图片链接；未提供时为 null。","title":"Cover Image Url"},"author":{"$ref":"#/$defs/ToutiaoDetailAuthor","description":"内容作者，包含作者主页链接。"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"点赞数；未提供时为 null。","title":"Like Count"},"comment_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论数；未提供时为 null。","title":"Comment Count"},"read_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"阅读数；未提供时为 null。","title":"Read Count"},"share_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"分享数；未提供时为 null。","title":"Share Count"},"collect_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"收藏数；未提供时为 null。","title":"Collect Count"},"video":{"anyOf":[{"$ref":"#/$defs/ToutiaoVideoData"},{"type":"null"}],"default":null,"description":"视频播放信息；当前返回无视频信息时省略。"},"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","title","content","post_url","publish_time","images","cover_image_url","author","like_count","comment_count","read_count","share_count","collect_count","points"],"title":"ToutiaoDetailResult","type":"object"},"example":{"post_id":"7683148660128924211","title":"通过投篮姿势猜猜这是哪位NBA球员？","content":"","images":[{"url":"https://example.com/article-image.jpg","width":466,"height":272}],"post_url":"https://www.toutiao.com/article/7683148660128924211/","publish_time":1788872461,"cover_image_url":null,"author":{"user_id":"3772023195","name":"直播吧","avatar_url":null,"profile_url":"https://www.toutiao.com/c/user/token/MS4wLjABAAAAjiGR2WNpvlGgfhkn8pdqhsZsQmqE-hliqNfXcbFp4pU/"},"like_count":0,"comment_count":2,"read_count":3,"share_count":0,"collect_count":0,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["toutiao_get_post_detail_by_post_id","toutiao_get_post_detail_by_url"]},{"operation_id":"toutiao_search_posts","platform_id":"toutiao","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/toutiao/post/search","summary":"搜索头条内容","description":"按关键词搜索今日头条公开内容，使用“只看头条”范围，返回标题、摘要、作者、发布时间、互动数据和链接。不包含导航、百科、用户及视频聚合面板，结果数量可能少于网页展示数量。空列表不一定表示结束，请以 next_page_token 是否为空判断。","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":"搜索词或关键词短语，例如 NBA、旅行攻略；不要传作品链接、用户主页链接或内容 ID。","minLength":1,"title":"Keyword","type":"string"},"page_token":{"default":"","description":"首次留空；续页原样传入上一页的 next_page_token，并保持 keyword 不变。","title":"Page Token","type":"string"}},"required":["keyword"],"title":"ToutiaoSearchRequest","type":"object"},"example":{"keyword":"NBA","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"ToutiaoSearchAuthor":{"properties":{"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"作者头条主页链接；没有可用用户 ID 时省略。","title":"Profile Url"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者用户 ID；未提供时为 null。","title":"User Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者显示名称；未提供时为 null。","title":"Name"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"作者头像链接；未提供时为 null。","title":"Avatar Url"}},"required":["user_id","name","avatar_url"],"title":"ToutiaoSearchAuthor","type":"object"},"ToutiaoSearchItem":{"properties":{"post_id":{"description":"内容 ID，以字符串表示。","title":"Post Id","type":"string"},"title":{"description":"内容标题。","title":"Title","type":"string"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"搜索摘要，不是完整正文；未提供时为 null。","title":"Summary"},"post_url":{"description":"头条内容页面链接。","title":"Post Url","type":"string"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"发布时间，秒级 Unix 时间戳；未提供时为 null。","title":"Publish Time"},"has_video":{"description":"内容是否包含视频。","title":"Has Video","type":"boolean"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"封面图片链接；未提供时为 null。","title":"Cover Image 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"},"read_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"阅读数；未提供时为 null。","title":"Read Count"},"author":{"$ref":"#/$defs/ToutiaoSearchAuthor","description":"内容作者。"}},"required":["post_id","title","summary","post_url","publish_time","has_video","cover_image_url","like_count","comment_count","read_count","author"],"title":"ToutiaoSearchItem","type":"object"}},"properties":{"items":{"description":"当前页内容列表，不包含聚合面板。","items":{"$ref":"#/$defs/ToutiaoSearchItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页完整分页令牌；为空表示结束。","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":"ToutiaoSearchResult","type":"object"},"example":{"items":[{"post_id":"7683148660128924211","title":"通过投篮姿势猜猜这是哪位NBA球员？","summary":"","post_url":"http://www.toutiao.com/a7683148660128924211/?channel=&source=search_tab","publish_time":1788872461,"has_video":false,"cover_image_url":null,"like_count":0,"comment_count":2,"read_count":3,"author":{"user_id":"3772023195","profile_url":"https://www.toutiao.com/c/user/3772023195/","name":"直播吧","avatar_url":null}}],"next_page_token":"opaque-toutiao-search-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["toutiao_search_posts"]}]},{"surface":"mcp","status":"available","endpoint":"https://mcp.socialdatax.com/toutiao/mcp","authentication":{"required":true},"capabilities_resource":"resource://toutiao/search-guide","related_http_operation_ids":["toutiao_get_hot_search_list","toutiao_search_suggestions","toutiao_search_users","toutiao_search_posts","toutiao_get_post_detail","toutiao_get_post_comments","toutiao_get_post_comment_replies","toutiao_get_user_info","toutiao_get_user_posts"]}]},{"platform_id":"baidu-tieba","label":"百度贴吧","english_label":"Baidu Tieba","status":"available","surfaces":[{"surface":"http","status":"available","base_path":"/socialdatax/api/v1/baidu-tieba","description":"公开百度贴吧 HTTP API 提供吧名搜索建议、用户搜索、综合搜索中的帖子、帖子关键词搜索、吧内帖子搜索、帖子详情、一级评论、楼中楼回复、用户资料、用户发帖、关注贴吧列表、贴吧详情和吧内帖子列表。","operations":[{"operation_id":"baidu_tieba_get_forum_posts","platform_id":"baidu-tieba","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/baidu-tieba/forum/post/list","summary":"获取百度贴吧吧内帖子列表","description":"按准确吧名浏览帖子，无需关键词；返回普通帖和置顶帖，按所选排序返回，顺序以贴吧实际结果为准。支持排序或仅查看精华帖，不提供分类选项；按关键词查找帖子请使用吧内帖子搜索。摘要和媒体可能不完整，未提供的时间和浏览数为 null。","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":{"forum_name":{"description":"准确贴吧名称，例如 方便面；直接使用结果中的 forum_name，不要自行追加“吧”字；不要传 URL 或数字 ID，无需 URL 编码。","minLength":1,"title":"Forum Name","type":"string"},"page_token":{"default":"","description":"分页令牌；首次留空，续页原样传回 next_page_token，并保持 forum_name、sort_type、featured_only 不变。切换排序或精华筛选时，将 page_token 留空重新查询。只根据令牌判断是否续页，不按条数判断；不要使用其他接口或其他贴吧的令牌。","title":"Page Token","type":"string"},"sort_type":{"default":"default","description":"排序方式：default 为贴吧默认顺序，newest 为最新发布，latest_reply 为最近回复，hot 为热门。顺序以贴吧实际返回为准，不保证严格按时间排列；仅查看精华时只支持 default。","enum":["default","newest","latest_reply","hot"],"title":"Sort Type","type":"string","x-socialdatax-enum-labels":{"default":"默认/综合排序"}},"featured_only":{"default":false,"description":"是否仅查看精华帖，false 表示不筛选（仍可包含精华帖）；true 时 sort_type 必须为 default，按贴吧精华列表顺序返回。","title":"Featured Only","type":"boolean"}},"required":["forum_name"],"title":"TiebaForumPostsRequest","type":"object"},"example":{"forum_name":"机械纪元","page_token":"","sort_type":"default","featured_only":false}},"response":{"content_type":"application/json","schema":{"$defs":{"TiebaForumPostImage":{"properties":{"url":{"description":"上游提供的原图链接，可能有有效期；不保证原始图片无水印。","minLength":1,"title":"Url","type":"string"},"width":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"原图宽度，单位像素；未提供时为 null。","title":"Width"},"height":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"原图高度，单位像素；未提供时为 null。","title":"Height"}},"required":["url","width","height"],"title":"TiebaForumPostImage","type":"object"},"TiebaForumPostItem":{"properties":{"thread_id":{"description":"主题帖 ID，以字符串表示。","title":"Thread Id","type":"string"},"title":{"description":"帖子标题。","title":"Title","type":"string"},"author":{"$ref":"#/$defs/TiebaSearchAuthor","description":"帖子作者。"},"summary":{"description":"帖子列表摘要，不是完整正文。","title":"Summary","type":"string"},"images":{"description":"本次列表提供的图片，可能不完整；空数组不代表帖子没有图片。","items":{"$ref":"#/$defs/TiebaForumPostImage"},"title":"Images","type":"array"},"videos":{"description":"列表提供的视频，可能不完整；未提供时为空数组。","items":{"$ref":"#/$defs/TiebaUserPostVideo"},"title":"Videos","type":"array"},"post_url":{"description":"帖子页面链接。","title":"Post Url","type":"string"},"forum_id":{"description":"所属贴吧 ID，以字符串表示。","title":"Forum Id","type":"string"},"forum_name":{"description":"帖子所属贴吧名称。","title":"Forum Name","type":"string"},"publish_time":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"发帖时间，秒级 Unix 时间戳；未提供时为 null。","title":"Publish Time"},"update_time":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"列表显示的最近回复时间，秒级 Unix 时间戳；未提供时为 null。","title":"Update Time"},"like_count":{"description":"点赞数。","title":"Like Count","type":"integer"},"share_count":{"description":"分享数。","title":"Share Count","type":"integer"},"reply_count":{"description":"帖子回复数。","minimum":0,"title":"Reply Count","type":"integer"},"view_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"帖子浏览数；未提供时为 null，与视频播放数不同。","title":"View Count"},"is_pinned":{"description":"是否为贴吧列表中的置顶帖。","title":"Is Pinned","type":"boolean"}},"required":["thread_id","title","author","summary","images","videos","post_url","forum_id","forum_name","publish_time","update_time","like_count","share_count","reply_count","view_count","is_pinned"],"title":"TiebaForumPostItem","type":"object"},"TiebaSearchAuthor":{"properties":{"user_id":{"description":"作者用户 ID，以字符串表示；匿名历史帖子为空字符串。","title":"User Id","type":"string"},"name":{"description":"作者显示名称；匿名历史帖子为空字符串。","title":"Name","type":"string"},"avatar_url":{"description":"作者头像链接；匿名历史帖子为贴吧默认头像。","title":"Avatar Url","type":"string"},"profile_url":{"description":"作者贴吧主页链接；默认头像或匿名历史帖子为空字符串。","title":"Profile Url","type":"string"}},"required":["user_id","name","avatar_url","profile_url"],"title":"TiebaSearchAuthor","type":"object"},"TiebaUserPostVideo":{"properties":{"video_url":{"description":"帖子列表提供的视频播放地址，可能有有效期。","minLength":1,"title":"Video Url","type":"string"},"cover_image_url":{"description":"视频封面图片地址。","minLength":1,"title":"Cover Image Url","type":"string"},"width":{"description":"视频宽度，单位像素。","minimum":0,"title":"Width","type":"integer"},"height":{"description":"视频高度，单位像素。","minimum":0,"title":"Height","type":"integer"},"duration_ms":{"description":"视频时长，单位毫秒。","minimum":0,"title":"Duration Ms","type":"integer"},"play_count":{"description":"视频播放次数，不代表独立观看人数。","minimum":0,"title":"Play Count","type":"integer"}},"required":["video_url","cover_image_url","width","height","duration_ms","play_count"],"title":"TiebaUserPostVideo","type":"object"}},"properties":{"items":{"description":"本次返回的普通帖和置顶帖，保留展示顺序；不保证跨页无重复或覆盖全吧历史帖子。","items":{"$ref":"#/$defs/TiebaForumPostItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页令牌；为空表示本次可读取列表结束。是否续页只看令牌，不按返回条数判断。","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":"TiebaForumPostsResult","type":"object"},"example":{"items":[{"thread_id":"10167570839","post_url":"https://tieba.baidu.com/p/10167570839","forum_id":"15113116","forum_name":"机械纪元","title":"吧务公告","summary":"管理权限调整公告","author":{"user_id":"167570067","name":"贴吧吧主小管家","avatar_url":"https://example.com/avatar.jpg","profile_url":"https://tieba.baidu.com/home/main?id=tb.1.81d861cb.OdTTVyaQZgMA73YK9x63bQ"},"is_pinned":true,"publish_time":null,"update_time":null,"view_count":null,"like_count":0,"share_count":0,"reply_count":0,"images":[],"videos":[]}],"next_page_token":"opaque-baidu-tieba-forum-posts-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["baidu_tieba_get_forum_posts"]},{"operation_id":"baidu_tieba_get_forum_detail","platform_id":"baidu-tieba","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/baidu-tieba/forum/detail","summary":"获取百度贴吧详情","description":"按准确吧名获取贴吧简介、标语、建吧日期、关注人数、帖子统计和友情链接贴吧。不知道准确吧名时，先使用吧名搜索建议获取 forum_name；按关键词查找吧内帖子时，使用吧内帖子搜索；无需关键词浏览帖子时，使用吧内帖子列表。","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":{"forum_name":{"description":"准确贴吧名称，例如 方便面；直接使用结果中的 forum_name，不要自行追加“吧”字；不要传 URL 或数字 ID，无需 URL 编码。","minLength":1,"title":"Forum Name","type":"string"}},"required":["forum_name"],"title":"TiebaForumDetailRequest","type":"object"},"example":{"forum_name":"摄影"}},"response":{"content_type":"application/json","schema":{"$defs":{"TiebaRelatedForum":{"properties":{"forum_id":{"description":"贴吧 ID，以字符串表示。","title":"Forum Id","type":"string"},"forum_name":{"description":"准确贴吧名称，可用于贴吧详情查询或吧内帖子关键词搜索。","title":"Forum Name","type":"string"},"forum_url":{"description":"贴吧主页链接，可直接打开或引用。","title":"Forum Url","type":"string"},"avatar_url":{"description":"贴吧头像链接。","title":"Avatar Url","type":"string"}},"required":["forum_id","forum_name","forum_url","avatar_url"],"title":"TiebaRelatedForum","type":"object"}},"properties":{"forum_name":{"description":"查询的贴吧名称。","title":"Forum Name","type":"string"},"forum_url":{"description":"贴吧链接。","title":"Forum Url","type":"string"},"slogan":{"description":"贴吧标语；未提供内容时返回空字符串。","title":"Slogan","type":"string"},"description":{"description":"贴吧简介；未提供内容时返回空字符串。","title":"Description","type":"string"},"created_date":{"description":"建吧日期，格式 YYYY-MM-DD。","title":"Created Date","type":"string"},"member_count":{"description":"关注人数。","minimum":0,"title":"Member Count","type":"integer"},"post_count":{"description":"贴吧展示的帖子统计数，不保证仅统计主题帖。","minimum":0,"title":"Post Count","type":"integer"},"related_forums":{"description":"贴吧展示的友情链接列表，保留展示顺序，不代表算法相似度排名；无友情链接时为空数组。","items":{"$ref":"#/$defs/TiebaRelatedForum"},"title":"Related Forums","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":["forum_name","forum_url","slogan","description","created_date","member_count","post_count","related_forums","points"],"title":"TiebaForumDetailResult","type":"object"},"example":{"forum_name":"摄影","forum_url":"https://tieba.baidu.com/f?kw=%E6%91%84%E5%BD%B1","slogan":"摄取光的影子，这就是最初的摄影","description":"摄影交流社区","created_date":"2003-11-27","member_count":3161412,"post_count":12889630,"related_forums":[{"forum_id":"1163000","forum_name":"单反","forum_url":"https://tieba.baidu.com/f?kw=%E5%8D%95%E5%8F%8D","avatar_url":"http://tb1.bdstatic.com/tb/r/image/2014-09-25/e07d589f0d05631c499c9942954b3794.jpg"}],"points":{"cost":10,"balance":990}}},"related_mcp_tools":["baidu_tieba_get_forum_detail"]},{"operation_id":"baidu_tieba_get_user_followed_forums","platform_id":"baidu-tieba","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/baidu-tieba/user/followed/forum/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":[{"pattern":"^[1-9][0-9]{0,18}$","type":"string"},{"type":"null"}],"default":null,"description":"百度贴吧数字用户 ID，可取搜索、帖子详情或评论作者的 user_id；不是主页链接中的 portrait 或 tieba_uid。与 profile_url 二选一。","title":"User Id"},"profile_url":{"anyOf":[{"minLength":1,"type":"string"},{"type":"null"}],"default":null,"description":"百度贴吧用户主页完整链接，形如 https://tieba.baidu.com/home/main?id=…；可取搜索、详情或评论作者的 profile_url，不接受数字用户 ID、昵称或帖子链接。与 user_id 二选一。","title":"Profile Url"},"page_token":{"default":"","description":"分页令牌；首次留空，续页原样传入本接口的 next_page_token，保持同一用户入口和标识。不要使用发帖列表、搜索、评论或其他用户的令牌。","title":"Page Token","type":"string"}},"title":"TiebaFollowedForumsRequest","type":"object"},"example":{"user_id":"6379379968","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"TiebaFollowedForumItem":{"properties":{"forum_id":{"description":"贴吧 ID，以字符串表示。","title":"Forum Id","type":"string"},"forum_name":{"description":"准确贴吧名称，可用于贴吧详情查询或吧内帖子关键词搜索。","title":"Forum Name","type":"string"},"forum_url":{"description":"贴吧页面完整链接。","title":"Forum Url","type":"string"},"user_level":{"description":"目标用户在该贴吧的等级，不是贴吧整体等级或热度。","minimum":0,"title":"User Level","type":"integer"},"avatar_url":{"description":"贴吧头像链接，可能有有效期。","minLength":1,"title":"Avatar Url","type":"string"}},"required":["forum_id","forum_name","forum_url","user_level","avatar_url"],"title":"TiebaFollowedForumItem","type":"object"}},"properties":{"items":{"description":"当前页关注的贴吧，保留贴吧返回顺序。","items":{"$ref":"#/$defs/TiebaFollowedForumItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页令牌；为空表示本次可读取列表结束。是否续页只看令牌，不按当前条数判断。","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":"TiebaFollowedForumsResult","type":"object"},"example":{"items":[{"forum_id":"16791220","forum_name":"火影忍者手游","avatar_url":"https://example.com/forum-avatar.jpg","forum_url":"https://tieba.baidu.com/f?kw=%E7%81%AB%E5%BD%B1%E5%BF%8D%E8%80%85%E6%89%8B%E6%B8%B8","user_level":13}],"next_page_token":"opaque-baidu-tieba-followed-forums-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["baidu_tieba_get_user_followed_forums_by_user_id","baidu_tieba_get_user_followed_forums_by_profile_url"]},{"operation_id":"baidu_tieba_get_user_posts","platform_id":"baidu-tieba","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/baidu-tieba/user/post/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":{"user_id":{"anyOf":[{"pattern":"^[1-9][0-9]{0,18}$","type":"string"},{"type":"null"}],"default":null,"description":"百度贴吧数字用户 ID，可取搜索、帖子详情或评论作者的 user_id；不是主页链接中的 portrait 或 tieba_uid。与 profile_url 二选一。","title":"User Id"},"profile_url":{"anyOf":[{"minLength":1,"type":"string"},{"type":"null"}],"default":null,"description":"百度贴吧用户主页完整链接，形如 https://tieba.baidu.com/home/main?id=…；可取搜索、详情或评论作者的 profile_url，不接受数字用户 ID、昵称或帖子链接。与 user_id 二选一。","title":"Profile Url"},"page_token":{"default":"","description":"分页令牌；首次留空，续页原样传入本接口返回的 next_page_token，并保持相同的用户入口和标识。不要使用搜索、评论或其他用户的令牌。","title":"Page Token","type":"string"}},"title":"TiebaUserPostsRequest","type":"object"},"example":{"user_id":"2922545293","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"TiebaSearchAuthor":{"properties":{"user_id":{"description":"作者用户 ID，以字符串表示；匿名历史帖子为空字符串。","title":"User Id","type":"string"},"name":{"description":"作者显示名称；匿名历史帖子为空字符串。","title":"Name","type":"string"},"avatar_url":{"description":"作者头像链接；匿名历史帖子为贴吧默认头像。","title":"Avatar Url","type":"string"},"profile_url":{"description":"作者贴吧主页链接；默认头像或匿名历史帖子为空字符串。","title":"Profile Url","type":"string"}},"required":["user_id","name","avatar_url","profile_url"],"title":"TiebaSearchAuthor","type":"object"},"TiebaUserPostImage":{"properties":{"url":{"description":"上游提供的原图链接，可能有有效期；不保证原始图片无水印。","minLength":1,"title":"Url","type":"string"},"width":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"原图宽度，单位像素；未提供时为 null。","title":"Width"},"height":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"原图高度，单位像素；未提供时为 null。","title":"Height"}},"required":["url","width","height"],"title":"TiebaUserPostImage","type":"object"},"TiebaUserPostItem":{"properties":{"thread_id":{"description":"主题帖 ID，以字符串表示。","title":"Thread Id","type":"string"},"title":{"description":"帖子标题。","title":"Title","type":"string"},"author":{"$ref":"#/$defs/TiebaSearchAuthor","description":"帖子作者。"},"summary":{"description":"帖子列表摘要，不是完整正文。","title":"Summary","type":"string"},"images":{"description":"列表提供的图片，可能不完整；未提供时为空数组。","items":{"$ref":"#/$defs/TiebaUserPostImage"},"title":"Images","type":"array"},"videos":{"description":"列表提供的视频，可能不完整；未提供时为空数组。","items":{"$ref":"#/$defs/TiebaUserPostVideo"},"title":"Videos","type":"array"},"post_url":{"description":"帖子页面链接。","title":"Post Url","type":"string"},"forum_id":{"description":"所属贴吧 ID，以字符串表示。","title":"Forum Id","type":"string"},"forum_name":{"description":"帖子所属贴吧名称。","title":"Forum Name","type":"string"},"publish_time":{"description":"发帖时间，秒级 Unix 时间戳。","title":"Publish Time","type":"integer"},"update_time":{"description":"更新时间，秒级 Unix 时间戳。","title":"Update Time","type":"integer"},"like_count":{"description":"点赞数。","title":"Like Count","type":"integer"},"share_count":{"description":"分享数。","title":"Share Count","type":"integer"},"reply_count":{"description":"帖子回复数。","minimum":0,"title":"Reply Count","type":"integer"},"view_count":{"description":"帖子浏览数，与视频播放次数不同。","minimum":0,"title":"View Count","type":"integer"}},"required":["thread_id","title","author","summary","images","videos","post_url","forum_id","forum_name","publish_time","update_time","like_count","share_count","reply_count","view_count"],"title":"TiebaUserPostItem","type":"object"},"TiebaUserPostVideo":{"properties":{"video_url":{"description":"帖子列表提供的视频播放地址，可能有有效期。","minLength":1,"title":"Video Url","type":"string"},"cover_image_url":{"description":"视频封面图片地址。","minLength":1,"title":"Cover Image Url","type":"string"},"width":{"description":"视频宽度，单位像素。","minimum":0,"title":"Width","type":"integer"},"height":{"description":"视频高度，单位像素。","minimum":0,"title":"Height","type":"integer"},"duration_ms":{"description":"视频时长，单位毫秒。","minimum":0,"title":"Duration Ms","type":"integer"},"play_count":{"description":"视频播放次数，不代表独立观看人数。","minimum":0,"title":"Play Count","type":"integer"}},"required":["video_url","cover_image_url","width","height","duration_ms","play_count"],"title":"TiebaUserPostVideo","type":"object"}},"properties":{"items":{"description":"当前页用户发布的主题帖，保留贴吧返回顺序。","items":{"$ref":"#/$defs/TiebaUserPostItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页令牌；为空表示本次可读取列表结束，不代表该用户全部历史帖子都已返回。","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":"TiebaUserPostsResult","type":"object"},"example":{"items":[{"thread_id":"10982085580","title":"视频讨论","summary":"帖子摘要","post_url":"https://tieba.baidu.com/p/10982085580","forum_id":"241762","forum_name":"ufc","author":{"user_id":"2922545293","name":"用户示例","avatar_url":"https://example.com/avatar.jpg","profile_url":"https://tieba.baidu.com/home/main?id=tb.1.deed3d91.Dzs_77peQwtE7uUK0yPJmQ"},"publish_time":1788018468,"update_time":1789834785,"like_count":12,"share_count":0,"reply_count":6,"view_count":292,"images":[],"videos":[{"video_url":"https://example.com/video.mp4","cover_image_url":"https://example.com/cover.jpg","width":392,"height":854,"duration_ms":26000,"play_count":5658}]}],"next_page_token":"opaque-baidu-tieba-user-posts-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["baidu_tieba_get_user_posts_by_user_id","baidu_tieba_get_user_posts_by_profile_url"]},{"operation_id":"baidu_tieba_get_user_info","platform_id":"baidu-tieba","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/baidu-tieba/user/info","summary":"获取百度贴吧用户信息","description":"通过百度贴吧数字用户 ID 或用户主页链接读取用户资料，返回显示名称、头像、签名、粉丝数、关注数、累计获赞、吧龄和 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":{"user_id":{"anyOf":[{"pattern":"^[1-9][0-9]{0,18}$","type":"string"},{"type":"null"}],"default":null,"description":"百度贴吧数字用户 ID，可取搜索、帖子详情或评论作者的 user_id；不是主页链接中的 portrait 或 tieba_uid。与 profile_url 二选一。","title":"User Id"},"profile_url":{"anyOf":[{"minLength":1,"type":"string"},{"type":"null"}],"default":null,"description":"百度贴吧用户主页完整链接，形如 https://tieba.baidu.com/home/main?id=…；可取搜索、详情或评论作者的 profile_url，不接受数字用户 ID、昵称或帖子链接。与 user_id 二选一。","title":"Profile Url"}},"title":"TiebaUserInfoRequest","type":"object"},"example":{"profile_url":"https://tieba.baidu.com/home/main?id=tb.1.deed3d91.Dzs_77peQwtE7uUK0yPJmQ"}},"response":{"content_type":"application/json","schema":{"properties":{"user_id":{"description":"用户 ID，以字符串表示，可用于查询用户资料。","title":"User Id","type":"string"},"name":{"description":"用户显示名称。","title":"Name","type":"string"},"avatar_url":{"description":"用户头像链接。","title":"Avatar Url","type":"string"},"profile_url":{"description":"用户主页链接，可用于再次查询用户资料。","title":"Profile Url","type":"string"},"bio":{"description":"用户个人签名；未提供时为空字符串。","title":"Bio","type":"string"},"follower_count":{"description":"粉丝数。","minimum":0,"title":"Follower Count","type":"integer"},"following_count":{"description":"关注数。","minimum":0,"title":"Following Count","type":"integer"},"received_like_count":{"description":"累计获赞数。","minimum":0,"title":"Received Like Count","type":"integer"},"tieba_age":{"description":"贴吧展示的吧龄，单位年，保留显示精度，例如 9.2；不是注册日期。","title":"Tieba Age","type":"string"},"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","follower_count","following_count","received_like_count","tieba_age","ip_location","points"],"title":"TiebaUserInfoResult","type":"object"},"example":{"user_id":"2922545293","name":"用户示例","avatar_url":"https://example.com/avatar.jpg","profile_url":"https://tieba.baidu.com/home/main?id=tb.1.deed3d91.Dzs_77peQwtE7uUK0yPJmQ","bio":"签名是一种态度，我想我可以更酷...","follower_count":243,"following_count":47,"received_like_count":5327,"tieba_age":"9.2","ip_location":"辽宁","points":{"cost":10,"balance":990}}},"related_mcp_tools":["baidu_tieba_get_user_info_by_profile_url","baidu_tieba_get_user_info_by_user_id"]},{"operation_id":"baidu_tieba_search_suggestions","platform_id":"baidu-tieba","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/baidu-tieba/search/suggestions","summary":"获取百度贴吧搜索建议","description":"获取百度贴吧搜索框的吧名联想词和相关贴吧信息，不搜索帖子或用户，不支持分页。items 与 forums 为两组独立结果，不保证一一对应；可将 forums 中的 forum_name 用于贴吧详情查询或吧内帖子关键词搜索。","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":"吧名关键词或前缀，例如 美食、旅行；不要传贴吧链接、帖子链接、ID 或分页令牌。","minLength":1,"title":"Keyword","type":"string"}},"required":["keyword"],"title":"TiebaSearchSuggestionsRequest","type":"object"},"example":{"keyword":"美食"}},"response":{"content_type":"application/json","schema":{"$defs":{"TiebaSearchSuggestionItem":{"properties":{"text":{"description":"吧名联想词。","minLength":1,"title":"Text","type":"string"}},"required":["text"],"title":"TiebaSearchSuggestionItem","type":"object"},"TiebaSuggestedForum":{"additionalProperties":false,"properties":{"forum_id":{"description":"贴吧 ID，以字符串表示。","pattern":"^[1-9][0-9]*$","title":"Forum Id","type":"string"},"forum_name":{"description":"准确贴吧名称，可直接用于贴吧详情查询或吧内帖子关键词搜索的 forum_name。","minLength":1,"title":"Forum Name","type":"string"},"forum_url":{"description":"贴吧主页链接，可直接打开或引用。","title":"Forum Url","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"贴吧头像链接；未提供时为 null。","title":"Avatar Url"},"slogan":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"贴吧标语；未提供时为 null。","title":"Slogan"},"member_count":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"贴吧关注人数（成员数）；未提供时为 null。","title":"Member Count"}},"required":["forum_id","forum_name","forum_url","avatar_url","slogan","member_count"],"title":"TiebaSuggestedForum","type":"object"}},"properties":{"items":{"description":"吧名联想词列表，保持返回顺序；无建议时为空数组。","items":{"$ref":"#/$defs/TiebaSearchSuggestionItem"},"title":"Items","type":"array"},"forums":{"description":"相关贴吧列表，保持返回顺序；与 items 不保证一一对应，无相关贴吧时为空数组。","items":{"$ref":"#/$defs/TiebaSuggestedForum"},"title":"Forums","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","forums","points"],"title":"TiebaSearchSuggestionsResult","type":"object"},"example":{"items":[{"text":"美食的俘虏"},{"text":"美食"}],"forums":[{"forum_id":"40","forum_name":"美食","forum_url":"https://tieba.baidu.com/f?kw=%E7%BE%8E%E9%A3%9F","avatar_url":"http://tiebapic.baidu.com/forum/w%3D120%3Bh%3D120/sign=3af247e21466d0167e199a2aa710bc3a/42166d224f4a20a4450af8e8d6529822720ed08d.jpg?tbpicau=2026-10-09-05_6f231c33ead2ff1e491757529b482bdb","slogan":"食前方丈，水陆杂陈。食甘寝安，食来运转！","member_count":4943287}],"points":{"cost":10,"balance":990}}},"related_mcp_tools":["baidu_tieba_search_suggestions"]},{"operation_id":"baidu_tieba_search_users","platform_id":"baidu-tieba","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/baidu-tieba/search/users","summary":"搜索百度贴吧用户","description":"按关键词查找百度贴吧用户，返回精确匹配和相关用户两组单页结果，不支持分页。可将结果中的 profile_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":{"keyword":{"description":"用户名称关键词，例如 美食、旅行；不要传用户主页链接、数字用户 ID 或分页令牌。","minLength":1,"title":"Keyword","type":"string"}},"required":["keyword"],"title":"TiebaUserSearchRequest","type":"object"},"example":{"keyword":"美食"}},"response":{"content_type":"application/json","schema":{"$defs":{"TiebaUserSearchItem":{"additionalProperties":false,"properties":{"user_id":{"description":"用户 ID，以字符串表示。","pattern":"^[1-9][0-9]{0,18}$","title":"User Id","type":"string"},"name":{"description":"用户显示名称。","minLength":1,"title":"Name","type":"string"},"avatar_url":{"description":"用户头像链接。","minLength":1,"title":"Avatar Url","type":"string"},"profile_url":{"description":"用户主页链接。","minLength":1,"title":"Profile Url","type":"string"},"bio":{"description":"用户个人简介；未提供时为空字符串。","title":"Bio","type":"string"},"follower_count":{"description":"粉丝数。","minimum":0,"title":"Follower Count","type":"integer"}},"required":["user_id","name","avatar_url","profile_url","bio","follower_count"],"title":"TiebaUserSearchItem","type":"object"}},"properties":{"exact_matches":{"description":"精确匹配用户列表；没有精确匹配时为空数组。","items":{"$ref":"#/$defs/TiebaUserSearchItem"},"title":"Exact Matches","type":"array"},"related_users":{"description":"相关用户列表，保持贴吧返回顺序；没有相关用户时为空数组。","items":{"$ref":"#/$defs/TiebaUserSearchItem"},"title":"Related Users","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":["exact_matches","related_users","points"],"title":"TiebaUserSearchResult","type":"object"},"example":{"exact_matches":[{"user_id":"63072","name":"美食","avatar_url":"https://gss0.bdstatic.com/6LZ1dD3d1sgCo2Kml5_Y_D3/sys/portrait/item/tb.1.e9567c9a.wndClBkGl7dsNb5FojElag?t=1790130512.jpg","profile_url":"https://tieba.baidu.com/home/main?id=tb.1.e9567c9a.wndClBkGl7dsNb5FojElag%3Ft%3D1790130512.jpg&fr=frs","bio":"http://bolechina.com","follower_count":2510}],"related_users":[{"user_id":"4061353267","name":"美食美食我爱你🐾","avatar_url":"https://gss0.bdstatic.com/6LZ1dD3d1sgCo2Kml5_Y_D3/sys/portrait/item/tb.1.24d59607.CN4UcwF_YZQVRw16V3w8aw?t=1552836210.jpg","profile_url":"https://tieba.baidu.com/home/main?id=tb.1.24d59607.CN4UcwF_YZQVRw16V3w8aw%3Ft%3D1552836210.jpg&fr=frs","bio":"","follower_count":1982}],"points":{"cost":10,"balance":990}}},"related_mcp_tools":["baidu_tieba_search_users"]},{"operation_id":"baidu_tieba_search_posts_in_forum","platform_id":"baidu-tieba","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/baidu-tieba/search/forum/posts","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":{"forum_name":{"description":"准确贴吧名称，例如 方便面；直接使用结果中的 forum_name，不要自行追加“吧”字；不要传 URL 或数字 ID，无需 URL 编码。","minLength":1,"title":"Forum Name","type":"string"},"keyword":{"description":"在指定贴吧中搜索的关键词或短语；不要传帖子链接或分页令牌。","minLength":1,"title":"Keyword","type":"string"},"sort_type":{"default":"newest","description":"排序方式：newest 为最新（默认），relevance 为相关；relevant 仅兼容旧调用，新调用请使用 relevance。结果顺序以贴吧返回为准。","enum":["newest","relevance","relevant"],"title":"Sort Type","type":"string"},"page_token":{"default":"","description":"分页令牌；首次留空，续页原样传入本接口返回的 next_page_token，保持 forum_name、keyword、sort_type 不变；不要使用其他搜索接口的令牌。","title":"Page Token","type":"string"}},"required":["forum_name","keyword"],"title":"TiebaForumSearchRequest","type":"object"},"example":{"forum_name":"方便面","keyword":"方便面","sort_type":"newest","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"TiebaPostSearchItem":{"properties":{"thread_id":{"description":"主题帖 ID，以字符串表示。","title":"Thread Id","type":"string"},"title":{"description":"帖子标题。","title":"Title","type":"string"},"author":{"$ref":"#/$defs/TiebaSearchAuthor","description":"帖子作者。"},"summary":{"description":"搜索结果摘要，不是完整正文。","title":"Summary","type":"string"},"images":{"description":"搜索结果提供的图片，可能不完整；空数组表示本次未提供，不代表帖子没有图片。","items":{"$ref":"#/$defs/TiebaSearchImage"},"title":"Images","type":"array"},"videos":{"description":"搜索结果提供的视频，可能不完整；空数组表示本次未提供，不代表帖子没有视频。","items":{"$ref":"#/$defs/TiebaSearchVideo"},"title":"Videos","type":"array"},"post_url":{"description":"帖子页面链接。","title":"Post Url","type":"string"},"forum_id":{"description":"所属贴吧 ID，以字符串表示。","title":"Forum Id","type":"string"},"forum_name":{"description":"帖子所属贴吧名称。","title":"Forum Name","type":"string"},"publish_time":{"description":"发帖时间，秒级 Unix 时间戳。","title":"Publish Time","type":"integer"},"update_time":{"description":"更新时间，秒级 Unix 时间戳。","title":"Update Time","type":"integer"},"like_count":{"description":"点赞数。","title":"Like Count","type":"integer"},"share_count":{"description":"分享数。","title":"Share Count","type":"integer"}},"required":["thread_id","title","author","summary","images","videos","post_url","forum_id","forum_name","publish_time","update_time","like_count","share_count"],"title":"TiebaPostSearchItem","type":"object"},"TiebaSearchAuthor":{"properties":{"user_id":{"description":"作者用户 ID，以字符串表示；匿名历史帖子为空字符串。","title":"User Id","type":"string"},"name":{"description":"作者显示名称；匿名历史帖子为空字符串。","title":"Name","type":"string"},"avatar_url":{"description":"作者头像链接；匿名历史帖子为贴吧默认头像。","title":"Avatar Url","type":"string"},"profile_url":{"description":"作者贴吧主页链接；默认头像或匿名历史帖子为空字符串。","title":"Profile Url","type":"string"}},"required":["user_id","name","avatar_url","profile_url"],"title":"TiebaSearchAuthor","type":"object"},"TiebaSearchImage":{"properties":{"url":{"description":"搜索结果提供的原图链接，可能有有效期；不保证图片无水印。","minLength":1,"title":"Url","type":"string"},"width":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"原图宽度，单位像素；未提供时为 null。","title":"Width"},"height":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"原图高度，单位像素；未提供时为 null。","title":"Height"}},"required":["url","width","height"],"title":"TiebaSearchImage","type":"object"},"TiebaSearchVideo":{"properties":{"video_url":{"description":"搜索结果提供的视频播放地址，可能有有效期。","minLength":1,"title":"Video Url","type":"string"},"cover_image_url":{"description":"视频封面图片地址。","minLength":1,"title":"Cover Image Url","type":"string"},"width":{"description":"视频宽度，单位像素。","minimum":0,"title":"Width","type":"integer"},"height":{"description":"视频高度，单位像素。","minimum":0,"title":"Height","type":"integer"},"duration_ms":{"description":"视频时长，单位毫秒。","minimum":0,"title":"Duration Ms","type":"integer"},"play_count":{"description":"视频播放次数，不代表独立观看人数。","minimum":0,"title":"Play Count","type":"integer"}},"required":["video_url","cover_image_url","width","height","duration_ms","play_count"],"title":"TiebaSearchVideo","type":"object"}},"properties":{"items":{"description":"当前页帖子列表。","items":{"$ref":"#/$defs/TiebaPostSearchItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页完整分页令牌；为空表示没有更多结果。","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":"TiebaPostSearchResult","type":"object"},"example":{"items":[{"thread_id":"11039906183","images":[{"url":"https://tiebapic.baidu.com/forum/pic/item/example.jpg","width":null,"height":null}],"videos":[],"title":"方便面讨论","summary":"讨论喜欢的方便面。","post_url":"https://tieba.baidu.com/p/11039906183","author":{"user_id":"6006276382","name":"作者","avatar_url":"https://example.com/avatar.jpg","profile_url":"https://tieba.baidu.com/home/main?id=tb.1.demo"},"forum_id":"49984","forum_name":"方便面","publish_time":1789922502,"update_time":1789958065,"like_count":9,"share_count":0}],"next_page_token":"opaque-baidu-tieba-forum-search-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["baidu_tieba_search_posts_in_forum"]},{"operation_id":"baidu_tieba_search_general","platform_id":"baidu-tieba","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/baidu-tieba/search/general","summary":"百度贴吧综合搜索","description":"按关键词获取百度贴吧综合搜索中的帖子，保留综合结果中的帖子顺序，返回标题、摘要、作者、所属吧、时间、互动数和链接。不返回吧、用户、话题、推荐话题或搜索建议。需要最新、最早或相关排序时使用帖子搜索，读取指定帖子链接或 ID 使用帖子详情。支持分页，不提供排序选项。当前页可能没有帖子；next_page_token 非空时仍可继续翻页，结果随贴吧实时变化。同时返回搜索结果提供的图片和视频，媒体可能不完整，无法据此判断帖子媒体总数。","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":"Shared flat input contract for general-search HTTP and MCP.","properties":{"keyword":{"description":"搜索词或关键词短语，例如 摄影、旅行攻略；不要传帖子链接或分页令牌。","minLength":1,"title":"Keyword","type":"string"},"page_token":{"default":"","description":"分页令牌；首次留空，续页原样传回综合搜索返回的 next_page_token，并保持 keyword 不变；即使 items 为空，只要令牌非空仍可继续翻页。不要使用帖子搜索或评论的分页令牌。","title":"Page Token","type":"string"}},"required":["keyword"],"title":"TiebaGeneralSearchRequest","type":"object"},"example":{"keyword":"方便面","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"TiebaPostSearchItem":{"properties":{"thread_id":{"description":"主题帖 ID，以字符串表示。","title":"Thread Id","type":"string"},"title":{"description":"帖子标题。","title":"Title","type":"string"},"author":{"$ref":"#/$defs/TiebaSearchAuthor","description":"帖子作者。"},"summary":{"description":"搜索结果摘要，不是完整正文。","title":"Summary","type":"string"},"images":{"description":"搜索结果提供的图片，可能不完整；空数组表示本次未提供，不代表帖子没有图片。","items":{"$ref":"#/$defs/TiebaSearchImage"},"title":"Images","type":"array"},"videos":{"description":"搜索结果提供的视频，可能不完整；空数组表示本次未提供，不代表帖子没有视频。","items":{"$ref":"#/$defs/TiebaSearchVideo"},"title":"Videos","type":"array"},"post_url":{"description":"帖子页面链接。","title":"Post Url","type":"string"},"forum_id":{"description":"所属贴吧 ID，以字符串表示。","title":"Forum Id","type":"string"},"forum_name":{"description":"帖子所属贴吧名称。","title":"Forum Name","type":"string"},"publish_time":{"description":"发帖时间，秒级 Unix 时间戳。","title":"Publish Time","type":"integer"},"update_time":{"description":"更新时间，秒级 Unix 时间戳。","title":"Update Time","type":"integer"},"like_count":{"description":"点赞数。","title":"Like Count","type":"integer"},"share_count":{"description":"分享数。","title":"Share Count","type":"integer"}},"required":["thread_id","title","author","summary","images","videos","post_url","forum_id","forum_name","publish_time","update_time","like_count","share_count"],"title":"TiebaPostSearchItem","type":"object"},"TiebaSearchAuthor":{"properties":{"user_id":{"description":"作者用户 ID，以字符串表示；匿名历史帖子为空字符串。","title":"User Id","type":"string"},"name":{"description":"作者显示名称；匿名历史帖子为空字符串。","title":"Name","type":"string"},"avatar_url":{"description":"作者头像链接；匿名历史帖子为贴吧默认头像。","title":"Avatar Url","type":"string"},"profile_url":{"description":"作者贴吧主页链接；默认头像或匿名历史帖子为空字符串。","title":"Profile Url","type":"string"}},"required":["user_id","name","avatar_url","profile_url"],"title":"TiebaSearchAuthor","type":"object"},"TiebaSearchImage":{"properties":{"url":{"description":"搜索结果提供的原图链接，可能有有效期；不保证图片无水印。","minLength":1,"title":"Url","type":"string"},"width":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"原图宽度，单位像素；未提供时为 null。","title":"Width"},"height":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"原图高度，单位像素；未提供时为 null。","title":"Height"}},"required":["url","width","height"],"title":"TiebaSearchImage","type":"object"},"TiebaSearchVideo":{"properties":{"video_url":{"description":"搜索结果提供的视频播放地址，可能有有效期。","minLength":1,"title":"Video Url","type":"string"},"cover_image_url":{"description":"视频封面图片地址。","minLength":1,"title":"Cover Image Url","type":"string"},"width":{"description":"视频宽度，单位像素。","minimum":0,"title":"Width","type":"integer"},"height":{"description":"视频高度，单位像素。","minimum":0,"title":"Height","type":"integer"},"duration_ms":{"description":"视频时长，单位毫秒。","minimum":0,"title":"Duration Ms","type":"integer"},"play_count":{"description":"视频播放次数，不代表独立观看人数。","minimum":0,"title":"Play Count","type":"integer"}},"required":["video_url","cover_image_url","width","height","duration_ms","play_count"],"title":"TiebaSearchVideo","type":"object"}},"properties":{"items":{"description":"当前页帖子列表。","items":{"$ref":"#/$defs/TiebaPostSearchItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页完整分页令牌；为空表示没有更多结果。","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":"TiebaPostSearchResult","type":"object"},"example":{"items":[{"thread_id":"11039906183","images":[{"url":"https://tiebapic.baidu.com/forum/pic/item/example.jpg","width":null,"height":null}],"videos":[],"title":"方便面讨论","summary":"讨论喜欢的方便面。","post_url":"https://tieba.baidu.com/p/11039906183","author":{"user_id":"6006276382","name":"作者","avatar_url":"https://example.com/avatar.jpg","profile_url":"https://tieba.baidu.com/home/main?id=tb.1.demo"},"forum_id":"49984","forum_name":"方便面","publish_time":1789922502,"update_time":1789958065,"like_count":9,"share_count":0}],"next_page_token":"opaque-baidu-tieba-general-search-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["baidu_tieba_search_general"]},{"operation_id":"baidu_tieba_get_post_detail","platform_id":"baidu-tieba","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/baidu-tieba/post/detail","summary":"获取百度贴吧帖子详情","description":"按 thread_id 或 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":{"thread_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"主题帖数字 ID，可取搜索结果的 thread_id；不要传帖子链接。","title":"Thread Id"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"百度贴吧主题帖完整链接，可取搜索结果的 post_url；与 thread_id 二选一。","title":"Url"}},"title":"TiebaDetailRequest","type":"object"},"example":{"thread_id":"11039906183"}},"response":{"content_type":"application/json","schema":{"$defs":{"TiebaPostDetailImage":{"properties":{"url":{"description":"帖子原图链接，可能有有效期；不保证图片无水印。","title":"Url","type":"string"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"原图宽度，像素；未提供时为 null。","title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"原图高度，像素；未提供时为 null。","title":"Height"}},"required":["url"],"title":"TiebaPostDetailImage","type":"object"},"TiebaPostDetailVideo":{"properties":{"video_url":{"description":"视频播放链接；有效期可能有限。","title":"Video Url","type":"string"},"cover_image_url":{"description":"视频封面图片链接。","title":"Cover Image Url","type":"string"},"width":{"description":"视频宽度，像素。","title":"Width","type":"integer"},"height":{"description":"视频高度，像素。","title":"Height","type":"integer"},"duration_ms":{"description":"视频时长，单位毫秒。","title":"Duration Ms","type":"integer"}},"required":["video_url","cover_image_url","width","height","duration_ms"],"title":"TiebaPostDetailVideo","type":"object"},"TiebaSearchAuthor":{"properties":{"user_id":{"description":"作者用户 ID，以字符串表示；匿名历史帖子为空字符串。","title":"User Id","type":"string"},"name":{"description":"作者显示名称；匿名历史帖子为空字符串。","title":"Name","type":"string"},"avatar_url":{"description":"作者头像链接；匿名历史帖子为贴吧默认头像。","title":"Avatar Url","type":"string"},"profile_url":{"description":"作者贴吧主页链接；默认头像或匿名历史帖子为空字符串。","title":"Profile Url","type":"string"}},"required":["user_id","name","avatar_url","profile_url"],"title":"TiebaSearchAuthor","type":"object"}},"properties":{"thread_id":{"description":"主题帖 ID，以字符串表示。","title":"Thread Id","type":"string"},"title":{"description":"帖子标题。","title":"Title","type":"string"},"content":{"description":"首楼正文纯文本；表情以“[表情]”表示；无可见正文时为空字符串。","title":"Content","type":"string"},"post_url":{"description":"帖子页面链接。","title":"Post Url","type":"string"},"publish_time":{"description":"发帖时间，秒级 Unix 时间戳。","title":"Publish Time","type":"integer"},"author":{"$ref":"#/$defs/TiebaSearchAuthor","description":"帖子作者。"},"forum_id":{"description":"所属贴吧 ID，以字符串表示。","title":"Forum Id","type":"string"},"forum_name":{"description":"帖子所属贴吧名称。","title":"Forum Name","type":"string"},"images":{"description":"首楼图片列表。","items":{"$ref":"#/$defs/TiebaPostDetailImage"},"title":"Images","type":"array"},"videos":{"description":"首楼视频列表。","items":{"$ref":"#/$defs/TiebaPostDetailVideo"},"title":"Videos","type":"array"},"like_count":{"description":"帖子获赞数。","title":"Like Count","type":"integer"},"share_count":{"description":"帖子分享数。","title":"Share Count","type":"integer"},"collect_count":{"description":"帖子收藏数。","title":"Collect Count","type":"integer"},"reply_count":{"description":"帖子回复数。","title":"Reply Count","type":"integer"},"floor_count":{"description":"主题帖有效楼层数。","title":"Floor 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":["thread_id","title","content","post_url","publish_time","author","forum_id","forum_name","images","videos","like_count","share_count","collect_count","reply_count","floor_count","points"],"title":"TiebaPostDetailResult","type":"object"},"example":{"thread_id":"11039906183","title":"方便面 goat 来了（我心中的），闲杂面等通通闪开！","content":"第一次吃这个方便面，我就能感受到区别于其他面的不同。","post_url":"https://tieba.baidu.com/p/11039906183","publish_time":1789922502,"author":{"user_id":"6006276382","name":"养生堂堂主胡桃","avatar_url":"https://gss0.bdstatic.com/.../tb.1.99fa0954.JnJ_h6XZ_ogY-_VjZ-Ccmg?t=1790048121","profile_url":"https://tieba.baidu.com/home/main?id=tb.1.99fa0954.JnJ_h6XZ_ogY-_VjZ-Ccmg%3Ft%3D1790048121&fr=frs"},"forum_id":"49984","forum_name":"方便面","images":[{"url":"https://tiebapic.baidu.com/forum/pic/item/example.jpg","width":null,"height":null}],"videos":[],"like_count":16,"share_count":0,"collect_count":2,"reply_count":6,"floor_count":5,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["baidu_tieba_get_post_detail_by_thread_id","baidu_tieba_get_post_detail_by_url"]},{"operation_id":"baidu_tieba_get_post_comment_replies","platform_id":"baidu-tieba","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/baidu-tieba/post/comment/reply/list","summary":"获取百度贴吧楼中楼回复","description":"按主题帖 ID 和一级评论 ID 读取该评论下的楼中楼回复，返回回复正文、作者、发布时间、点赞数、作者 IP 属地、提及用户及所属一级评论 ID。comment_id 取一级评论列表的 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":{"thread_id":{"description":"主题帖数字 ID；使用查询一级评论时的 thread_id，也可取帖子搜索结果的 thread_id。","pattern":"^[1-9][0-9]*$","title":"Thread Id","type":"string"},"comment_id":{"description":"一级评论 ID，取一级评论结果的 comment_id 或本工具结果的 parent_comment_id；不要传楼中楼回复自身的 comment_id。","pattern":"^[1-9][0-9]*$","title":"Comment Id","type":"string"},"page_token":{"default":"","description":"分页令牌；首次留空，续页原样传入上一页 next_page_token，并保持 thread_id 和 comment_id 不变；不要使用搜索、一级评论或其它楼层的令牌。","title":"Page Token","type":"string"}},"required":["thread_id","comment_id"],"title":"TiebaCommentRepliesRequest","type":"object"},"example":{"thread_id":"7901101471","comment_id":"144602260281","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"TiebaCommentAuthor":{"properties":{"user_id":{"description":"评论作者用户 ID，以字符串表示；匿名评论为空字符串。","title":"User Id","type":"string"},"name":{"description":"评论作者显示名称；匿名评论为空字符串。","title":"Name","type":"string"},"avatar_url":{"description":"评论作者头像链接；匿名评论时为贴吧默认头像，不代表真实用户头像。","title":"Avatar Url","type":"string"},"profile_url":{"description":"评论作者贴吧主页链接；匿名评论为空字符串。","title":"Profile Url","type":"string"}},"required":["user_id","name","avatar_url","profile_url"],"title":"TiebaCommentAuthor","type":"object"},"TiebaCommentReplyItem":{"properties":{"comment_id":{"description":"楼中楼回复自身的 ID；不是回复列表入口所需的一级评论 ID。","title":"Comment Id","type":"string"},"parent_comment_id":{"description":"所属一级评论 ID，可用于继续查询该楼层的回复。","title":"Parent Comment Id","type":"string"},"content":{"description":"回复正文纯文本，保留提及的用户名称；表情显示为[表情]。","title":"Content","type":"string"},"publish_time":{"description":"回复发布时间，秒级 Unix 时间戳。","title":"Publish Time","type":"integer"},"like_count":{"description":"回复点赞数。","title":"Like Count","type":"integer"},"author":{"$ref":"#/$defs/TiebaCommentAuthor","description":"回复作者。"},"ip_location":{"description":"作者 IP 属地；未提供时为空字符串，不能据此认定为评论发表时的位置。","title":"Ip Location","type":"string"},"mentioned_users":{"description":"正文中可识别的提及用户，按出现顺序返回；无可识别提及时为空数组，不等同于被回复的评论关系。","items":{"$ref":"#/$defs/TiebaMentionedUser"},"title":"Mentioned Users","type":"array"}},"required":["comment_id","parent_comment_id","content","publish_time","like_count","author","ip_location","mentioned_users"],"title":"TiebaCommentReplyItem","type":"object"},"TiebaMentionedUser":{"properties":{"user_id":{"description":"被提及用户的 ID，以字符串表示。","title":"User Id","type":"string"},"name":{"description":"提及处的显示文本，可能包含 @ 前缀。","title":"Name","type":"string"}},"required":["user_id","name"],"title":"TiebaMentionedUser","type":"object"}},"properties":{"items":{"description":"当前页楼中楼回复，按贴吧返回顺序排列。","items":{"$ref":"#/$defs/TiebaCommentReplyItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页完整分页令牌；为空表示没有更多结果。","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":"TiebaCommentRepliesResult","type":"object"},"example":{"items":[{"comment_id":"144605012757","parent_comment_id":"144602260281","content":"回复 用户示例：这是一条楼中楼回复。","publish_time":1656563131,"like_count":1,"ip_location":"浙江","mentioned_users":[{"user_id":"1190743044","name":"用户示例"}],"author":{"user_id":"17596390979173","name":"回复作者","avatar_url":"https://example.com/avatar.jpg","profile_url":"https://tieba.baidu.com/home/main?id=tb.1.demo"}}],"next_page_token":"opaque-baidu-tieba-replies-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["baidu_tieba_get_post_comment_replies"]},{"operation_id":"baidu_tieba_get_post_comments","platform_id":"baidu-tieba","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/baidu-tieba/post/comment/list","summary":"获取百度贴吧帖子评论","description":"按百度贴吧主题帖 ID 或帖子链接读取一级评论，返回评论正文、楼层、作者、发布时间、点赞数、楼中楼回复数、作者 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":{"thread_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"主题帖数字 ID，可取搜索结果的 thread_id；不要传帖子链接。与 url 二选一。","title":"Thread Id"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"百度贴吧主题帖完整链接，可取搜索结果的 post_url，支持 /p/数字ID/；不要传纯 ID。与 thread_id 二选一。","title":"Url"},"page_token":{"default":"","description":"分页令牌；首次留空。续页将上一页完整 next_page_token 原样传回，并保持同一帖子与 sort_type 不变；不要使用搜索或其他帖子的分页令牌。","title":"Page Token","type":"string"},"sort_type":{"default":"hot","description":"评论排序请求：hot 请求热门评论（默认），newest 请求最新评论，oldest 请求最早评论；实际返回顺序以贴吧为准。","enum":["newest","oldest","hot"],"title":"Sort Type","type":"string"}},"title":"TiebaCommentsRequest","type":"object"},"example":{"thread_id":"11039906183","page_token":"","sort_type":"hot"}},"response":{"content_type":"application/json","schema":{"$defs":{"TiebaCommentAuthor":{"properties":{"user_id":{"description":"评论作者用户 ID，以字符串表示；匿名评论为空字符串。","title":"User Id","type":"string"},"name":{"description":"评论作者显示名称；匿名评论为空字符串。","title":"Name","type":"string"},"avatar_url":{"description":"评论作者头像链接；匿名评论时为贴吧默认头像，不代表真实用户头像。","title":"Avatar Url","type":"string"},"profile_url":{"description":"评论作者贴吧主页链接；匿名评论为空字符串。","title":"Profile Url","type":"string"}},"required":["user_id","name","avatar_url","profile_url"],"title":"TiebaCommentAuthor","type":"object"},"TiebaCommentItem":{"properties":{"comment_id":{"description":"评论 ID，以字符串表示。","title":"Comment Id","type":"string"},"floor":{"description":"评论在主题帖内的楼层号；不是评论 ID、页码或当前页序号。","title":"Floor","type":"integer"},"content":{"description":"评论正文纯文本；表情以“[表情]”表示。","title":"Content","type":"string"},"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"},"has_replies":{"description":"该一级评论是否存在楼中楼回复；接口不返回楼中楼回复的具体内容。","title":"Has Replies","type":"boolean"},"author":{"$ref":"#/$defs/TiebaCommentAuthor","description":"评论作者。"},"ip_location":{"description":"作者 IP 属地；未提供时为空字符串，不能据此认定为评论发表时的位置。","title":"Ip Location","type":"string"},"mentioned_users":{"description":"正文中可识别的提及用户，按出现顺序返回；无可识别提及时为空数组，不等同于被回复的评论关系。","items":{"$ref":"#/$defs/TiebaMentionedUser"},"title":"Mentioned Users","type":"array"}},"required":["comment_id","floor","content","publish_time","like_count","reply_count","has_replies","author","ip_location","mentioned_users"],"title":"TiebaCommentItem","type":"object"},"TiebaMentionedUser":{"properties":{"user_id":{"description":"被提及用户的 ID，以字符串表示。","title":"User Id","type":"string"},"name":{"description":"提及处的显示文本，可能包含 @ 前缀。","title":"Name","type":"string"}},"required":["user_id","name"],"title":"TiebaMentionedUser","type":"object"}},"properties":{"items":{"description":"当前页一级评论列表。","items":{"$ref":"#/$defs/TiebaCommentItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页完整分页令牌；为空表示没有更多结果。","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":"TiebaCommentsResult","type":"object"},"example":{"items":[{"comment_id":"153954017783","floor":2,"content":"这是一条评论。","ip_location":"江苏","mentioned_users":[],"publish_time":1789922502,"like_count":3,"reply_count":0,"has_replies":false,"author":{"user_id":"6006276382","name":"评论作者","avatar_url":"https://example.com/avatar.jpg","profile_url":"https://tieba.baidu.com/home/main?id=tb.1.demo"}}],"next_page_token":"opaque-baidu-tieba-comments-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["baidu_tieba_get_post_comments_by_thread_id","baidu_tieba_get_post_comments_by_url"]},{"operation_id":"baidu_tieba_search_posts","platform_id":"baidu-tieba","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/baidu-tieba/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":{"description":"搜索词或关键词短语，例如 方便面、旅行攻略；不要传帖子链接、帖子 ID 或分页令牌。需要限定某个贴吧时使用吧内帖子搜索。","minLength":1,"title":"Keyword","type":"string"},"page_token":{"default":"","description":"分页令牌；首次留空。续页将上一页完整 next_page_token 原样传回，并保持 keyword 与 sort_type 不变。","title":"Page Token","type":"string"},"sort_type":{"default":"newest","description":"排序方式：newest 为最新、oldest 为最早、relevance 为相关。","enum":["newest","oldest","relevance"],"title":"Sort Type","type":"string"}},"required":["keyword"],"title":"TiebaSearchRequest","type":"object"},"example":{"keyword":"方便面","page_token":"","sort_type":"newest"}},"response":{"content_type":"application/json","schema":{"$defs":{"TiebaPostSearchItem":{"properties":{"thread_id":{"description":"主题帖 ID，以字符串表示。","title":"Thread Id","type":"string"},"title":{"description":"帖子标题。","title":"Title","type":"string"},"author":{"$ref":"#/$defs/TiebaSearchAuthor","description":"帖子作者。"},"summary":{"description":"搜索结果摘要，不是完整正文。","title":"Summary","type":"string"},"images":{"description":"搜索结果提供的图片，可能不完整；空数组表示本次未提供，不代表帖子没有图片。","items":{"$ref":"#/$defs/TiebaSearchImage"},"title":"Images","type":"array"},"videos":{"description":"搜索结果提供的视频，可能不完整；空数组表示本次未提供，不代表帖子没有视频。","items":{"$ref":"#/$defs/TiebaSearchVideo"},"title":"Videos","type":"array"},"post_url":{"description":"帖子页面链接。","title":"Post Url","type":"string"},"forum_id":{"description":"所属贴吧 ID，以字符串表示。","title":"Forum Id","type":"string"},"forum_name":{"description":"帖子所属贴吧名称。","title":"Forum Name","type":"string"},"publish_time":{"description":"发帖时间，秒级 Unix 时间戳。","title":"Publish Time","type":"integer"},"update_time":{"description":"更新时间，秒级 Unix 时间戳。","title":"Update Time","type":"integer"},"like_count":{"description":"点赞数。","title":"Like Count","type":"integer"},"share_count":{"description":"分享数。","title":"Share Count","type":"integer"}},"required":["thread_id","title","author","summary","images","videos","post_url","forum_id","forum_name","publish_time","update_time","like_count","share_count"],"title":"TiebaPostSearchItem","type":"object"},"TiebaSearchAuthor":{"properties":{"user_id":{"description":"作者用户 ID，以字符串表示；匿名历史帖子为空字符串。","title":"User Id","type":"string"},"name":{"description":"作者显示名称；匿名历史帖子为空字符串。","title":"Name","type":"string"},"avatar_url":{"description":"作者头像链接；匿名历史帖子为贴吧默认头像。","title":"Avatar Url","type":"string"},"profile_url":{"description":"作者贴吧主页链接；默认头像或匿名历史帖子为空字符串。","title":"Profile Url","type":"string"}},"required":["user_id","name","avatar_url","profile_url"],"title":"TiebaSearchAuthor","type":"object"},"TiebaSearchImage":{"properties":{"url":{"description":"搜索结果提供的原图链接，可能有有效期；不保证图片无水印。","minLength":1,"title":"Url","type":"string"},"width":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"原图宽度，单位像素；未提供时为 null。","title":"Width"},"height":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"原图高度，单位像素；未提供时为 null。","title":"Height"}},"required":["url","width","height"],"title":"TiebaSearchImage","type":"object"},"TiebaSearchVideo":{"properties":{"video_url":{"description":"搜索结果提供的视频播放地址，可能有有效期。","minLength":1,"title":"Video Url","type":"string"},"cover_image_url":{"description":"视频封面图片地址。","minLength":1,"title":"Cover Image Url","type":"string"},"width":{"description":"视频宽度，单位像素。","minimum":0,"title":"Width","type":"integer"},"height":{"description":"视频高度，单位像素。","minimum":0,"title":"Height","type":"integer"},"duration_ms":{"description":"视频时长，单位毫秒。","minimum":0,"title":"Duration Ms","type":"integer"},"play_count":{"description":"视频播放次数，不代表独立观看人数。","minimum":0,"title":"Play Count","type":"integer"}},"required":["video_url","cover_image_url","width","height","duration_ms","play_count"],"title":"TiebaSearchVideo","type":"object"}},"properties":{"items":{"description":"当前页帖子列表。","items":{"$ref":"#/$defs/TiebaPostSearchItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页完整分页令牌；为空表示没有更多结果。","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":"TiebaPostSearchResult","type":"object"},"example":{"items":[{"thread_id":"11039906183","images":[{"url":"https://tiebapic.baidu.com/forum/pic/item/example.jpg","width":null,"height":null}],"videos":[],"title":"方便面 goat 来了（我心中的），闲杂面等通通闪开！","author":{"user_id":"6006276382","name":"养生堂堂主胡桃","avatar_url":"https://gss0.bdstatic.com/6LZ1dD3d1sgCo2Kml5_Y_D3/sys/portrait/item/tb.1.99fa0954.JnJ_h6XZ_ogY-_VjZ-Ccmg?t=1718120055","profile_url":"https://tieba.baidu.com/home/main?id=tb.1.99fa0954.JnJ_h6XZ_ogY-_VjZ-Ccmg%3Ft%3D1718120055&fr=frs"},"summary":"第一次吃这个方便面，我就能感受到区别于其他面的不同。","post_url":"https://tieba.baidu.com/p/11039906183","forum_id":"49984","forum_name":"方便面","publish_time":1789922502,"update_time":1789958065,"like_count":9,"share_count":0}],"next_page_token":"opaque-baidu-tieba-search-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["baidu_tieba_search_posts"]}]},{"surface":"mcp","status":"available","endpoint":"https://mcp.socialdatax.com/baidu-tieba/mcp","authentication":{"required":true},"capabilities_resource":"resource://baidu-tieba/search-guide","related_http_operation_ids":["baidu_tieba_search_suggestions","baidu_tieba_search_users","baidu_tieba_get_post_comment_replies","baidu_tieba_get_post_comments","baidu_tieba_get_post_detail","baidu_tieba_search_general","baidu_tieba_search_posts_in_forum","baidu_tieba_get_user_info","baidu_tieba_get_user_posts","baidu_tieba_get_user_followed_forums","baidu_tieba_get_forum_detail","baidu_tieba_get_forum_posts","baidu_tieba_search_posts"]}]},{"platform_id":"wechat","label":"微信","english_label":"WeChat","status":"available","surfaces":[{"surface":"http","status":"available","base_path":"/socialdatax/api/v1/wechat","description":"公开微信 HTTP API 提供视频号内容与用户接口，以及微信公众号文章详情和互动统计。","operation_groups":[{"group_id":"video_channels","label":"视频号","english_label":"WeChat Channels","operation_ids":["wechat_get_hot_search_list","wechat_search_videos","wechat_search_finder_user","wechat_get_video_detail","wechat_get_video_share_url","wechat_get_video_comments","wechat_get_video_comment_replies","wechat_get_user_info","wechat_get_user_posted_videos"]},{"group_id":"official_account","label":"公众号","english_label":"Official Account","operation_ids":["wechat_search_mp_articles","wechat_get_mp_article_detail_by_url","wechat_get_mp_account_info_by_account_id","wechat_get_mp_account_articles_by_account_id","wechat_get_mp_article_stats_by_url","wechat_get_mp_article_comments_by_url","wechat_get_mp_article_comment_replies_by_url"]}],"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":["wechat_search_finder_user"]},{"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_share_url","platform_id":"wechat","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/wechat/video/share/url","summary":"生成微信视频号作品分享链接","description":"按微信视频号作品 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":{"object_id":{"title":"Object Id","type":"string","description":"微信视频号作品 object_id；可从作品详情或用户发布作品列表结果获取。只接受正整数 object_id，不接受 encrypted_object_id 或作品链接。"}},"required":["object_id"],"title":"InternalWechatVideoShareUrlRequest","type":"object"},"example":{"object_id":"15011178920418020652"}},"response":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"share_url":{"title":"Share Url","type":"string","description":"微信视频号作品分享链接。"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["share_url","points"],"title":"InternalWechatVideoShareUrlResponse","type":"object"},"example":{"share_url":"https://example.invalid/wechat-share-url","points":{"cost":10,"balance":990}}},"related_mcp_tools":["wechat_get_video_share_url_by_object_id"]},{"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。"},"has_wechat_channels_account":{"default":false,"description":"是否开通微信视频号","title":"Has Wechat Channels Account","type":"boolean"}},"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":"评论内容。"},"image_urls":{"description":"评论图片完整链接列表；没有时为空数组。链接可能失效，有效期未知；需长期保存时及时下载，图片格式以文件内容为准。","items":{"type":"string"},"title":"Image Urls","type":"array"},"stickers":{"description":"评论表情包列表；按原顺序返回，没有时为空数组","items":{"$ref":"#/$defs/WechatVideoCommentStickerData"},"title":"Stickers","type":"array"},"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"},"WechatVideoCommentStickerData":{"properties":{"url":{"description":"表情包原图链接；可能是静态图片或动图。链接可能失效，有效期未知；需长期保存时及时下载，图片格式以文件内容为准。","title":"Url","type":"string"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"表情包缩略图链接；没有时为 null；链接可能失效，有效期未知","title":"Thumbnail Url"}},"required":["url"],"title":"WechatVideoCommentStickerData","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":"背景音乐是什么","image_urls":[],"stickers":[],"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","has_wechat_channels_account":false}}],"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。"},"has_wechat_channels_account":{"default":false,"description":"是否开通微信视频号","title":"Has Wechat Channels Account","type":"boolean"}},"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":"评论回复内容。"},"image_urls":{"description":"评论图片完整链接列表；没有时为空数组。链接可能失效，有效期未知；需长期保存时及时下载，图片格式以文件内容为准。","items":{"type":"string"},"title":"Image Urls","type":"array"},"stickers":{"description":"评论表情包列表；按原顺序返回，没有时为空数组","items":{"$ref":"#/$defs/WechatVideoCommentStickerData"},"title":"Stickers","type":"array"},"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"},"WechatVideoCommentStickerData":{"properties":{"url":{"description":"表情包原图链接；可能是静态图片或动图。链接可能失效，有效期未知；需长期保存时及时下载，图片格式以文件内容为准。","title":"Url","type":"string"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"表情包缩略图链接；没有时为 null；链接可能失效，有效期未知","title":"Thumbnail Url"}},"required":["url"],"title":"WechatVideoCommentStickerData","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拿走不谢[旺柴]","image_urls":[],"stickers":[],"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","has_wechat_channels_account":true}}],"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 一起原样传入。"},"is_pinned":{"default":false,"title":"Is Pinned","type":"boolean","description":"是否置顶。"},"object_nonce_id":{"title":"Object Nonce Id","type":"string","description":"微信视频号作品 object_nonce_id；获取视频评论时请与同一条视频的 object_id 一起原样传入。"},"encrypted_object_id":{"title":"Encrypted Object Id","type":"string","description":"微信视频号合法 encrypted_object_id；用户已提供时原样使用，否则可从 wechat_search_videos 或作者作品列表返回项获取。"},"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","encrypted_object_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":"14882122090270235141","object_nonce_id":"12801331239707625908_0_39_2_40_1779790168930270_fb716eb6-58ea-11f1-99a5-7f6b04ec7b34","encrypted_object_id":"export/UzFfBgAAxNGHRAoDCiCmjczT4DCJo_ucN9zrVAowGRSwVwd2ng","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"]},{"operation_id":"wechat_search_mp_articles","platform_id":"wechat","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/wechat/mp/article/search","summary":"搜索微信公众号文章","description":"按搜索词查找公众号文章，支持排序、发布时间筛选和分页。翻页时保持搜索词及筛选条件不变。结果中的 summary 是摘要片段；读取全文时，将 article_url 作为 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":{"keyword":{"description":"公众号文章搜索词或关键词短语；例如量子位、人工智能。不要传文章链接或公众号账号 ID。","maxLength":100,"minLength":1,"title":"Keyword","type":"string"},"page_token":{"default":"","description":"文章搜索分页令牌；首次留空，继续翻页原样传回 next_page_token，并保持 keyword、sort_type 和 publish_time_range 不变。","title":"Page Token","type":"string"},"sort_type":{"default":"general","description":"排序方式：general（综合/相关性，默认）、time_descending（最新发布）、hot（最热，顺序以平台结果为准）。","enum":["general","time_descending","hot"],"title":"Sort Type","type":"string","x-socialdatax-enum-labels":{"general":"综合","time_descending":"最新发布优先"}},"publish_time_range":{"default":"all","description":"发布时间范围：all（不限，默认）、day（最近一天）、week（最近七天）、half_year（最近半年）。","enum":["all","day","week","half_year"],"title":"Publish Time Range","type":"string","x-socialdatax-enum-labels":{"all":"不限","day":"一天内","week":"一周内","half_year":"半年内"}}},"required":["keyword"],"title":"PublicWechatMpArticleSearchRequest","type":"object"},"example":{"keyword":"量子位","sort_type":"time_descending","publish_time_range":"week","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"PublicWechatMpArticleSearchItemResponse":{"additionalProperties":false,"properties":{"title":{"description":"公众号文章标题。","title":"Title","type":"string"},"summary":{"description":"搜索结果中的摘要片段，不是文章全文；不可用时为空字符串。","title":"Summary","type":"string"},"account_name":{"description":"发布文章的公众号名称；不可用时为空字符串。","title":"Account Name","type":"string"},"read_count_text":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"阅读量展示文案，如“阅读 8万+”；不是精确计数，不可用时为 null。","title":"Read Count Text"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"文章封面链接；不可用时为 null。","title":"Cover Image Url"},"article_url":{"description":"文章链接；读取正文时作为 url 传给公众号文章详情接口，也可用于统计或评论查询。","title":"Article Url","type":"string"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"}},"required":["title","summary","account_name","read_count_text","cover_image_url","article_url","publish_time"],"title":"PublicWechatMpArticleSearchItemResponse","type":"object"}},"additionalProperties":false,"properties":{"items":{"description":"本页公众号文章搜索结果。","items":{"$ref":"#/$defs/PublicWechatMpArticleSearchItemResponse"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页分页令牌；空字符串表示已结束，应停止翻页；非空时完整原样传回 page_token，并保持 keyword、sort_type 和 publish_time_range 不变。","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":"PublicWechatMpArticleSearchResponse","type":"object"},"example":{"items":[{"title":"人工智能行业动态","summary":"文章摘要","account_name":"量子位","read_count_text":"阅读 8万+","cover_image_url":"https://example.invalid/wechat-mp-cover.jpg","article_url":"https://mp.weixin.qq.com/s/cyog0u9QpLFvdBsh9JR3_g","publish_time":1790115069}],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["wechat_search_mp_articles"]},{"operation_id":"wechat_get_mp_article_detail_by_url","platform_id":"wechat","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/wechat/mp/article/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":{"url":{"description":"微信公众号文章链接，或包含文章链接的分享文案。","title":"Url","type":"string"}},"required":["url"],"title":"PublicWechatMpArticleRequest","type":"object"},"example":{"url":"https://mp.weixin.qq.com/s/cyog0u9QpLFvdBsh9JR3_g"}},"response":{"content_type":"application/json","schema":{"$defs":{"PublicWechatMpArticleAccountResponse":{"additionalProperties":false,"properties":{"name":{"description":"公众号名称。","title":"Name","type":"string"},"account_id":{"description":"公众号账号 ID。","title":"Account Id","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"公众号头像链接；不可用时为 null。","title":"Avatar Url"},"signature":{"description":"公众号简介。","title":"Signature","type":"string"}},"required":["name","account_id","avatar_url","signature"],"title":"PublicWechatMpArticleAccountResponse","type":"object"},"PublicWechatMpArticleFinderVideoCardResponse":{"additionalProperties":false,"properties":{"encrypted_object_id":{"description":"内嵌视频号卡片作品加密 ID。","title":"Encrypted Object Id","type":"string"},"user_id":{"description":"内嵌视频号卡片作者用户 ID。","title":"User Id","type":"string"},"author_name":{"description":"内嵌视频号卡片作者名称。","title":"Author Name","type":"string"},"description":{"description":"内嵌视频号卡片描述。","title":"Description","type":"string"},"content_type":{"description":"内嵌视频号卡片内容类型。","title":"Content Type","type":"string"}},"required":["encrypted_object_id","user_id","author_name","description","content_type"],"title":"PublicWechatMpArticleFinderVideoCardResponse","type":"object"},"PublicWechatMpArticleLinkedArticleResponse":{"additionalProperties":false,"properties":{"title":{"description":"正文内链公众号文章标题。","title":"Title","type":"string"},"url":{"description":"正文内链公众号文章链接。","title":"Url","type":"string"}},"required":["title","url"],"title":"PublicWechatMpArticleLinkedArticleResponse","type":"object"}},"additionalProperties":false,"properties":{"biz":{"title":"Biz","type":"string"},"mid":{"title":"Mid","type":"string"},"idx":{"title":"Idx","type":"string"},"sn":{"title":"Sn","type":"string"},"title":{"description":"公众号文章标题。","title":"Title","type":"string"},"account":{"$ref":"#/$defs/PublicWechatMpArticleAccountResponse"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Publish Time","description":"发布时间，秒级 Unix 时间戳。"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cover Image Url","description":"统一封面图链接。"},"description":{"description":"公众号文章摘要。","title":"Description","type":"string"},"article_url":{"description":"规范化后的公众号文章链接。","title":"Article Url","type":"string"},"content_text":{"description":"正文纯文本。","title":"Content Text","type":"string"},"content_html":{"description":"正文 HTML 片段。","title":"Content Html","type":"string"},"image_urls":{"description":"正文图片链接，按页面顺序返回。","items":{"type":"string"},"title":"Image Urls","type":"array"},"linked_articles":{"description":"正文内链公众号文章列表。","items":{"$ref":"#/$defs/PublicWechatMpArticleLinkedArticleResponse"},"title":"Linked Articles","type":"array"},"finder_video_cards":{"description":"正文内嵌视频号卡片列表。","items":{"$ref":"#/$defs/PublicWechatMpArticleFinderVideoCardResponse"},"title":"Finder Video Cards","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":["biz","mid","idx","sn","title","account","publish_time","cover_image_url","description","article_url","content_text","content_html","image_urls","linked_articles","finder_video_cards","points"],"title":"PublicWechatMpArticleDetailResponse","type":"object"},"example":{"biz":"MzA4NjQyNjQyNA==","mid":"2247485000","idx":"1","sn":"article-sn","title":"公众号文章标题","account":{"name":"浙江之声","account_id":"zhejiangzhisheng","avatar_url":"https://example.invalid/wechat-mp-avatar.jpg","signature":"公众号简介"},"publish_time":1780572706,"cover_image_url":"https://example.invalid/wechat-mp-cover.jpg","description":"文章摘要","article_url":"https://mp.weixin.qq.com/s/cyog0u9QpLFvdBsh9JR3_g","content_text":"文章正文纯文本","content_html":"<p>文章正文</p>","image_urls":["https://example.invalid/wechat-mp-image.jpg"],"linked_articles":[],"finder_video_cards":[],"points":{"cost":10,"balance":990}}},"related_mcp_tools":["wechat_get_mp_article_detail_by_url"]},{"operation_id":"wechat_get_mp_account_info_by_account_id","platform_id":"wechat","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/wechat/mp/account/info","summary":"读取微信公众号账号资料","description":"按公众号账号 ID 读取账号名称、IP 属地、原创文章数和关联视频号。账号 ID 可从公众号文章详情的 account.account_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":{"account_id":{"description":"公众号账号 ID；可从公众号文章详情返回的 account.account_id 获取。","title":"Account Id","type":"string"}},"required":["account_id"],"title":"PublicWechatMpAccountInfoRequest","type":"object"},"example":{"account_id":"gh_114e76fd6e5d"}},"response":{"content_type":"application/json","schema":{"$defs":{"PublicWechatMpLinkedVideoAccountResponse":{"additionalProperties":false,"properties":{"name":{"description":"关联视频号名称；不可用时为空字符串。","title":"Name","type":"string"},"user_id":{"description":"关联视频号用户 ID。","title":"User Id","type":"string"}},"required":["name","user_id"],"title":"PublicWechatMpLinkedVideoAccountResponse","type":"object"}},"additionalProperties":false,"properties":{"account_id":{"description":"公众号账号 ID。","title":"Account Id","type":"string"},"name":{"description":"公众号名称；不可用时为空字符串。","title":"Name","type":"string"},"ip_location":{"description":"公众号 IP 属地；不可用时为空字符串。","title":"Ip Location","type":"string"},"original_article_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"公众号原创文章数；当前不可用时为 null。","title":"Original Article Count"},"linked_video_account":{"anyOf":[{"$ref":"#/$defs/PublicWechatMpLinkedVideoAccountResponse"},{"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":["account_id","name","ip_location","original_article_count","linked_video_account","points"],"title":"PublicWechatMpAccountInfoResponse","type":"object"},"example":{"account_id":"gh_114e76fd6e5d","name":"量子位","ip_location":"北京 海淀","original_article_count":4079,"linked_video_account":{"name":"量子位","user_id":"v2_060000231003b20faec8c7ea8e10c0d0cc02e535b0777911f2a26aa13518c7c2032ad76804d2@finder"},"points":{"cost":10,"balance":990}}},"related_mcp_tools":["wechat_get_mp_account_info_by_account_id"]},{"operation_id":"wechat_get_mp_account_articles_by_account_id","platform_id":"wechat","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/wechat/mp/account/articles","summary":"读取微信公众号账号文章","description":"按公众号账号 ID 读取该账号发布的文章列表，支持分页。账号 ID 可从公众号文章详情的 account.account_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":{"account_id":{"description":"公众号账号 ID；可从公众号文章详情返回的 account.account_id 获取。","title":"Account Id","type":"string"},"page_token":{"default":"","description":"公众号账号文章分页令牌；首次请求留空，继续翻页时原样传回上一页返回的 next_page_token。","title":"Page Token","type":"string"}},"required":["account_id"],"title":"PublicWechatMpAccountArticlesRequest","type":"object"},"example":{"account_id":"gh_114e76fd6e5d","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"PublicWechatMpAccountArticleItemResponse":{"additionalProperties":false,"properties":{"title":{"description":"公众号文章标题；不可用时为空字符串。","title":"Title","type":"string"},"summary":{"description":"文章摘要；不可用时为空字符串。","title":"Summary","type":"string"},"cover_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"文章封面图片链接；不可用时为 null。","title":"Cover Image Url"},"article_url":{"description":"公众号文章链接；不可用时为空字符串。","title":"Article Url","type":"string"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"文章发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"is_paid":{"description":"是否为付费文章。","title":"Is Paid","type":"boolean"}},"required":["title","summary","cover_image_url","article_url","publish_time","is_paid"],"title":"PublicWechatMpAccountArticleItemResponse","type":"object"}},"additionalProperties":false,"properties":{"account_id":{"description":"公众号账号 ID。","title":"Account Id","type":"string"},"items":{"description":"当前页公众号文章。","items":{"$ref":"#/$defs/PublicWechatMpAccountArticleItemResponse"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页分页令牌；为空表示没有更多文章。继续翻页时原样传回。","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":["account_id","items","next_page_token","points"],"title":"PublicWechatMpAccountArticlesResponse","type":"object"},"example":{"account_id":"gh_114e76fd6e5d","items":[{"title":"公众号文章标题","summary":"文章摘要","cover_image_url":"https://example.invalid/wechat-mp-cover.jpg","article_url":"https://mp.weixin.qq.com/s/cyog0u9QpLFvdBsh9JR3_g","publish_time":1780572706,"is_paid":false}],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["wechat_get_mp_account_articles_by_account_id"]},{"operation_id":"wechat_get_mp_article_stats_by_url","platform_id":"wechat","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/wechat/mp/article/stats","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":{"url":{"description":"微信公众号文章链接，或包含文章链接的分享文案。","title":"Url","type":"string"}},"required":["url"],"title":"PublicWechatMpArticleRequest","type":"object"},"example":{"url":"https://mp.weixin.qq.com/s/cyog0u9QpLFvdBsh9JR3_g"}},"response":{"content_type":"application/json","schema":{"additionalProperties":false,"properties":{"article_url":{"description":"规范化后的公众号文章链接。","title":"Article Url","type":"string"},"read_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"文章阅读数；当前不可用时为 null。","title":"Read Count"},"like_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"文章点赞数；当前不可用时为 null。","title":"Like Count"},"share_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"文章分享数；当前不可用时为 null。","title":"Share 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"},"points":{"type":"object","description":"本次成功调用的积分消耗与调用完成时的账户积分余额。","properties":{"cost":{"type":"integer","description":"本次请求最终确认消耗的积分。","minimum":0},"balance":{"type":"integer","description":"本次接口完成时看到的当前积分余额。","minimum":0}},"required":["cost","balance"],"additionalProperties":false}},"required":["article_url","read_count","like_count","share_count","collect_count","comment_count","points"],"title":"PublicWechatMpArticleStatsResponse","type":"object"},"example":{"article_url":"https://mp.weixin.qq.com/s/cyog0u9QpLFvdBsh9JR3_g","read_count":28516,"like_count":22,"share_count":978,"collect_count":34,"comment_count":28,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["wechat_get_mp_article_stats_by_url"]},{"operation_id":"wechat_get_mp_article_comments_by_url","platform_id":"wechat","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/wechat/mp/article/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":{"url":{"description":"微信公众号文章链接，或包含文章链接的分享文案。","title":"Url","type":"string"},"page_token":{"default":"","description":"评论分页令牌；首次请求留空。","title":"Page Token","type":"string"}},"required":["url"],"title":"PublicWechatMpArticleCommentRequest","type":"object"},"example":{"url":"https://mp.weixin.qq.com/s/cyog0u9QpLFvdBsh9JR3_g","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"PublicWechatMpArticleCommentAuthorResponse":{"additionalProperties":false,"properties":{"name":{"description":"评论作者昵称；不可用时为空字符串。","title":"Name","type":"string"}},"required":["name"],"title":"PublicWechatMpArticleCommentAuthorResponse","type":"object"},"PublicWechatMpArticleCommentItemResponse":{"additionalProperties":false,"properties":{"comment_id":{"description":"公众号文章一级评论 ID。","title":"Comment Id","type":"string"},"content":{"description":"公众号文章评论内容。","title":"Content","type":"string"},"author":{"$ref":"#/$defs/PublicWechatMpArticleCommentAuthorResponse","description":"评论作者信息；当前仅提供昵称。"},"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":{"description":"该评论的回复数。","title":"Reply Count","type":"integer"},"ip_location":{"description":"评论 IP 属地；不可用时为空字符串。","title":"Ip Location","type":"string"},"is_featured":{"description":"是否为精选评论。","title":"Is Featured","type":"boolean"}},"required":["comment_id","content","author","publish_time","like_count","reply_count","ip_location","is_featured"],"title":"PublicWechatMpArticleCommentItemResponse","type":"object"}},"additionalProperties":false,"properties":{"items":{"description":"当前页公众号文章评论。","items":{"$ref":"#/$defs/PublicWechatMpArticleCommentItemResponse"},"title":"Items","type":"array"},"next_page_token":{"description":"公众号文章评论分页令牌；空字符串表示已结束，应停止翻页；非空时将完整令牌原样传回 page_token，并保持文章链接不变。","title":"Next Page Token","type":"string"},"comment_count":{"description":"文章评论总数。","title":"Comment Count","type":"integer"},"featured_count":{"description":"精选评论总数。","title":"Featured 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","comment_count","featured_count","points"],"title":"PublicWechatMpArticleCommentsResponse","type":"object"},"example":{"items":[{"comment_id":"6255846262940111556","content":"文章评论内容","author":{"name":"用户昵称"},"publish_time":1741148719,"like_count":87,"reply_count":0,"ip_location":"浙江","is_featured":true}],"next_page_token":"opaque-wechat-mp-comment-page-token","comment_count":28,"featured_count":22,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["wechat_get_mp_article_comments_by_url"]},{"operation_id":"wechat_get_mp_article_comment_replies_by_url","platform_id":"wechat","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/wechat/mp/article/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":{"url":{"description":"微信公众号文章链接，或包含文章链接的分享文案。","title":"Url","type":"string"},"comment_id":{"default":"","description":"一级评论 ID；从评论列表结果复制；可留空，由服务自动选择有回复的评论。","title":"Comment Id","type":"string"},"page_token":{"default":"","description":"评论回复分页令牌；首次请求留空。","title":"Page Token","type":"string"}},"required":["url"],"title":"PublicWechatMpArticleCommentRepliesRequest","type":"object"},"example":{"url":"https://mp.weixin.qq.com/s/cyog0u9QpLFvdBsh9JR3_g","comment_id":"6255846262940111556","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"PublicWechatMpArticleCommentAuthorResponse":{"additionalProperties":false,"properties":{"name":{"description":"评论作者昵称；不可用时为空字符串。","title":"Name","type":"string"}},"required":["name"],"title":"PublicWechatMpArticleCommentAuthorResponse","type":"object"},"PublicWechatMpArticleCommentReplyItemResponse":{"additionalProperties":false,"properties":{"comment_id":{"description":"公众号评论回复自身 ID；不是输入的一级评论 comment_id。","title":"Comment Id","type":"string"},"parent_comment_id":{"description":"所属一级评论 ID。","title":"Parent Comment Id","type":"string"},"content":{"description":"公众号文章评论回复内容。","title":"Content","type":"string"},"author":{"$ref":"#/$defs/PublicWechatMpArticleCommentAuthorResponse","description":"评论回复作者信息；当前仅提供昵称。"},"publish_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"评论回复发布时间，秒级 Unix 时间戳；不可用时为 null。","title":"Publish Time"},"ip_location":{"description":"评论回复 IP 属地；不可用时为空字符串。","title":"Ip Location","type":"string"},"is_ai_generated":{"description":"是否为 AI 生成回复。","title":"Is Ai Generated","type":"boolean"},"is_featured":{"description":"是否为精选回复。","title":"Is Featured","type":"boolean"}},"required":["comment_id","parent_comment_id","content","author","publish_time","ip_location","is_ai_generated","is_featured"],"title":"PublicWechatMpArticleCommentReplyItemResponse","type":"object"}},"additionalProperties":false,"properties":{"items":{"description":"当前页公众号文章评论回复。","items":{"$ref":"#/$defs/PublicWechatMpArticleCommentReplyItemResponse"},"title":"Items","type":"array"},"next_page_token":{"description":"公众号文章评论回复分页令牌；继续翻页时原样传回；只能用于同一篇文章下同一条一级评论的回复分页链路。","title":"Next Page Token","type":"string"},"reply_count":{"description":"该一级评论的回复总数。","title":"Reply 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","reply_count","points"],"title":"PublicWechatMpArticleCommentRepliesResponse","type":"object"},"example":{"items":[{"comment_id":"6255846262940111557","parent_comment_id":"6255846262940111556","content":"文章评论回复内容","author":{"name":"晴天"},"publish_time":1741148720,"ip_location":"浙江","is_ai_generated":false,"is_featured":false}],"next_page_token":"","reply_count":1,"points":{"cost":10,"balance":990}}},"related_mcp_tools":["wechat_get_mp_article_comment_replies_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_share_url","wechat_get_video_comments","wechat_get_video_comment_replies","wechat_get_user_info","wechat_get_user_posted_videos","wechat_search_mp_articles","wechat_get_mp_article_detail_by_url","wechat_get_mp_account_info_by_account_id","wechat_get_mp_account_articles_by_account_id","wechat_get_mp_article_stats_by_url","wechat_get_mp_article_comments_by_url","wechat_get_mp_article_comment_replies_by_url"]}]},{"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_search_users","platform_id":"zhihu","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/zhihu/user/search","summary":"知乎用户搜索","description":"按关键词搜索知乎用户；已有主页链接时使用用户资料接口。支持 page_token 翻页。","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 或 page_token。"},"page_token":{"default":"","title":"Page Token","type":"string","description":"首页留空，后续原样传入同一关键词用户搜索返回的 next_page_token，不可跨接口使用。"}},"required":["keyword"],"title":"InternalSearchUsersRequest","type":"object"},"example":{"keyword":"Tony"}},"response":{"content_type":"application/json","schema":{"$defs":{"ZhihuUserSearchItemData":{"properties":{"user_id":{"description":"知乎用户 ID，仅用于识别用户；查询用户资料或文章列表时使用同项 profile_url，不要将此 ID 作为 profile_url。","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":{"description":"知乎用户主页链接；可直接作为用户资料或用户发布文章列表接口的 profile_url。文章列表只返回文章，不包含回答、想法或视频。","title":"Profile Url","type":"string"},"bio":{"description":"用户简介；不可用时为空字符串。","title":"Bio","type":"string"},"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"},"answer_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"用户公开回答数；不可用时为 null。","title":"Answer Count"},"article_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"用户公开文章数；不可用时为 null。","title":"Article Count"},"creation_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"平台展示的创作总数，不等同于回答数与文章数之和；不可用时为 null。","title":"Creation Count"},"last_creation_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"最近创作时间，秒级 Unix 时间戳；不可用时为 null。","title":"Last Creation Time"}},"required":["user_id","name","avatar_url","profile_url","bio","follower_count","received_upvote_count","answer_count","article_count","creation_count","last_creation_time"],"title":"ZhihuUserSearchItemData","type":"object"}},"properties":{"items":{"description":"当前页用户搜索结果。","items":{"$ref":"#/$defs/ZhihuUserSearchItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页不透明分页令牌；为空表示结束。必须原样传回同一用户搜索入口，不可跨关键词或能力使用。","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":"ZhihuUserSearchResult","type":"object"},"example":{"items":[{"user_id":"4662d3c2601cb1c7db37e87dcb23c960","name":"Tony","avatar_url":"https://pica.zhimg.com/50/v2-58ceb34ed7397280cf9330a8ccf2cc39_l.jpg?source=4e949a73","profile_url":"https://www.zhihu.com/people/simtony","bio":"大模型丹炉添柴员","follower_count":3323,"received_upvote_count":2413,"answer_count":13,"article_count":18,"creation_count":32,"last_creation_time":1772595933}],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["zhihu_search_users"]},{"operation_id":"zhihu_search_suggestions","platform_id":"zhihu","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/zhihu/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":"搜索关键词或短语；不要传链接、用户 ID 或 page_token。"}},"required":["keyword"],"title":"InternalSearchSuggestionsRequest","type":"object"},"example":{"keyword":"美食"}},"response":{"content_type":"application/json","schema":{"$defs":{"ZhihuSearchSuggestionItemData":{"properties":{"text":{"description":"搜索输入框联想词。","title":"Text","type":"string"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"平台返回的建议标记，例如 hot、pu_user；不作为完整分类枚举，无标记时为 null。","title":"Label"},"icon_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"建议展示图标链接；无图标或不可用时为 null。","title":"Icon Url"}},"required":["text","label","icon_url"],"title":"ZhihuSearchSuggestionItemData","type":"object"}},"properties":{"items":{"description":"搜索建议列表。","items":{"$ref":"#/$defs/ZhihuSearchSuggestionItemData"},"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":"ZhihuSearchSuggestionsResult","type":"object"},"example":{"items":[{"text":"美食做法推荐","label":null,"icon_url":null},{"text":"美食答主王大厨","label":"pu_user","icon_url":"https://picx.zhimg.com/80/v2-5103b0fe39b95e11682bc5bdd7fbfc6e_1440w.png"}],"points":{"cost":10,"balance":990}}},"related_mcp_tools":["zhihu_search_suggestions"]},{"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、昵称、回答链接、专栏文章链接、问题页链接、接口地址、短链接、移动端链接或包含链接的分享文案；从用户搜索结果继续时，直接复用所选用户的 items[].profile_url；从内容搜索、详情、评论或评论回复结果继续时，复用所选作者的 author.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、昵称、回答链接、专栏文章链接、问题页链接、接口地址、短链接、移动端链接或包含链接的分享文案；从用户搜索结果继续时，直接复用所选用户的 items[].profile_url；从内容搜索、详情、评论或评论回复结果继续时，复用所选作者的 author.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_search_users","zhihu_search_suggestions","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_users","platform_id":"instagram","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/instagram/user/search","summary":"搜索 Instagram 用户","description":"按关键词搜索 Instagram 用户，返回公开账号资料及分页令牌。用于按名称发现账号；已知 username 或主页链接时，使用用户详情工具。未知昵称返回空字符串，未知头像或认证、私密状态返回 null。","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":{"description":"用户搜索词，例如 landscape、NBA；不要传帖子链接、主页链接、用户 ID 或分页令牌。","maxLength":256,"minLength":1,"title":"Keyword","type":"string"},"page_token":{"default":"","description":"首次留空；续页原样传入上次 next_page_token，保持 keyword 不变。","title":"Page Token","type":"string"}},"required":["keyword"],"title":"InstagramSearchUsersRequest","type":"object"},"example":{"keyword":"landscape","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"InstagramUserSearchItemData":{"properties":{"user_id":{"description":"Instagram 用户数字 ID，按字符串原样保留。","title":"User Id","type":"string"},"username":{"description":"用户名，可用于后续用户详情和作品查询。","title":"Username","type":"string"},"name":{"default":"","description":"用户展示名；不是 username；不可用时为空字符串。","title":"Name","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"用户头像链接；不可用时为 null。","title":"Avatar Url"},"profile_url":{"description":"Instagram 用户主页链接，可用于后续用户详情和作品查询。","title":"Profile Url","type":"string"},"is_verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"是否为认证账号；不可用时为 null。","title":"Is Verified"},"is_private":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"是否为私密账号；不可用时为 null。","title":"Is Private"}},"required":["user_id","username","profile_url"],"title":"InstagramUserSearchItemData","type":"object"}},"properties":{"items":{"description":"匹配用户列表；无匹配时为空数组。","items":{"$ref":"#/$defs/InstagramUserSearchItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页令牌；为空字符串时停止翻页。","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":"InstagramUserSearchResult","type":"object"},"example":{"items":[{"user_id":"9708893279","username":"landscape.first","name":"Landscape First","avatar_url":"https://example.invalid/avatar.jpg","profile_url":"https://www.instagram.com/landscape.first/","is_verified":false,"is_private":false}],"next_page_token":"opaque-user-search-page-token","points":{"cost":10,"balance":990}}},"related_mcp_tools":["instagram_search_users"]},{"operation_id":"instagram_search_tags","platform_id":"instagram","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/instagram/tag/search","summary":"搜索 Instagram 标签","description":"按关键词搜索 Instagram 标签，返回标签 ID、名称及帖子数。用于发现标签，不返回标签下的帖子；当前仅支持首屏，不支持翻页。","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":{"description":"标签搜索词，例如 landscape；不要传帖子链接、主页链接或分页令牌。","maxLength":256,"minLength":1,"title":"Keyword","type":"string"}},"required":["keyword"],"title":"InstagramSearchTagsRequest","type":"object"},"example":{"keyword":"landscape"}},"response":{"content_type":"application/json","schema":{"$defs":{"InstagramTagSearchItemData":{"properties":{"tag_id":{"description":"Instagram 标签数字 ID，以字符串返回。","title":"Tag Id","type":"string"},"name":{"description":"标签名称。","title":"Name","type":"string"},"post_count":{"description":"该标签的帖子数。","minimum":0,"title":"Post Count","type":"integer"}},"required":["tag_id","name","post_count"],"title":"InstagramTagSearchItemData","type":"object"}},"properties":{"items":{"description":"当前首屏匹配的标签列表；无匹配时为空数组。","items":{"$ref":"#/$defs/InstagramTagSearchItemData"},"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":"InstagramTagSearchResult","type":"object"},"example":{"items":[{"tag_id":"17841563758099529","name":"landscapephotography","post_count":78258297}],"points":{"cost":10,"balance":990}}},"related_mcp_tools":["instagram_search_tags"]},{"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 用户信息。确认用户主页不可访问时返回 HTTP 200、code=1007，不扣费；请检查用户名或主页链接，不要原样自动重试。","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 帖子列表。确认用户主页不可访问时返回 HTTP 200、code=1007，不扣费；请检查用户名或主页链接，不要原样自动重试。","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"},"InstagramTopicTagData":{"properties":{"name":{"description":"话题标签名称，不带 #。","title":"Name","type":"string"}},"required":["name"],"title":"InstagramTopicTagData","type":"object"},"InstagramUserPostItemData":{"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。"},"is_pinned":{"default":false,"description":"是否为该用户主页中的置顶帖子。","title":"Is Pinned","type":"boolean"}},"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":"InstagramUserPostItemData","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/InstagramUserPostItemData"},"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_users","instagram_search_tags","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_get_user_replies","platform_id":"x","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/x/user/reply/list","summary":"获取 X 博主回复列表","description":"获取目标博主发出的回复帖子，包含自回复；仅返回作者为目标博主且有明确上级帖子 ID 的内容。必须且只能传 user_id、username、profile_url 之一；分页时保持同一用户及定位方式，原样传回 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":"","description":"X 用户稳定数字 ID；用户已提供时原样使用；必须是数字字符串。可从用户搜索结果的非空 items[*].user_id、用户详情的非空 user_id，或帖子及评论结果的非空作者字段 author.user_id 原样复制；不要传用户名、用户主页链接、帖子链接或分享文案。","title":"User Id","type":"string"},"username":{"default":"","description":"X 用户名，不带 @；也接受用户提供的 @username。可从用户搜索结果的非空 items[*].username、用户详情的非空 username，或帖子及评论结果的非空作者字段 author.username 原样复制；不要传用户主页链接、帖子链接或分享文案。","title":"Username","type":"string"},"profile_url":{"default":"","description":"X 用户主页链接；也接受用户提供的 x.com 或 twitter.com 用户主页链接。可从用户搜索结果的非空 items[*].profile_url、用户详情的非空 profile_url，或帖子及评论结果的非空作者字段 author.profile_url 原样复制；不要传帖子链接、评论链接、帖子正文里的链接、搜索关键词或接口地址。","title":"Profile Url","type":"string"},"page_token":{"default":"","description":"首次请求留空；继续翻页时原样传回完整 next_page_token，保持同一用户及定位方式。不能与用户帖子列表或其他工具的分页令牌混用。","title":"Page Token","type":"string"}},"title":"XUserRepliesRequest","type":"object","description":"请求体必须且只能传 user_id、username 或 profile_url 其中一个。"},"example":{"username":"elonmusk","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":"目标博主发布的回复帖子，包含自回复；仅保留作者为目标博主且上级帖子 ID 明确的内容。post_id 是回复自身 ID，reply_to_post_id 是上级帖子 ID。当前页可能为空。","items":{"$ref":"#/$defs/XPostSearchItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页令牌；为空字符串时停止翻页。当前页 items 为空但令牌非空时仍可继续翻页。继续请求时原样传入 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":"XUserRepliesResult","type":"object"},"example":{"items":[],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["x_get_user_replies_by_user_id","x_get_user_replies_by_username","x_get_user_replies_by_profile_url"]},{"operation_id":"x_search_users","platform_id":"x","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/x/user/search","summary":"搜索 X 用户","description":"按关键词搜索 X / Twitter 用户，返回用户资料和分页令牌，支持 page_token 翻页。用于按名称发现账号；已知 user_id、username 或主页链接时，使用对应用户详情工具。","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":{"description":"用户搜索关键词或名称，例如 OpenAI；不要传用户 ID、主页链接或分页令牌。","minLength":1,"title":"Keyword","type":"string"},"page_token":{"default":"","description":"首次请求留空；继续翻页时原样传入上次的 next_page_token，并保持 keyword 不变。","title":"Page Token","type":"string"}},"required":["keyword"],"title":"XSearchUsersRequest","type":"object"},"example":{"keyword":"OpenAI","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"XUserSearchItemData":{"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"},"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"}},"required":["user_id","username","name","avatar_url","profile_url","bio","external_url","is_verified","verified_type","is_private","follower_count","following_count","post_count","media_post_count","location","header_image_url","pinned_post_ids","account_created_time"],"title":"XUserSearchItemData","type":"object"}},"properties":{"items":{"description":"匹配的用户列表；没有匹配时为空数组。","items":{"$ref":"#/$defs/XUserSearchItemData"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页令牌；为空字符串时停止翻页；继续查询时原样传入 page_token 并保持 keyword 不变。","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":"XUserSearchResult","type":"object"},"example":{"items":[{"account_created_time":1449442268,"avatar_url":"https://pbs.twimg.com/profile_images/1885410181409820672/ztsaR0JW_normal.jpg","bio":"OpenAI’s mission is to ensure that artificial general intelligence benefits all of humanity. We’re hiring: https://t.co/dJGr6LgzPA","external_url":"https://t.co/3bPlZZkvdL","follower_count":5416915,"following_count":4,"header_image_url":"https://pbs.twimg.com/profile_banners/4398626122/1777662919","is_private":false,"is_verified":true,"location":"","media_post_count":743,"name":"OpenAI","pinned_post_ids":["2107894997538525580"],"post_count":2177,"profile_url":"https://x.com/OpenAI","user_id":"4398626122","username":"OpenAI","verified_type":"Business"}],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["x_search_users"]},{"operation_id":"x_search_suggestions","platform_id":"x","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/x/search/suggestions","summary":"获取 X 搜索建议","description":"获取 X / Twitter 搜索框的关键词联想，不返回帖子或推荐用户，不支持分页。可将返回的 text 用于帖子搜索；已有明确搜索词时可直接搜索帖子。","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":{"description":"搜索关键词或短语，例如 food、OpenAI；不要传帖子链接、用户主页链接、ID 或分页令牌。","minLength":1,"title":"Keyword","type":"string"}},"required":["keyword"],"title":"XSearchSuggestionsRequest","type":"object"},"example":{"keyword":"food"}},"response":{"content_type":"application/json","schema":{"$defs":{"XSearchSuggestionItem":{"properties":{"text":{"description":"X 搜索框联想词。","minLength":1,"title":"Text","type":"string"}},"required":["text"],"title":"XSearchSuggestionItem","type":"object"}},"properties":{"items":{"description":"关键词建议列表，保持返回顺序；没有匹配建议时为空数组。","items":{"$ref":"#/$defs/XSearchSuggestionItem"},"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":"XSearchSuggestionsResult","type":"object"},"example":{"items":[{"text":"food"},{"text":"food poll"}],"points":{"cost":10,"balance":990}}},"related_mcp_tools":["x_search_suggestions"]},{"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 其中一个。可使用用户搜索结果中非空的 items[*].user_id、items[*].username、items[*].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；用户已提供时原样使用；必须是数字字符串。可从用户搜索结果的非空 items[*].user_id、用户详情的非空 user_id，或帖子及评论结果的非空作者字段 author.user_id 原样复制；不要传用户名、用户主页链接、帖子链接或分享文案。"},"username":{"default":"","title":"Username","type":"string","description":"X 用户名，不带 @；也接受用户提供的 @username。可从用户搜索结果的非空 items[*].username、用户详情的非空 username，或帖子及评论结果的非空作者字段 author.username 原样复制；不要传用户主页链接、帖子链接或分享文案。"},"profile_url":{"default":"","title":"Profile Url","type":"string","description":"X 用户主页链接；也接受用户提供的 x.com 或 twitter.com 用户主页链接。可从用户搜索结果的非空 items[*].profile_url、用户详情的非空 profile_url，或帖子及评论结果的非空作者字段 author.profile_url 原样复制；不要传帖子链接、评论链接、帖子正文里的链接、搜索关键词或接口地址。"}},"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"},"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"},"affiliated_account_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"该账号关联的账号数量；不可用时为 null。","title":"Affiliated Account 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","is_verified","verified_type","is_private","follower_count","following_count","post_count","media_post_count","location","header_image_url","pinned_post_ids","account_created_time","affiliated_account_count","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 其中一个。可使用用户搜索结果中非空的 items[*].user_id、items[*].username、items[*].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；用户已提供时原样使用；必须是数字字符串。可从用户搜索结果的非空 items[*].user_id、用户详情的非空 user_id，或帖子及评论结果的非空作者字段 author.user_id 原样复制；不要传用户名、用户主页链接、帖子链接或分享文案。"},"username":{"default":"","title":"Username","type":"string","description":"X 用户名，不带 @；也接受用户提供的 @username。可从用户搜索结果的非空 items[*].username、用户详情的非空 username，或帖子及评论结果的非空作者字段 author.username 原样复制；不要传用户主页链接、帖子链接或分享文案。"},"profile_url":{"default":"","title":"Profile Url","type":"string","description":"X 用户主页链接；也接受用户提供的 x.com 或 twitter.com 用户主页链接。可从用户搜索结果的非空 items[*].profile_url、用户详情的非空 profile_url，或帖子及评论结果的非空作者字段 author.profile_url 原样复制；不要传帖子链接、评论链接、帖子正文里的链接、搜索关键词或接口地址。"},"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"},"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"},"XUserPostItemData":{"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_pinned":{"default":false,"description":"是否为该用户主页中的置顶帖子。","title":"Is Pinned","type":"boolean"}},"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":"XUserPostItemData","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/XUserPostItemData"},"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_get_user_replies","x_search_users","x_search_suggestions","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"]},{"operation_id":"youtube_search_suggestions","platform_id":"youtube","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/youtube/search/suggestions","summary":"获取 YouTube 搜索建议","description":"获取 YouTube 搜索框的联想词，不返回视频或频道详情，不支持分页。可将返回的 text 用于视频搜索；已有明确搜索词时可直接搜索视频。已有视频或频道链接时使用对应详情接口。","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":{"description":"搜索关键词或短语，例如 camping、美食；不要传视频链接、频道链接、ID 或分页令牌。","minLength":1,"title":"Keyword","type":"string"}},"required":["keyword"],"title":"YoutubeSearchSuggestionsRequest","type":"object"},"example":{"keyword":"camping"}},"response":{"content_type":"application/json","schema":{"$defs":{"YoutubeSearchSuggestionItem":{"properties":{"text":{"description":"YouTube 搜索框联想词。","minLength":1,"title":"Text","type":"string"}},"required":["text"],"title":"YoutubeSearchSuggestionItem","type":"object"}},"properties":{"items":{"description":"搜索建议列表，保持返回顺序；没有匹配建议时为空数组。","items":{"$ref":"#/$defs/YoutubeSearchSuggestionItem"},"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":"YoutubeSearchSuggestionsResult","type":"object"},"example":{"items":[{"text":"camping"},{"text":"camping music"}],"points":{"cost":10,"balance":990}}},"related_mcp_tools":["youtube_search_suggestions"]},{"operation_id":"youtube_search_channels","platform_id":"youtube","surface":"http","status":"available","method":"POST","path":"/socialdatax/api/v1/youtube/channel/search","summary":"搜索 YouTube 频道","description":"按关键词搜索 YouTube 频道或创作者，返回频道摘要，支持 page_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":{"keyword":{"description":"频道搜索词，例如 AI、露营或创作者名称；不要传视频链接、频道链接、频道 ID 或分页令牌。","minLength":1,"title":"Keyword","type":"string"},"page_token":{"default":"","description":"首屏留空；续页原样传上次返回的 next_page_token，并保持 keyword 不变。","title":"Page Token","type":"string"}},"required":["keyword"],"title":"YoutubeChannelSearchRequest","type":"object"},"example":{"keyword":"AI","page_token":""}},"response":{"content_type":"application/json","schema":{"$defs":{"YoutubeChannelSearchItem":{"properties":{"channel_id":{"description":"YouTube 频道 ID；用于识别和去重。","title":"Channel Id","type":"string"},"name":{"description":"频道名称；不可用时为空字符串。","title":"Name","type":"string"},"profile_url":{"description":"频道主页链接，可用于查询频道资料或频道作品。","title":"Profile Url","type":"string"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"频道头像链接；不可用时为 null。","title":"Avatar Url"},"bio":{"description":"搜索结果中的频道简介摘要，可能被截断；不可用时为空字符串。","title":"Bio","type":"string"}},"required":["channel_id","name","profile_url","avatar_url","bio"],"title":"YoutubeChannelSearchItem","type":"object"}},"properties":{"items":{"description":"频道搜索结果；没有匹配频道时为空数组。","items":{"$ref":"#/$defs/YoutubeChannelSearchItem"},"title":"Items","type":"array"},"next_page_token":{"description":"下一页令牌；为空字符串时没有下一页。","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":"YoutubeChannelSearchResult","type":"object"},"example":{"items":[{"channel_id":"UCIgnGlGkVRhd4qNFcEwLL4A","name":"AI Search","profile_url":"https://www.youtube.com/channel/UCIgnGlGkVRhd4qNFcEwLL4A","avatar_url":null,"bio":"Making AI easy to understand for everyone."}],"next_page_token":"","points":{"cost":10,"balance":990}}},"related_mcp_tools":["youtube_search_channels"]}]},{"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","youtube_search_suggestions","youtube_search_channels"]}]},{"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"]}]}]}]}