Skip to content

Latest commit

 

History

302 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

Description/简介

OneAPI,提供各种数据API,用户信息、视频列表、详情、点赞、评论数据、综合搜索等,包括:Douyin(抖音)、Xiaohongshu(小红书)、Kuaishou(快手)、Bilibili(哔哩哔哩)、Weibo(微博)、微信公众号、微信视频号、Toutiao(今日头条)、Xigua(西瓜视频)、Lemon8、Tiktok、Youtube等接口、数据、API、爬虫、采集。

我们是一家专业的数据服务提供商,提供标准的 HTTP 接口服务,并可根据您的需求定制化数据服务。

官网 | 接口文档

Contact information/联系方式

可通过以下方式联系我们:

如有任何问题,欢迎联系我们。

API list/API 列表

以下是我们目前提供的各平台接口服务。此列表可能更新不及时,可通过在线实时接口文档,查看最新 API 列表。

Xiaohongshu/小红书

  • 小红书用户信息
  • 小红书用户信息V2
  • 小红书用户信息V3
  • 小红书用户笔记列表
  • 小红书用户笔记列表V3
  • 小红书笔记详情
  • 小红书笔记评论
  • 小红书笔记子评论
  • 小红书笔记搜索
  • 小红书用户搜索
  • 小红书获取搜索联想词
  • ...

Douyin/抖音

  • 抖音用户信息
  • 抖音用户作品列表
  • 抖音视频详情
  • 抖音视频一级评论
  • 抖音视频子评论
  • 抖音直播间信息
  • 抖音直播间用户列表
  • 抖音检查用户是否直播
  • 抖音综合搜索
  • 抖音搜索视频
  • 抖音搜索用户
  • 抖音搜索话题
  • 抖音话题详情
  • 抖音话题下的视频
  • 抖音搜索音乐
  • 抖音音乐相关的视频
  • 抖音用户标签
  • 抖音用户合集
  • 抖音合集下的视频
  • 抖音精选
  • 抖音热榜
  • ...

Douyin-APP/抖音APP

  • 抖音用户信息
  • 抖音用户作品列表
  • 抖音视频详情
  • 抖音批量视频详情
  • 抖音视频一级评论
  • 抖音视频子评论
  • 抖音作品统计数据(包含播放数)
  • 抖音获取作品最高画质播放链接
  • ...

Kuaishou/快手

  • 快手用户信息
  • 快手用户作品列表
  • 快手视频详情
  • 快手视频评论
  • 快手热搜榜单
  • 快手视频分享短链
  • ...

Bilibili/哔哩哔哩

  • 用户信息
  • 用户所有动态
  • 用户投稿的视频列表
  • 作品详情
  • 作品评论
  • 搜索数据
  • 综合热门
  • 排行榜
  • ...

Weibo/微博

  • 用户信息
  • 用户发布
  • 用户视频列表
  • 作品详情
  • 作品评论
  • 作品子评论
  • 短视频信息
  • 话题数据
  • 话题详情
  • 微博热搜列表
  • 综合搜索
  • ...

Toutiao/今日头条

  • 用户主页发布
  • 视频详情
  • 文章详情
  • 文章一级评论
  • 文章子评论
  • ...

Xiguashipin/西瓜视频

  • 用户信息
  • 用户发布视频列表
  • 视频详情
  • ...

Tiktok

  • 用户信息
  • 用户主页视频列表
  • 视频详情
  • 综合搜索
  • 搜索用户
  • ...

Youtube

  • 获取用户channel_id
  • 获取用户发布列表
  • 获取频道播放列表
  • 获取播放列表视频
  • 获取视频信息
  • 获取视频评论
  • 综合搜索
  • ...

Lemon8

  • 用户信息
  • 用户发布
  • 视频详情
  • ...

User Guide/使用导览

注册账号

注册地址 https://getoneapi.com/register

Authorization/鉴权

要访问我们的 API,您必须在每个请求的请求头中添加您的API秘钥进行身份验证:

  • 请求头
Authorization: Bearer <your_apikey>
  • 示例请求
curl -X POST https://api.getoneapi.com/api/douyin/user_detail 
     -H "Content-Type: application/json" 
     -H "Authorization: Bearer 5hlBzQDigT4GZJRTL3GeUSxIAC2W0t4gjvn8fizJCCsawhFS1I2R4T8DbhqXYV6v" 
     -d '{"sec_user_id": "xxxxx"}'

要获取API密钥,请注册

Response/响应

  • 所有 API 响应都返回 HTTP 状态代码 200 OK,无论业务结果如何。
  • 您必须依赖 JSON 响应主体中的 code 字段来确定业务级结果。

示例响应

{
  "code": 200,
  "message": "",
  "data": { ... }
}

业务代码参考

code 说明 是否计费 建议处理方式
200 请求成功,data 中为接口返回数据 正常处理数据
0 请求失败,例如参数不正确、或其他业务异常 可检查参数;如为临时性失败可有限重试
301 账户余额不足 请充值后重试
302 当前 API 密钥的可用额度不足 请在控制台调整该 API 密钥额度,或更换其他可用密钥
401 未授权:未提供 API 密钥、密钥无效、密钥已禁用或已删除 检查 Authorization: Bearer <API_KEY> 请求头及密钥状态
403 账户不可用:账户已被禁用 请联系支持人员
404 API 不存在、已下线或暂不可用 检查请求路径,或前往定价/文档页面确认接口状态
429 请求速率超过当前限制 请等待后重试,并降低并发或请求频率

超时建议

虽然大多数 API 请求会在几秒钟内响应,但我们建议将请求超时设置为至少 60 秒。 这并不表示我们的 API 很慢,它只是有助于避免由于临时网络问题或客户端超时而导致的意外错误或重复收费。

重试/切换策略

  • 虽然大多数 API 请求会在几秒钟内响应成功并返回数据,但也有部分不太稳定的接口,可以尝试多次请求(建议5次或5次以内,否则会触发风控,导致账户异常!),直到请求成功,请勿担心重复计费,只有成功的请求code=200才会计费。
  • 部分接口存在多版本,V1、V2... 可以加入重试切换策略,在请求失败时切换另一个版本再次重试请求(注意:不同版本之间可能存在响应数据结构不一致的情况,请自行比对)。

Request rate/速率限制

平台采用按账户的 RPS(Requests Per Second,每秒请求数)限速机制,以保障接口稳定性和账户安全。

  • 新注册账户默认拥有 10 RPS
  • 账户 RPS 作用于整个账户,同一账户下的全部 API 密钥共享该请求速率;创建多个 API 密钥不会增加总 RPS。
  • 您可以在控制台的 RPS 页面开通或升级套餐,最高可升级至 100 RPS
  • 部分 API 可能配置独立的固定 RPS 限制。此类接口的独立限制优先级高于账户 RPS,账户升级不会覆盖该接口的固定限制;请以对应 API 文档或定价页标注为准。
  • 限速采用平滑的令牌桶机制控制。短时间内可能允许少量突发请求,但请不要依赖“自然秒”边界进行并发控制。

当请求超过有效 RPS 时,接口将返回:

{
  "code": 429,
  "message": "Rate limit exceeded",
  "data": null
}

触发 429 不会扣费。建议客户端采用退避重试策略,例如从 200~500ms 开始等待,并逐次增加等待时间,同时加入随机抖动;不要在短时间内无限重试。 建议将客户端并发数控制在当前账户或接口实际 RPS 范围内。对于耗时较长的接口,可保留较长的请求超时时间,但不要因客户端超时立即高频重复发起相同请求。

Support&Feedback/支持与反馈

如有任何疑问、定价详情、定制API,请随时通过我们的支持页面联系我们:

联系我们

⭐ 如果这个项目对您有帮助,请给我们一个Star!

About

OneAPI,提供各种数据API,用户信息、视频列表、详情、点赞、评论数据、综合搜索等,包括:Douyin(抖音)、Xiaohongshu(小红书)、Kuaishou(快手)、Bilibili(哔哩哔哩)、Weibo(微博)、Toutiao(今日头条)、Xigua(西瓜视频)、Lemon8、Tiktok、Youtube等接口、数据、API、爬虫、采集。

Topics

Resources

Stars

98 stars

Watchers

9 watching

Forks

Releases

Packages

Contributors

Languages