社交媒体数据 API

GET /v1/social-media/data/* 参考文档，包括社交平台数据路径、查询参数、固定价格和响应处理。

通过一个 API 访问 16 个社交媒体平台的 800 多个端点。你可以获取视频、用户资料、评论、搜索结果、直播、热门内容等数据。

端点

GET https://api.leaper.one/v1/social-media/data/{platform}/{interface}/{action}

所有查询参数都会转发给上游服务，响应以原始格式返回。

快速开始

curl -G "https://api.leaper.one/v1/social-media/data/bilibili/web/fetch_one_video" \
  --data-urlencode "url=https://www.bilibili.com/video/BV1GJ411x7h7" \
  -H "Authorization: Bearer sk-your-api-key"

支持的平台

平台	前缀	端点数	功能
抖音	`douyin/`	248	视频、用户、搜索、直播、榜单、创作者数据分析
TikTok	`tiktok/`	109	视频、用户、搜索、热门内容、评论、话题标签
Bilibili	`bilibili/`	41	视频、用户、搜索、直播、弹幕、字幕
YouTube	`youtube/`	25	视频、频道、搜索、评论、播放列表
Instagram	`instagram/`	52	帖子、Reels、快拍、用户资料、搜索
Twitter/X	`twitter/`	28	推文、用户、搜索、趋势、Spaces
微博	`weibo/`	30	帖子、用户、搜索、热门内容
小红书	`xiaohongshu/`	38	笔记、用户、搜索
快手	`kuaishou/`	29	视频、用户、搜索、直播
微信	`wechat/`	8	公众号、视频号
Threads	`threads/`	11	帖子、用户资料
LinkedIn	`linkedin/`	4	用户资料、帖子
知乎	`zhihu/`	6	回答、文章、用户
Lemon8	`lemon8/`	8	帖子、用户
网易云音乐	`netease/`	12	歌曲、播放列表、用户
Reddit	`reddit/`	9	帖子、子版块、评论
混合模式	`hybrid/`	2	从 URL 自动识别平台

如需查看所有端点及其参数的完整列表，请获取 GET https://api.leaper.one/openapi.json 提供的 OpenAPI 规范。该规范包含每个可用端点和完整的参数定义。

平台示例

Bilibili

# Get video details
curl -G "https://api.leaper.one/v1/social-media/data/bilibili/web/fetch_video_detail" \
  --data-urlencode "bvid=BV1GJ411x7h7" \
  -H "Authorization: Bearer sk-your-api-key"

# Get video play URL (for downloading)
curl -G "https://api.leaper.one/v1/social-media/data/bilibili/web/fetch_video_playurl" \
  --data-urlencode "bvid=BV1GJ411x7h7" \
  --data-urlencode "cid=171776208" \
  -H "Authorization: Bearer sk-your-api-key"

# Get user profile
curl -G "https://api.leaper.one/v1/social-media/data/bilibili/web/fetch_user_profile" \
  --data-urlencode "uid=546195" \
  -H "Authorization: Bearer sk-your-api-key"

# Search videos
curl -G "https://api.leaper.one/v1/social-media/data/bilibili/web/fetch_general_search" \
  --data-urlencode "keyword=programming" \
  -H "Authorization: Bearer sk-your-api-key"

# Get video comments
curl -G "https://api.leaper.one/v1/social-media/data/bilibili/web/fetch_video_comments" \
  --data-urlencode "bvid=BV1GJ411x7h7" \
  -H "Authorization: Bearer sk-your-api-key"

# Get video danmaku (bullet comments)
curl -G "https://api.leaper.one/v1/social-media/data/bilibili/web/fetch_video_danmaku" \
  --data-urlencode "cid=171776208" \
  -H "Authorization: Bearer sk-your-api-key"

# Get video subtitles
curl -G "https://api.leaper.one/v1/social-media/data/bilibili/web/fetch_video_subtitle" \
  --data-urlencode "bvid=BV1GJ411x7h7" \
  -H "Authorization: Bearer sk-your-api-key"

Bilibili 主要端点：

端点	说明
`bilibili/web/fetch_one_video`	通过 URL 获取视频
`bilibili/web/fetch_video_detail`	通过 BV 号获取视频详情
`bilibili/web/fetch_video_playurl`	获取视频播放或下载地址
`bilibili/web/fetch_video_comments`	获取视频评论
`bilibili/web/fetch_video_danmaku`	获取弹幕
`bilibili/web/fetch_video_subtitle`	获取字幕
`bilibili/web/fetch_user_profile`	获取用户资料
`bilibili/web/fetch_user_post_videos`	获取用户上传的视频
`bilibili/web/fetch_general_search`	搜索视频
`bilibili/web/fetch_hot_search`	获取热门搜索
`bilibili/web/fetch_live_room_detail`	获取直播间信息
`bilibili/web/bv_to_aid`	将 BV 号转换为 AV 号

抖音

# Get video by share URL
curl -G "https://api.leaper.one/v1/social-media/data/douyin/web/fetch_one_video_by_share_url" \
  --data-urlencode "url=https://v.douyin.com/L4FJNR3/" \
  -H "Authorization: Bearer sk-your-api-key"

# Get video by aweme_id
curl -G "https://api.leaper.one/v1/social-media/data/douyin/web/fetch_one_video" \
  --data-urlencode "aweme_id=7123456789" \
  -H "Authorization: Bearer sk-your-api-key"

# Search videos
curl -G "https://api.leaper.one/v1/social-media/data/douyin/web/fetch_general_search_result" \
  --data-urlencode "keyword=cooking" \
  -H "Authorization: Bearer sk-your-api-key"

TikTok

# Get video details
curl -G "https://api.leaper.one/v1/social-media/data/tiktok/web/fetch_post_detail" \
  --data-urlencode "aweme_id=7123456789" \
  -H "Authorization: Bearer sk-your-api-key"

# Get user profile
curl -G "https://api.leaper.one/v1/social-media/data/tiktok/web/fetch_user_profile" \
  --data-urlencode "secUid=MS4wLjABAAAA..." \
  -H "Authorization: Bearer sk-your-api-key"

# Search
curl -G "https://api.leaper.one/v1/social-media/data/tiktok/web/fetch_search_video" \
  --data-urlencode "keyword=dance" \
  -H "Authorization: Bearer sk-your-api-key"

YouTube

# Get video info
curl -G "https://api.leaper.one/v1/social-media/data/youtube/web/get_video_info" \
  --data-urlencode "video_id=dQw4w9WgXcQ" \
  -H "Authorization: Bearer sk-your-api-key"

# Get channel info
curl -G "https://api.leaper.one/v1/social-media/data/youtube/web/get_channel_info" \
  --data-urlencode "channel_id=UCuAXFkgsw1L7xaCfnd5JJOw" \
  -H "Authorization: Bearer sk-your-api-key"

Instagram

# Get post by URL
curl -G "https://api.leaper.one/v1/social-media/data/instagram/v1/fetch_post_by_url" \
  --data-urlencode "url=https://www.instagram.com/p/ABC123/" \
  -H "Authorization: Bearer sk-your-api-key"

# Get user profile
curl -G "https://api.leaper.one/v1/social-media/data/instagram/web/fetch_user_info_by_username" \
  --data-urlencode "username=instagram" \
  -H "Authorization: Bearer sk-your-api-key"

Twitter/X

# Get tweet details
curl -G "https://api.leaper.one/v1/social-media/data/twitter/web/fetch_tweet_detail" \
  --data-urlencode "tweet_id=1234567890" \
  -H "Authorization: Bearer sk-your-api-key"

# Get user profile
curl -G "https://api.leaper.one/v1/social-media/data/twitter/web/fetch_user_profile" \
  --data-urlencode "screen_name=elonmusk" \
  -H "Authorization: Bearer sk-your-api-key"

混合模式（自动识别平台）

# Auto-detect platform from any social media URL
curl -G "https://api.leaper.one/v1/social-media/data/hybrid/video_data" \
  --data-urlencode "url=https://v.douyin.com/L4FJNR3/" \
  -H "Authorization: Bearer sk-your-api-key"

响应格式

通用响应结构如下：

{
  "code": 200,
  "data": {
    // Platform-specific data
  }
}

code: 200 或 code: 0 表示请求成功。

错误响应

路径无效（400）

{ "error": { "message": "Invalid path", "type": "invalid_request_error" } }

平台不可用（403）

{ "error": { "message": "Platform \"admin\" is not available", "type": "invalid_request_error" } }

上游超时（504）

{ "error": { "message": "Upstream request timed out", "type": "server_error" } }

上游不可用（503）

{ "error": { "message": "Failed to reach upstream service", "type": "server_error" } }

价格

每次成功请求 $0.01。 请求失败（HTTP 4xx/5xx）不会计费。

与视频解析 API 的比较

功能	视频解析 API	社交媒体数据 API
端点	`GET /v1/social-media/video/extract`	`GET /v1/social-media/data/*`
输入	任意社交媒体 URL	平台专用 API 路径和参数
响应	标准化格式	上游原始响应
使用场景	快速下载视频	访问完整的平台 API
范围	仅视频解析	覆盖 16 个平台的 800 多个端点
价格	$0.01/次	$0.01/次

提示： 如果只需要通过 URL 下载视频，请使用视频解析 API，它的接口更简单，响应格式也经过标准化。需要用户资料、搜索、评论、直播等完整平台功能时，请使用社交媒体数据 API。

注意事项

所有端点都使用 GET 请求，并通过查询字符串传递参数。
媒体 URL（视频、图片）通常具有时效性。获取后请尽快下载。
部分端点可能需要平台专用 ID。如有需要，请先调用相应的搜索或查询端点。
如需包含所有参数的完整端点目录，请将 OpenAPI 规范导入 Postman 或 Swagger UI。

目录