{"openapi":"3.1.0","info":{"title":"Social Media API Gateway","description":"\n## 社交媒体API统一网关\n\n聚合七大中文社交媒体平台API，统一接口格式，一键调用。\n\n### 支持平台\n\n| 平台 | 状态 | 端点数 |\n|------|------|--------|\n| 微博 Weibo | ✅ | 5 |\n| 贴吧 Tieba | ✅ | 3 |\n| B站 Bilibili | ✅ | 9 |\n| 抖音 Douyin | ✅ | 4 |\n| 知乎 Zhihu | ⚠️ | 1 |\n| 小红书 Xiaohongshu | ✅ | 2 |\n| 快手 Kuaishou | ✅ | 2 |\n\n### 特色功能\n- 🔴 **直播弹幕** — B站/抖音实时弹幕抓取\n- 📺 **直播列表** — B站/抖音分类直播\n- 🔍 **全平台搜索** — 微博/贴吧/B站/抖音/小红书/快手\n- 📊 **热搜榜单** — 微博/B站/抖音/快手\n\n### 技术栈\n- FastAPI + Uvicorn\n- Playwright (抖音搜索/直播)\n- curl_cffi TLS指纹模拟 (快手)\n- WebSocket + Protobuf/Brotli (弹幕)\n- xhshow纯Python签名 (小红书)\n","contact":{"name":"Social API Gateway","url":"https://localhost:8900/docs"},"license":{"name":"MIT"},"version":"2.0.0"},"paths":{"/weibo/search":{"get":{"tags":["微博 Weibo"],"summary":"Weibo Search","operationId":"weibo_search_weibo_search_get","parameters":[{"name":"keyword","in":"query","required":true,"schema":{"type":"string","title":"Keyword"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/weibo/hot-search":{"get":{"tags":["微博 Weibo"],"summary":"Weibo Hot Search","operationId":"weibo_hot_search_weibo_hot_search_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/weibo/hot-feed":{"get":{"tags":["微博 Weibo"],"summary":"Weibo Hot Feed","operationId":"weibo_hot_feed_weibo_hot_feed_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/weibo/user/{uid}":{"get":{"tags":["微博 Weibo"],"summary":"Weibo User","operationId":"weibo_user_weibo_user__uid__get","parameters":[{"name":"uid","in":"path","required":true,"schema":{"type":"string","title":"Uid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/weibo/detail/{wid}":{"get":{"tags":["微博 Weibo"],"summary":"Weibo Detail","operationId":"weibo_detail_weibo_detail__wid__get","parameters":[{"name":"wid","in":"path","required":true,"schema":{"type":"string","title":"Wid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/tieba/personalized":{"get":{"tags":["贴吧 Tieba"],"summary":"Tieba Personalized","operationId":"tieba_personalized_tieba_personalized_get","parameters":[{"name":"load_type","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Load Type"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/tieba/search":{"get":{"tags":["贴吧 Tieba"],"summary":"Tieba Search","description":"贴吧帖子列表 (按贴吧名)","operationId":"tieba_search_tieba_search_get","parameters":[{"name":"kw","in":"query","required":true,"schema":{"type":"string","title":"Kw"}},{"name":"pn","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Pn"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/tieba/forum/{kw}":{"get":{"tags":["贴吧 Tieba"],"summary":"Tieba Forum","operationId":"tieba_forum_tieba_forum__kw__get","parameters":[{"name":"kw","in":"path","required":true,"schema":{"type":"string","title":"Kw"}},{"name":"pn","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Pn"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/bilibili/search":{"get":{"tags":["B站 Bilibili"],"summary":"Bili Search","operationId":"bili_search_bilibili_search_get","parameters":[{"name":"keyword","in":"query","required":true,"schema":{"type":"string","title":"Keyword"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/bilibili/hot-search":{"get":{"tags":["B站 Bilibili"],"summary":"Bili Hot Search","operationId":"bili_hot_search_bilibili_hot_search_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/bilibili/ranking":{"get":{"tags":["B站 Bilibili"],"summary":"Bili Ranking","operationId":"bili_ranking_bilibili_ranking_get","parameters":[{"name":"rid","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Rid"}},{"name":"type_","in":"query","required":false,"schema":{"type":"string","default":"all","title":"Type "}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/bilibili/video/{bvid}":{"get":{"tags":["B站 Bilibili"],"summary":"Bili Video","operationId":"bili_video_bilibili_video__bvid__get","parameters":[{"name":"bvid","in":"path","required":true,"schema":{"type":"string","title":"Bvid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/bilibili/comments/{id}":{"get":{"tags":["B站 Bilibili"],"summary":"Bili Comments","operationId":"bili_comments_bilibili_comments__id__get","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","title":"Id"}},{"name":"pn","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Pn"}},{"name":"ps","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Ps"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/bilibili/live":{"get":{"tags":["B站 Bilibili"],"summary":"Bili Live","operationId":"bili_live_bilibili_live_get","parameters":[{"name":"parent_area_id","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Parent Area Id"}},{"name":"area_id","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Area Id"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/bilibili/live/areas":{"get":{"tags":["B站 Bilibili"],"summary":"Bili Live Areas","operationId":"bili_live_areas_bilibili_live_areas_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/bilibili/danmaku/{room_id}":{"get":{"tags":["B站 Bilibili"],"summary":"Bili Danmaku Ep","operationId":"bili_danmaku_ep_bilibili_danmaku__room_id__get","parameters":[{"name":"room_id","in":"path","required":true,"schema":{"type":"integer","title":"Room Id"}},{"name":"duration","in":"query","required":false,"schema":{"type":"integer","maximum":60,"default":30,"title":"Duration"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/bilibili/user/{mid}":{"get":{"tags":["B站 Bilibili"],"summary":"Bili User","operationId":"bili_user_bilibili_user__mid__get","parameters":[{"name":"mid","in":"path","required":true,"schema":{"type":"string","title":"Mid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/douyin/hot-search":{"get":{"tags":["抖音 Douyin"],"summary":"Douyin Hot Search","operationId":"douyin_hot_search_douyin_hot_search_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/douyin/search":{"get":{"tags":["抖音 Douyin"],"summary":"Douyin Search","operationId":"douyin_search_douyin_search_get","parameters":[{"name":"keyword","in":"query","required":true,"schema":{"type":"string","title":"Keyword"}},{"name":"count","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Count"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/douyin/live":{"get":{"tags":["抖音 Douyin"],"summary":"Douyin Live","operationId":"douyin_live_douyin_live_get","parameters":[{"name":"category","in":"query","required":false,"schema":{"type":"string","default":"4_102","title":"Category"}},{"name":"count","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Count"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/douyin/danmaku/{live_id}":{"get":{"tags":["抖音 Douyin"],"summary":"Douyin Danmaku Ep","operationId":"douyin_danmaku_ep_douyin_danmaku__live_id__get","parameters":[{"name":"live_id","in":"path","required":true,"schema":{"type":"string","title":"Live Id"}},{"name":"duration","in":"query","required":false,"schema":{"type":"integer","maximum":60,"default":30,"title":"Duration"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/zhihu/info":{"get":{"tags":["知乎 Zhihu"],"summary":"Zhihu Info","operationId":"zhihu_info_zhihu_info_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/xhs/homefeed":{"get":{"tags":["小红书 Xiaohongshu"],"summary":"Xhs Feed","operationId":"xhs_feed_xhs_homefeed_get","parameters":[{"name":"num","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Num"}},{"name":"category","in":"query","required":false,"schema":{"type":"string","default":"homefeed_recommend","title":"Category"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/xhs/search":{"get":{"tags":["小红书 Xiaohongshu"],"summary":"Xhs Search Ep","operationId":"xhs_search_ep_xhs_search_get","parameters":[{"name":"keyword","in":"query","required":true,"schema":{"type":"string","title":"Keyword"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/xhs/info":{"get":{"tags":["小红书 Xiaohongshu"],"summary":"Xhs Info","operationId":"xhs_info_xhs_info_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/kuaishou/hot-rank":{"get":{"tags":["快手 Kuaishou"],"summary":"Kuaishou Hot Rank","operationId":"kuaishou_hot_rank_kuaishou_hot_rank_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/kuaishou/search":{"get":{"tags":["快手 Kuaishou"],"summary":"Kuaishou Search","operationId":"kuaishou_search_kuaishou_search_get","parameters":[{"name":"keyword","in":"query","required":true,"schema":{"type":"string","title":"Keyword"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/kuaishou/info":{"get":{"tags":["快手 Kuaishou"],"summary":"Kuaishou Info","operationId":"kuaishou_info_kuaishou_info_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/":{"get":{"summary":"Root","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"tags":[{"name":"微博 Weibo","description":"微博搜索/热搜/话题/用户/详情"},{"name":"贴吧 Tieba","description":"百度贴吧推荐/搜索/吧信息"},{"name":"B站 Bilibili","description":"B站搜索/排行/视频/评论/直播/弹幕"},{"name":"抖音 Douyin","description":"抖音热搜/搜索/直播/弹幕"},{"name":"知乎 Zhihu","description":"知乎API（IP风控中）"},{"name":"小红书 Xiaohongshu","description":"小红书推荐/搜索"},{"name":"快手 Kuaishou","description":"快手热搜/搜索"}]}