{"openapi":"3.0.3","info":{"title":"Social Data Collector","version":"0.4.0","description":"Bearer API Key；计划按账号共享限流与配额，成功请求1次、失败不扣；实现状态不等于上游可用。"},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"bearerAuth":[]}],"paths":{"/v1/tiktok/live-user":{"post":{"tags":["tiktok"],"summary":"按用户名查询直播间","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["username"],"properties":{"username":{"pattern":"^[A-Za-z0-9_.]{1,64}$","type":"string"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/tiktok/live-room":{"post":{"tags":["tiktok"],"summary":"按房间 ID 查询直播间","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["room_id"],"properties":{"room_id":{"pattern":"^[1-9][0-9]{9,24}$","type":"string"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/tiktok/live-online":{"post":{"tags":["tiktok"],"summary":"直播间明确在线或离线状态","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["room_id"],"properties":{"room_id":{"pattern":"^[1-9][0-9]{9,24}$","type":"string"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/tiktok/profile":{"post":{"tags":["tiktok"],"summary":"公开账号资料","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["username"],"properties":{"username":{"pattern":"^[A-Za-z0-9_.]{1,64}$","type":"string"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/tiktok/embed-posts":{"post":{"tags":["tiktok"],"summary":"公开嵌入作品样本，最多 10 条","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["username"],"properties":{"username":{"pattern":"^[A-Za-z0-9_.]{1,64}$","type":"string"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/tiktok/video":{"post":{"tags":["tiktok"],"summary":"公开单视频详情","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["username","video_id"],"properties":{"username":{"pattern":"^[A-Za-z0-9_.]{1,64}$","type":"string"},"video_id":{"pattern":"^[1-9][0-9]{9,24}$","type":"string"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/tiktok/posts":{"post":{"tags":["tiktok"],"summary":"账号作品分页","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["sec_uid","author_id"],"properties":{"sec_uid":{"minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},"author_id":{"pattern":"^[1-9][0-9]{0,24}$","type":"string"},"cursor":{"pattern":"^[0-9]{1,20}$","type":"string"},"limit":{"minimum":1,"maximum":30,"type":"integer"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/tiktok/search-users":{"post":{"tags":["tiktok"],"summary":"用户搜索","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["query"],"properties":{"query":{"minLength":1,"maxLength":100,"pattern":"\\S","type":"string"},"cursor":{"pattern":"^[0-9]{1,20}$","type":"string"},"limit":{"minimum":1,"maximum":30,"type":"integer"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/tiktok/search-videos":{"post":{"tags":["tiktok"],"summary":"视频搜索","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["query"],"properties":{"query":{"minLength":1,"maxLength":100,"pattern":"\\S","type":"string"},"cursor":{"pattern":"^[0-9]{1,20}$","type":"string"},"limit":{"minimum":1,"maximum":30,"type":"integer"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/tiktok/playlists":{"post":{"tags":["tiktok"],"summary":"用户播放列表","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["sec_uid","author_id"],"properties":{"sec_uid":{"minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},"author_id":{"pattern":"^[1-9][0-9]{0,24}$","type":"string"},"cursor":{"pattern":"^[0-9]{1,20}$","type":"string"},"limit":{"minimum":1,"maximum":30,"type":"integer"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/tiktok/suggestions":{"post":{"tags":["tiktok"],"summary":"搜索建议","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["query"],"properties":{"query":{"minLength":1,"maxLength":100,"pattern":"\\S","type":"string"},"cursor":{"const":"0","type":"string"},"limit":{"minimum":1,"maximum":30,"type":"integer"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/tiktok/playlist-items":{"post":{"tags":["tiktok"],"summary":"播放列表作品","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["playlist_id","author_id"],"properties":{"playlist_id":{"pattern":"^[1-9][0-9]{9,24}$","type":"string"},"author_id":{"pattern":"^[1-9][0-9]{0,24}$","type":"string"},"cursor":{"pattern":"^[0-9]{1,20}$","type":"string"},"limit":{"minimum":1,"maximum":30,"type":"integer"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/tiktok/trend-hashtags":{"post":{"tags":["tiktok"],"summary":"公开话题预览，最多 3 条","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","properties":{"country":{"pattern":"^[A-Z]{2}$","type":"string"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/tiktok/trend-videos":{"post":{"tags":["tiktok"],"summary":"公开热门视频预览，最多 4 条","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","properties":{"country":{"pattern":"^[A-Z]{2}$","type":"string"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/tiktok/trend-video":{"post":{"tags":["tiktok"],"summary":"公开趋势视频详情","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["video_id"],"properties":{"video_id":{"pattern":"^[1-9][0-9]{9,24}$","type":"string"},"country":{"pattern":"^[A-Z]{2}$","type":"string"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/tiktok/top-ads":{"post":{"tags":["tiktok"],"summary":"公开广告预览，最多 5 条","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","properties":{}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/tiktok/ad":{"post":{"tags":["tiktok"],"summary":"公开广告详情","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["ad_id"],"properties":{"ad_id":{"pattern":"^[1-9][0-9]{9,24}$","type":"string"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/tiktok/share-video":{"post":{"tags":["tiktok"],"summary":"公开分享短链解析及详情（最多 5 跳）","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["code"],"properties":{"host":{"anyOf":[{"const":"vm","type":"string"},{"const":"vt","type":"string"}]},"code":{"pattern":"^[A-Za-z0-9_-]{1,80}$","type":"string"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/tiktok/batch-videos":{"post":{"tags":["tiktok"],"summary":"最多 20 条本地顺序聚合，非原生批量","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["videos"],"properties":{"videos":{"minItems":1,"maxItems":20,"type":"array","items":{"additionalProperties":false,"type":"object","required":["username","video_id"],"properties":{"username":{"pattern":"^[A-Za-z0-9_.]{1,64}$","type":"string"},"video_id":{"pattern":"^[1-9][0-9]{9,24}$","type":"string"}}}}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/tiktok/country":{"post":{"tags":["tiktok"],"summary":"账号公开地区字段；未公开时明确返回 not_exposed","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["username"],"properties":{"username":{"pattern":"^[A-Za-z0-9_.]{1,64}$","type":"string"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/tiktok/followers":{"post":{"tags":["tiktok"],"summary":"官网可见粉丝名单单页；可能拒绝匿名访问，不保证完整名单","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["sec_uid"],"properties":{"sec_uid":{"minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},"cursor":{"pattern":"^[0-9]{1,20}$","type":"string"},"limit":{"minimum":1,"maximum":30,"type":"integer"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/tiktok/comments":{"post":{"tags":["tiktok"],"summary":"评论列表与分页","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["video_id"],"properties":{"video_id":{"pattern":"^[1-9][0-9]{9,24}$","type":"string"},"cursor":{"pattern":"^[0-9]{1,20}$","type":"string"},"limit":{"minimum":1,"maximum":30,"type":"integer"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/tiktok/replies":{"post":{"tags":["tiktok"],"summary":"评论回复与分页","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["video_id","comment_id"],"properties":{"video_id":{"pattern":"^[1-9][0-9]{9,24}$","type":"string"},"comment_id":{"pattern":"^[1-9][0-9]{9,24}$","type":"string"},"cursor":{"pattern":"^[0-9]{1,20}$","type":"string"},"limit":{"minimum":1,"maximum":30,"type":"integer"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/youtube/search-channels":{"post":{"tags":["youtube"],"summary":"关键词搜索频道","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["query"],"properties":{"query":{"minLength":1,"maxLength":100,"pattern":"\\S","type":"string"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/youtube/channel":{"post":{"tags":["youtube"],"summary":"频道资料","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["channel_id"],"properties":{"channel_id":{"pattern":"^UC[A-Za-z0-9_-]{22}$","type":"string"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/youtube/videos":{"post":{"tags":["youtube"],"summary":"频道普通视频（最多两页）","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["channel_id"],"properties":{"channel_id":{"pattern":"^UC[A-Za-z0-9_-]{22}$","type":"string"},"pages":{"minimum":1,"maximum":2,"type":"integer"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/youtube/shorts":{"post":{"tags":["youtube"],"summary":"频道 Shorts（最多两页）","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["channel_id"],"properties":{"channel_id":{"pattern":"^UC[A-Za-z0-9_-]{22}$","type":"string"},"pages":{"minimum":1,"maximum":2,"type":"integer"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/youtube/video":{"post":{"tags":["youtube"],"summary":"视频公开统计","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["video_id"],"properties":{"video_id":{"pattern":"^[A-Za-z0-9_-]{11}$","type":"string"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/youtube/comments":{"post":{"tags":["youtube"],"summary":"顶层评论（最多两页）","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["video_id"],"properties":{"video_id":{"pattern":"^[A-Za-z0-9_-]{11}$","type":"string"},"pages":{"minimum":1,"maximum":2,"type":"integer"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/youtube/replies":{"post":{"tags":["youtube"],"summary":"前两页内指定父评论的一页直接回复","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["video_id","comment_id"],"properties":{"video_id":{"pattern":"^[A-Za-z0-9_-]{11}$","type":"string"},"comment_id":{"minLength":1,"maxLength":256,"type":"string"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/instagram/profile":{"post":{"tags":["instagram"],"summary":"公开账号资料","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["username"],"properties":{"username":{"pattern":"^[A-Za-z0-9_.]{1,30}$","type":"string"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/instagram/posts":{"post":{"tags":["instagram"],"summary":"匿名作品分页（预览媒体）","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["username"],"properties":{"username":{"pattern":"^[A-Za-z0-9_.]{1,30}$","type":"string"},"limit":{"minimum":1,"maximum":30,"default":12,"type":"integer"},"cursor":{"minLength":1,"maxLength":4096,"type":"string"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/instagram/post":{"post":{"tags":["instagram"],"summary":"匿名作品详情与有序媒体","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["shortcode"],"properties":{"username":{"pattern":"^[A-Za-z0-9_.]{1,30}$","type":"string"},"shortcode":{"pattern":"^[A-Za-z0-9_-]{1,64}$","type":"string"},"kind":{"anyOf":[{"const":"p","type":"string"},{"const":"reel","type":"string"}]}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/x/profile":{"post":{"tags":["x"],"summary":"公开账号资料","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["username"],"properties":{"username":{"pattern":"^[A-Za-z0-9_]{1,15}$","type":"string"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/x/posts":{"post":{"tags":["x"],"summary":"主页有限帖子发现","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["username"],"properties":{"username":{"pattern":"^[A-Za-z0-9_]{1,15}$","type":"string"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/x/post":{"post":{"tags":["x"],"summary":"公开嵌入帖子详情及媒体预览","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["post_id"],"properties":{"post_id":{"pattern":"^[1-9][0-9]{9,24}$","type":"string"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/x/conversation":{"post":{"tags":["x"],"summary":"有限对话条目，非完整回复树","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["username","post_id"],"properties":{"username":{"pattern":"^[A-Za-z0-9_]{1,15}$","type":"string"},"post_id":{"pattern":"^[1-9][0-9]{9,24}$","type":"string"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/threads/profile":{"post":{"tags":["threads"],"summary":"公开账号资料：用户名或用户 ID","requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"additionalProperties":false,"type":"object","required":["username"],"properties":{"username":{"pattern":"^[A-Za-z0-9_.]{1,30}$","description":"目标公开账号用户名；与其他目标形式互斥","type":"string"}}},{"additionalProperties":false,"type":"object","required":["user_id"],"properties":{"user_id":{"pattern":"^[1-9][0-9]{0,29}$","description":"十进制数字字符串，不接受 JSON number","type":"string"}}}]}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/threads/posts":{"post":{"tags":["threads"],"summary":"用户帖子与作者续帖：用户名或用户 ID","requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"additionalProperties":false,"type":"object","required":["username"],"properties":{"username":{"pattern":"^[A-Za-z0-9_.]{1,30}$","description":"目标公开账号用户名；与其他目标形式互斥","type":"string"},"limit":{"minimum":1,"maximum":30,"type":"integer"},"cursor":{"minLength":1,"maxLength":4096,"pattern":"^[^\\x00-\\x1f]+$","description":"仅使用上一页返回的真实游标","type":"string"}}},{"additionalProperties":false,"type":"object","required":["user_id"],"properties":{"user_id":{"pattern":"^[1-9][0-9]{0,29}$","description":"十进制数字字符串，不接受 JSON number","type":"string"},"limit":{"minimum":1,"maximum":30,"type":"integer"},"cursor":{"minLength":1,"maxLength":4096,"pattern":"^[^\\x00-\\x1f]+$","description":"仅使用上一页返回的真实游标","type":"string"}}}]}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/threads/post":{"post":{"tags":["threads"],"summary":"帖子详情：短码、帖子 ID 或完整链接","requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"additionalProperties":false,"type":"object","required":["username","shortcode"],"properties":{"username":{"pattern":"^[A-Za-z0-9_.]{1,30}$","description":"目标公开账号用户名；与其他目标形式互斥","type":"string"},"shortcode":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"帖子链接中的短码，与 username 一起传入","type":"string"}}},{"additionalProperties":false,"type":"object","required":["post_id"],"properties":{"post_id":{"pattern":"^[1-9][0-9]{0,29}$","description":"十进制数字字符串，不接受 JSON number","type":"string"}}},{"additionalProperties":false,"type":"object","required":["url"],"properties":{"url":{"minLength":1,"maxLength":2048,"description":"完整 HTTPS threads.com/net /@用户名/post/短码 链接；也接受/video/；忽略分享查询参数及片段，不支持短链。与其他目标参数互斥","type":"string"}}}]}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/threads/comments":{"post":{"tags":["threads"],"summary":"目标帖直接回复：短码、帖子 ID 或完整链接","requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"additionalProperties":false,"type":"object","required":["username","shortcode"],"properties":{"username":{"pattern":"^[A-Za-z0-9_.]{1,30}$","description":"目标公开账号用户名；与其他目标形式互斥","type":"string"},"shortcode":{"pattern":"^[A-Za-z0-9_-]{1,64}$","description":"帖子链接中的短码，与 username 一起传入","type":"string"},"limit":{"minimum":1,"maximum":30,"type":"integer"},"cursor":{"minLength":1,"maxLength":4096,"pattern":"^[^\\x00-\\x1f]+$","description":"仅使用上一页返回的真实游标","type":"string"}}},{"additionalProperties":false,"type":"object","required":["post_id"],"properties":{"post_id":{"pattern":"^[1-9][0-9]{0,29}$","description":"十进制数字字符串，不接受 JSON number","type":"string"},"limit":{"minimum":1,"maximum":30,"type":"integer"},"cursor":{"minLength":1,"maxLength":4096,"pattern":"^[^\\x00-\\x1f]+$","description":"仅使用上一页返回的真实游标","type":"string"}}},{"additionalProperties":false,"type":"object","required":["url"],"properties":{"url":{"minLength":1,"maxLength":2048,"description":"完整 HTTPS threads.com/net /@用户名/post/短码 链接；也接受/video/；忽略分享查询参数及片段，不支持短链。与其他目标参数互斥","type":"string"},"limit":{"minimum":1,"maximum":30,"type":"integer"},"cursor":{"minLength":1,"maxLength":4096,"pattern":"^[^\\x00-\\x1f]+$","description":"仅使用上一页返回的真实游标","type":"string"}}}]}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/threads/search":{"post":{"tags":["threads"],"summary":"帖子热门/最新/日期搜索，或账号匹配","requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object","required":["query"],"properties":{"query":{"minLength":1,"maxLength":200,"pattern":"^[^\\x00-\\x1f]+$","description":"搜索关键词","type":"string"},"type":{"description":"默认 posts；users 仅账号匹配，不能传排序或日期","anyOf":[{"const":"posts","type":"string"},{"const":"users","type":"string"}]},"sort":{"description":"帖子排序，默认 top；recent 为最新","anyOf":[{"const":"top","type":"string"},{"const":"recent","type":"string"}]},"after_date":{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"UTC起始日期（包含），须与before_date一起传","type":"string"},"before_date":{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"UTC截止日期（不包含）；上下文续帖可能在范围外","type":"string"},"limit":{"minimum":1,"maximum":30,"description":"最多返回组数或账号数；本地截取，不保证达到该数量","type":"integer"}}}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/threads/replies":{"post":{"tags":["threads"],"summary":"用户发表的回复及原帖上下文","requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"additionalProperties":false,"type":"object","required":["username"],"properties":{"username":{"pattern":"^[A-Za-z0-9_.]{1,30}$","description":"目标公开账号用户名；与其他目标形式互斥","type":"string"},"limit":{"minimum":1,"maximum":30,"type":"integer"},"cursor":{"minLength":1,"maxLength":4096,"pattern":"^[^\\x00-\\x1f]+$","description":"仅使用上一页返回的真实游标","type":"string"}}},{"additionalProperties":false,"type":"object","required":["user_id"],"properties":{"user_id":{"pattern":"^[1-9][0-9]{0,29}$","description":"十进制数字字符串，不接受 JSON number","type":"string"},"limit":{"minimum":1,"maximum":30,"type":"integer"},"cursor":{"minLength":1,"maxLength":4096,"pattern":"^[^\\x00-\\x1f]+$","description":"仅使用上一页返回的真实游标","type":"string"}}}]}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}},"/v1/threads/reposts":{"post":{"tags":["threads"],"summary":"用户转发的帖子及原作者","requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"additionalProperties":false,"type":"object","required":["username"],"properties":{"username":{"pattern":"^[A-Za-z0-9_.]{1,30}$","description":"目标公开账号用户名；与其他目标形式互斥","type":"string"},"limit":{"minimum":1,"maximum":30,"type":"integer"},"cursor":{"minLength":1,"maxLength":4096,"pattern":"^[^\\x00-\\x1f]+$","description":"仅使用上一页返回的真实游标","type":"string"}}},{"additionalProperties":false,"type":"object","required":["user_id"],"properties":{"user_id":{"pattern":"^[1-9][0-9]{0,29}$","description":"十进制数字字符串，不接受 JSON number","type":"string"},"limit":{"minimum":1,"maximum":30,"type":"integer"},"cursor":{"minLength":1,"maxLength":4096,"pattern":"^[^\\x00-\\x1f]+$","description":"仅使用上一页返回的真实游标","type":"string"}}}]}}}},"responses":{"200":{"description":"平台 data、source、meta"},"400":{"description":"参数无效"},"401":{"description":"API Key缺失、撤销或账号暂停"},"403":{"description":"权限不足或计划无效"},"429":{"description":"限流、配额耗尽或并发繁忙；Retry-After给出等待秒数"},"501":{"description":"未实现或已禁用"},"502":{"description":"上游受限或协议变化"},"503":{"description":"数据库、代理或熔断"},"504":{"description":"上游超时"}}}}}}