{"openapi": "3.1.0", "info": {"title": "BusyBee Data", "version": "0.2.2", "description": "Public social media data for AI agents: one normalized schema across TikTok, Instagram, YouTube, X, Douyin and Xiaohongshu. Pay per call; every response reports cost_usd and balance_usd."}, "servers": [{"url": "https://lucydomi.com"}], "components": {"securitySchemes": {"bearerAuth": {"type": "http", "scheme": "bearer", "description": "sk- 开头的 API Key"}, "apiKeyQuery": {"type": "api_key", "in": "query", "name": "api_key"}}}, "security": [{"bearerAuth": []}, {"apiKeyQuery": []}], "paths": {"/mcp/v1/list_platforms": {"post": {"operationId": "list_platforms", "summary": "列出可用的平台、每个平台支持哪些操作、需要哪类密钥", "description": "列出可用的平台、每个平台支持哪些操作、需要哪类密钥。首次使用先调这个。", "requestBody": {"required": false, "content": {"application/json": {"schema": {"type": "object", "properties": {}, "required": []}}}}, "responses": {"200": {"description": "统一字段结果", "content": {"application/json": {"schema": {"type": "object"}}}}}}, "get": {"operationId": "list_platformsGet", "summary": "列出可用的平台、每个平台支持哪些操作、需要哪类密钥", "description": "列出可用的平台、每个平台支持哪些操作、需要哪类密钥。首次使用先调这个。（GET 版，仅适合参数简单的调用）", "parameters": [], "responses": {"200": {"description": "统一字段结果"}}}}, "/mcp/v1/search_creators": {"post": {"operationId": "search_creators", "summary": "按关键词搜索社媒账号/达人，返回 id、handle、昵称、粉丝数、简介", "description": "按关键词搜索社媒账号/达人，返回 id、handle、昵称、粉丝数、简介。", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"platform": {"type": "string", "enum": ["tiktok", "instagram", "youtube", "twitter", "douyin", "xiaohongshu"], "description": "平台：tiktok / instagram / youtube / twitter / douyin / xiaohongshu（国内平台需要国内分组的密钥）"}, "keyword": {"type": "string", "description": "搜索关键词"}, "limit": {"type": "integer", "minimum": 1, "maximum": 50, "default": 10}}, "required": ["platform", "keyword"]}}}}, "responses": {"200": {"description": "统一字段结果", "content": {"application/json": {"schema": {"type": "object"}}}}}}, "get": {"operationId": "search_creatorsGet", "summary": "按关键词搜索社媒账号/达人，返回 id、handle、昵称、粉丝数、简介", "description": "按关键词搜索社媒账号/达人，返回 id、handle、昵称、粉丝数、简介。（GET 版，仅适合参数简单的调用）", "parameters": [{"name": "platform", "in": "query", "required": false, "schema": {"type": "string", "enum": ["tiktok", "instagram", "youtube", "twitter", "douyin", "xiaohongshu"], "description": "平台：tiktok / instagram / youtube / twitter / douyin / xiaohongshu（国内平台需要国内分组的密钥）"}}, {"name": "keyword", "in": "query", "required": false, "schema": {"type": "string", "description": "搜索关键词"}}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "maximum": 50, "default": 10}}], "responses": {"200": {"description": "统一字段结果"}}}}, "/mcp/v1/search_posts": {"post": {"operationId": "search_posts", "summary": "按关键词搜索内容（帖子/视频），返回统一字段：作者、文案、时间、点赞/评论/播放", "description": "按关键词搜索内容（帖子/视频），返回统一字段：作者、文案、时间、点赞/评论/播放。", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"platform": {"type": "string", "enum": ["tiktok", "instagram", "youtube", "twitter", "douyin", "xiaohongshu"], "description": "平台：tiktok / instagram / youtube / twitter / douyin / xiaohongshu（国内平台需要国内分组的密钥）"}, "keyword": {"type": "string", "description": "搜索关键词"}, "limit": {"type": "integer", "minimum": 1, "maximum": 50, "default": 20}}, "required": ["platform", "keyword"]}}}}, "responses": {"200": {"description": "统一字段结果", "content": {"application/json": {"schema": {"type": "object"}}}}}}, "get": {"operationId": "search_postsGet", "summary": "按关键词搜索内容（帖子/视频），返回统一字段：作者、文案、时间、点赞/评论/播放", "description": "按关键词搜索内容（帖子/视频），返回统一字段：作者、文案、时间、点赞/评论/播放。（GET 版，仅适合参数简单的调用）", "parameters": [{"name": "platform", "in": "query", "required": false, "schema": {"type": "string", "enum": ["tiktok", "instagram", "youtube", "twitter", "douyin", "xiaohongshu"], "description": "平台：tiktok / instagram / youtube / twitter / douyin / xiaohongshu（国内平台需要国内分组的密钥）"}}, {"name": "keyword", "in": "query", "required": false, "schema": {"type": "string", "description": "搜索关键词"}}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "maximum": 50, "default": 20}}], "responses": {"200": {"description": "统一字段结果"}}}}, "/mcp/v1/get_creator": {"post": {"operationId": "get_creator", "summary": "查单个账号详情：粉丝数、简介、作品数", "description": "查单个账号详情：粉丝数、简介、作品数。creator 填 handle（去掉 @）或平台 id。", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"platform": {"type": "string", "enum": ["tiktok", "instagram", "youtube", "twitter", "douyin", "xiaohongshu"], "description": "平台：tiktok / instagram / youtube / twitter / douyin / xiaohongshu（国内平台需要国内分组的密钥）"}, "creator": {"type": "string", "description": "账号 handle 或平台 id"}}, "required": ["platform", "creator"]}}}}, "responses": {"200": {"description": "统一字段结果", "content": {"application/json": {"schema": {"type": "object"}}}}}}, "get": {"operationId": "get_creatorGet", "summary": "查单个账号详情：粉丝数、简介、作品数", "description": "查单个账号详情：粉丝数、简介、作品数。creator 填 handle（去掉 @）或平台 id。（GET 版，仅适合参数简单的调用）", "parameters": [{"name": "platform", "in": "query", "required": false, "schema": {"type": "string", "enum": ["tiktok", "instagram", "youtube", "twitter", "douyin", "xiaohongshu"], "description": "平台：tiktok / instagram / youtube / twitter / douyin / xiaohongshu（国内平台需要国内分组的密钥）"}}, {"name": "creator", "in": "query", "required": false, "schema": {"type": "string", "description": "账号 handle 或平台 id"}}], "responses": {"200": {"description": "统一字段结果"}}}}, "/mcp/v1/list_creator_posts": {"post": {"operationId": "list_creator_posts", "summary": "拉某个账号最近发布的作品列表", "description": "拉某个账号最近发布的作品列表。creator 同 get_creator（handle / id / 主页链接皆可）。", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"platform": {"type": "string", "enum": ["tiktok", "instagram", "youtube", "twitter", "douyin", "xiaohongshu"], "description": "平台：tiktok / instagram / youtube / twitter / douyin / xiaohongshu（国内平台需要国内分组的密钥）"}, "creator": {"type": "string", "description": "账号 handle 或平台 id"}, "limit": {"type": "integer", "minimum": 1, "maximum": 50, "default": 20}}, "required": ["platform", "creator"]}}}}, "responses": {"200": {"description": "统一字段结果", "content": {"application/json": {"schema": {"type": "object"}}}}}}, "get": {"operationId": "list_creator_postsGet", "summary": "拉某个账号最近发布的作品列表", "description": "拉某个账号最近发布的作品列表。creator 同 get_creator（handle / id / 主页链接皆可）。（GET 版，仅适合参数简单的调用）", "parameters": [{"name": "platform", "in": "query", "required": false, "schema": {"type": "string", "enum": ["tiktok", "instagram", "youtube", "twitter", "douyin", "xiaohongshu"], "description": "平台：tiktok / instagram / youtube / twitter / douyin / xiaohongshu（国内平台需要国内分组的密钥）"}}, {"name": "creator", "in": "query", "required": false, "schema": {"type": "string", "description": "账号 handle 或平台 id"}}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "maximum": 50, "default": 20}}], "responses": {"200": {"description": "统一字段结果"}}}}, "/mcp/v1/get_post": {"post": {"operationId": "get_post", "summary": "查单条内容详情", "description": "查单条内容详情。post_id 填平台的内容 id。", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"platform": {"type": "string", "enum": ["tiktok", "instagram", "youtube", "twitter", "douyin", "xiaohongshu"], "description": "平台：tiktok / instagram / youtube / twitter / douyin / xiaohongshu（国内平台需要国内分组的密钥）"}, "post_id": {"type": "string", "description": "内容 id"}}, "required": ["platform", "post_id"]}}}}, "responses": {"200": {"description": "统一字段结果", "content": {"application/json": {"schema": {"type": "object"}}}}}}, "get": {"operationId": "get_postGet", "summary": "查单条内容详情", "description": "查单条内容详情。post_id 填平台的内容 id。（GET 版，仅适合参数简单的调用）", "parameters": [{"name": "platform", "in": "query", "required": false, "schema": {"type": "string", "enum": ["tiktok", "instagram", "youtube", "twitter", "douyin", "xiaohongshu"], "description": "平台：tiktok / instagram / youtube / twitter / douyin / xiaohongshu（国内平台需要国内分组的密钥）"}}, {"name": "post_id", "in": "query", "required": false, "schema": {"type": "string", "description": "内容 id"}}], "responses": {"200": {"description": "统一字段结果"}}}}, "/mcp/v1/get_comments": {"post": {"operationId": "get_comments", "summary": "拉某条内容的评论列表，返回统一字段：评论人、内容、点赞、时间", "description": "拉某条内容的评论列表，返回统一字段：评论人、内容、点赞、时间。post_id 可传 id 或链接。", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"platform": {"type": "string", "enum": ["tiktok", "instagram", "youtube", "twitter", "douyin", "xiaohongshu"], "description": "平台：tiktok / instagram / youtube / twitter / douyin / xiaohongshu（国内平台需要国内分组的密钥）"}, "post_id": {"type": "string", "description": "内容 id"}, "limit": {"type": "integer", "minimum": 1, "maximum": 50, "default": 20}}, "required": ["platform", "post_id"]}}}}, "responses": {"200": {"description": "统一字段结果", "content": {"application/json": {"schema": {"type": "object"}}}}}}, "get": {"operationId": "get_commentsGet", "summary": "拉某条内容的评论列表，返回统一字段：评论人、内容、点赞、时间", "description": "拉某条内容的评论列表，返回统一字段：评论人、内容、点赞、时间。post_id 可传 id 或链接。（GET 版，仅适合参数简单的调用）", "parameters": [{"name": "platform", "in": "query", "required": false, "schema": {"type": "string", "enum": ["tiktok", "instagram", "youtube", "twitter", "douyin", "xiaohongshu"], "description": "平台：tiktok / instagram / youtube / twitter / douyin / xiaohongshu（国内平台需要国内分组的密钥）"}}, {"name": "post_id", "in": "query", "required": false, "schema": {"type": "string", "description": "内容 id"}}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "maximum": 50, "default": 20}}], "responses": {"200": {"description": "统一字段结果"}}}}, "/mcp/v1/get_trending": {"post": {"operationId": "get_trending", "summary": "拉平台热搜/热榜（目前支持抖音）", "description": "拉平台热搜/热榜（目前支持抖音）。", "requestBody": {"required": false, "content": {"application/json": {"schema": {"type": "object", "properties": {"platform": {"type": "string", "enum": ["tiktok", "instagram", "youtube", "twitter", "douyin", "xiaohongshu"], "description": "平台：tiktok / instagram / youtube / twitter / douyin / xiaohongshu（国内平台需要国内分组的密钥）", "default": "douyin"}, "limit": {"type": "integer", "minimum": 1, "maximum": 50, "default": 20}}, "required": []}}}}, "responses": {"200": {"description": "统一字段结果", "content": {"application/json": {"schema": {"type": "object"}}}}}}, "get": {"operationId": "get_trendingGet", "summary": "拉平台热搜/热榜（目前支持抖音）", "description": "拉平台热搜/热榜（目前支持抖音）。（GET 版，仅适合参数简单的调用）", "parameters": [{"name": "platform", "in": "query", "required": false, "schema": {"type": "string", "enum": ["tiktok", "instagram", "youtube", "twitter", "douyin", "xiaohongshu"], "description": "平台：tiktok / instagram / youtube / twitter / douyin / xiaohongshu（国内平台需要国内分组的密钥）", "default": "douyin"}}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "maximum": 50, "default": 20}}], "responses": {"200": {"description": "统一字段结果"}}}}, "/mcp/v1/get_comment_insights": {"post": {"operationId": "get_comment_insights", "summary": "评论洞察：拉样本评论后本地聚合，直接给结论——情绪分布、提问占比、高频词、高赞评论", "description": "评论洞察：拉样本评论后本地聚合，直接给结论——情绪分布、提问占比、高频词、高赞评论。", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"platform": {"type": "string", "enum": ["tiktok", "instagram", "youtube", "twitter", "douyin", "xiaohongshu"], "description": "平台：tiktok / instagram / youtube / twitter / douyin / xiaohongshu（国内平台需要国内分组的密钥）"}, "post_id": {"type": "string", "description": "内容 id"}, "sample": {"type": "integer", "minimum": 5, "maximum": 50, "default": 60}}, "required": ["platform", "post_id"]}}}}, "responses": {"200": {"description": "统一字段结果", "content": {"application/json": {"schema": {"type": "object"}}}}}}, "get": {"operationId": "get_comment_insightsGet", "summary": "评论洞察：拉样本评论后本地聚合，直接给结论——情绪分布、提问占比、高频词、高赞评论", "description": "评论洞察：拉样本评论后本地聚合，直接给结论——情绪分布、提问占比、高频词、高赞评论。（GET 版，仅适合参数简单的调用）", "parameters": [{"name": "platform", "in": "query", "required": false, "schema": {"type": "string", "enum": ["tiktok", "instagram", "youtube", "twitter", "douyin", "xiaohongshu"], "description": "平台：tiktok / instagram / youtube / twitter / douyin / xiaohongshu（国内平台需要国内分组的密钥）"}}, {"name": "post_id", "in": "query", "required": false, "schema": {"type": "string", "description": "内容 id"}}, {"name": "sample", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 5, "maximum": 50, "default": 60}}], "responses": {"200": {"description": "统一字段结果"}}}}, "/mcp/v1/check_balance": {"post": {"operationId": "check_balance", "summary": "查当前 API 密钥的账户信息与余额（美元）", "description": "查当前 API 密钥的账户信息与余额（美元）。", "requestBody": {"required": false, "content": {"application/json": {"schema": {"type": "object", "properties": {}, "required": []}}}}, "responses": {"200": {"description": "统一字段结果", "content": {"application/json": {"schema": {"type": "object"}}}}}}, "get": {"operationId": "check_balanceGet", "summary": "查当前 API 密钥的账户信息与余额（美元）", "description": "查当前 API 密钥的账户信息与余额（美元）。（GET 版，仅适合参数简单的调用）", "parameters": [], "responses": {"200": {"description": "统一字段结果"}}}}}}