Return YouTube Dislike 开放 API 与工作原理深度解析votes 接口、数据估算与速率限制【免费下载链接】return-youtube-dislikeChrome extension to return youtube dislikes项目地址: https://gitcode.com/gh_mirrors/re/return-youtube-dislikeReturn YouTube DislikeRYD是一个开源浏览器扩展用于在 YouTube 官方移除 dislike不喜欢计数后把视频的踩数重新显示回界面上。本文以仓库根目录下的 READMEhu.md 为骨架系统讲解该项目的诞生背景、后端数据估算原理、开放 API 的完整调用规范/votes接口、响应字段、错误码与速率限制并结合 Extensions/combined/src/state.js、Extensions/combined/ryd.background.js、Extensions/combined/src/config.js 等源码说明扩展端与后端 API 的实际交互方式。读完本文你将掌握 RYD 数据的获取链路、如何合法调用其开放 API 获取任意视频的点赞/点踩数据以及这些数据在扩展中是如何被消费和展示的。项目背景YouTube 移除 dislike 计数事件2021 年 11 月 10 日Google 宣布将移除 YouTube 视频的公开 dislike不喜欢计数随后在 2021 年 12 月 13 日YouTube API 中的dislike字段也被正式删除。这意味着用户无法在观看视频前通过踩数快速判断内容质量。Return YouTube Dislike 正是为应对这一变化而诞生的开源方案。它作为 Web Extension 支持 Chrome 与 Firefox同时也以 JavaScript Userscript 的形式适配其他浏览器用户脚本版本位于 Extensions/UserScript/Return Youtube Dislike.user.js。项目采用 GPLv3 协议见 LICENSE。工作原理数据从哪来、怎么算YouTube API 不再提供 dislike 统计后RYD 的后端切换为两条腿走路的策略部分来自历史抓取scraped的存档数据部分来自扩展用户投票数据的推算。这一点在 Docs/FAQ.md 中有更详细的说明项目会把所有可获取的数据保存到自有数据库中以便在 Google 官方 API 彻底停供后仍能查询视频的 dislike 数据带有缓存更新频率不高大约每 23 天刷新一次当 API 首次收到某个视频的查询请求时会通过 YouTube API 抓取一次数据写入数据库用于缓存缓存周期约 23 天和归档再返回给调用方。dislike 数量的估算公式根据 Docs/FAQ.md 的说明RYD 使用来自用户的投票数据来推算 dislike 数量对于在 API 关闭之后上传的视频估算公式为RYD Dislike Count (RYD 用户点踩数 / RYD 用户点赞数) × 公开点赞数如果 RYD 数据库中恰好保存了真实点赞/点踩数来自上传者提供或历史存档则最终数值会综合用户投票与存档值且存档值会随其年龄增长而逐渐降低影响力。开放 API 使用条款README 明确允许第三方使用这一开放 API但附带两条必须遵守的限制来源标注Attribution使用方应在显著位置放置指向项目官网 returnyoutubedislike.com 的链接以标明数据来源。速率限制Rate Limiting每个客户端per client的限制为每分钟 100 次、每天最多 10,000 次。超出限制时服务端会返回429状态码提示应用应当暂停请求back off。需要说明的是这两项限制尤其 100/min、10,000/day 与 429 语义来自 READMEhu.md 的明确记载具体的限流窗口与滑动算法细节属于服务端实现未在当前仓库的前端源码中体现如需更细的接口定义可参考仓库 Website/pages/docs/usage-rights.vue 所对应的在线文档页。API 端点与基础 URLAPI 的基础 URLBase URL为https://returnyoutubedislikeapi.com完整的可用端点endpoint列表可通过 Swagger 文档查看https://returnyoutubedislikeapi.com/swagger/index.html仓库中 Website/pages/docs/endpoints.vue 正是官网文档站中渲染这一地址的页面实现其核心逻辑为apiUrl /swagger/index.html。而apiUrl在扩展侧定义于 Extensions/combined/src/config.jsconst PROD_API_URL https://returnyoutubedislikeapi.com; const DEV_API_URL PROD_API_URL; function getApiEndpoint(endpoint) { return ${config.apiUrl}${endpoint.startsWith(/) ? : /}${endpoint}; }从源码结构可以推断扩展的所有请求都经由getApiEndpoint()拼接出完整地址因此只要替换apiUrl即可在开发环境中指向其他后端实例。核心接口获取视频投票数据/votes请求示例查询某个 YouTube 视频 ID 的投票数据使用 HTTP GET 请求/votes?videoIdkxOuG8jMIgI仓库 Website/pages/docs/fetching.vue 给出了该请求的完整请求头示例Accept: text/html,application/xhtmlxml,application/xml;q0.9 Pragma: no-cache Cache-Control: no-cache Connection: keep-alive响应字段解析成功时返回如下 JSON示例视频 ID 为kxOuG8jMIgI{ id: kxOuG8jMIgI, dateCreated: 2021-12-20T12:25:54.418014Z, likes: 27326, dislikes: 498153, rating: 1.212014408444885, viewCount: 3149885, deleted: false }各字段含义如下字段类型含义idstringYouTube 视频 IDdateCreatedstringISO 8601该条数据在 RYD 数据库中的创建时间戳likesnumber点赞数dislikesnumber点踩数RYD 推算后的结果ratingnumber综合评分/比值浮点数含义详见官网文档viewCountnumber播放量deletedboolean视频是否已被删除错误状态码请求不存在的 YouTube ID返回404Not Found请求格式错误的 YouTube ID返回400Bad Request超过速率限制返回429。从源码看扩展如何消费/votes接口常规视频页的查询链路在扩展的内容脚本中每次视频加载后都会触发状态初始化。核心逻辑位于 Extensions/combined/src/state.js 的setState()函数let videoId getVideoId(window.location.href); let likeCount getLikeCountFromButton() || null; let response await fetch(getApiEndpoint(/votes?videoId${videoId}likeCount${likeCount || }), { method: GET, headers: { Accept: application/json, }, }) .then((response) { if (!response.ok) displayError(response.error); return response; }) .then((response) response.json()) .catch(displayError); if (response ! undefined !(traceId in response) !statsSet) { processResponse(response, storedData); }从这段源码可以看出几个实现细节扩展会额外携带当前按钮上显示的点赞数likeCount作为辅助参数供后端在估算时参考响应中若带有traceId字段则说明后端返回的是错误追踪信息而非正常数据扩展会跳过处理数据获取失败时调用displayError()向界面输出暂时不可用的提示。批量上报观看记录后台脚本 Extensions/combined/ryd.background.js 还通过POST /votes批量上报用户浏览过的视频 IDsend_links消息当待上报的 ID 累积到 20 个时一次性发送fetch(getApiEndpoint(/votes), { method: POST, headers: { Content-Type: application/json }, body: JSON.stringify(toSend), });这些用户侧的数据正是后端进行用户投票推算的输入来源之一与 README 中部分来自扩展用户数据的描述相互印证。界面展示点赞/点踩比率条拿到likes/dislikes后扩展通过 Extensions/combined/src/bar.js 的createRateBar()在点赞/点踩按钮下方绘制比率条const widthPercent likes dislikes 0 ? (likes / (likes dislikes)) * 100 : 50;即按点赞占比计算绿色条的宽度同时支持彩色主题coloredBar与 tooltip 百分比显示showTooltipPercentage等可配置项默认配置见 Extensions/combined/src/config.js 的defaultExtConfig。常见问题FAQ 要点视频的 dislike 数不更新数据是缓存的大约每 23 天更新一次属正常现象项目方正在优化更新频率。隐私与安全顾虑详见仓库 SECURITY-FAQ.md。数据来源是什么组合使用 Google API 与抓取数据并在数据库中长期归档以对抗官方 API 停供。安装、贡献与支持安装方式Chrome / Firefox 商店安装 Web Extension其他浏览器使用 Userscript更详细的安装与排障说明见 Docs/Guide__Installing.md 与 Docs/Guide__Troubleshooting.md。参与贡献请先阅读 CONTRIBUTING.md。支持项目可通过项目官网的捐赠页面对项目进行资金支持赞助者信息会展示在仓库与官网上。小结Return YouTube Dislike 的开放 API 为第三方应用提供了一条低成本获取视频点赞/点踩数据的途径以https://returnyoutubedislikeapi.com为基础 URL调用GET /votes?videoId视频ID即可获得结构化 JSON同时必须遵守来源标注与每分钟 100 次、每日 10,000 次的速率限制。扩展端则通过 state.js 查询、ryd.background.js 上报、bar.js 渲染构成查询 → 展示 → 回传的完整数据闭环。若需进一步核对接口细节可直接对照仓库中的 Website/pages/docs/ 系列文档页面与 Docs/FAQ.md。【免费下载链接】return-youtube-dislikeChrome extension to return youtube dislikes项目地址: https://gitcode.com/gh_mirrors/re/return-youtube-dislike创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考