RepoDaily · 2026-08-16 · Self-hosted app

public-apis 登顶趋势榜:2476 星的免费 API 清单里到底有什么

#1 Self-hosted app Python +2,476 public-apis/public-apis 打开仓库

8 月 16 日趋势榜第一名不是框架,而是一份社区人工维护的免费 API Markdown 清单。本文拆解它的五列条目格式、维护规则,以及何时值得 fork。

项目类型Self-hosted app
最适合几分钟内就要选定免费 API 的原型开发者;想把 MIT 授权清单 fork 成内部 API 目录的团队
风险等级低(纯文本,无运行时)
评估时间10 分钟以内

核心问题: 表格行指向的第三方 API 是否仍然免费、仍然可用?条目靠人工维护,动工前需逐条复核。

93/100

RepoDaily 采用评分

RepoDaily 将该项目的采用分评为 93/100(强):分数来自文章来源、安装路径、生产风险、差异化、许可证清晰度以及 AI/Agent 适配度。

基于 RepoDaily 来源和采用说明的方向性评分,不是基准测试。风险: 低
96证据质量

包含 4 个来源、覆盖 3 类来源;如有 RepoDaily 独有模块,会进一步提高证据分。

98可安装/可试用性

检测到 6 个工作流步骤、4 个下一步动作,以及 3 个命令/安装信号。

87维护可信度

趋势热度为 +2,476 stars;如内容中有 release、issue 或维护信号,会提高维护可信度。

100生产准备度

采纳风险标记为 low,并包含 6 条安全说明与 3 条跳过条件。

100差异化

3 个机会视角、4 个替代方案,以及 3 个类型化模块支撑差异化判断。

82许可证清晰度

文章中包含许可证来源或许可证表述。

66Agent / AI 适配度

文章正文和元数据中检测到 3 个 AI/Agent 相关信号。

项目概览

public-apis/public-apis 在 2026 年 8 月 16 日登上 GitHub 趋势榜首,周期内新增 2476 星,而它靠的不是框架、库或服务。仓库描述写得很直白:'A collective list of free APIs'。条目由社区成员与 APILayer 的员工人工维护,整个目录放在一份 MIT 授权的 Markdown 里,可以读、可以复制、可以 fork。

如今的 README 开头先是一段商业公告:APILayer 统一套件,主打'一个账号、一个控制台、一个 API key',覆盖 IPstack、Marketstack、Aviationstack、Positionstack、Mediastack、Mailboxlayer、Countrylayer、Serpstack、Scrapestack。README 称 fork 官方 APILayer Postman Collection 后'60 秒内'即可上手,还附了 Discord 服务器链接,用于获取更新、提问和随机社区通话。真正的目录,免费 API 表格,排在这段推广之下。

把它归为'自托管应用'需要一句澄清:没有可运行的应用。GitHub 标注主语言为 Python,但你实际消费的是 Markdown 表格。这里的'自托管'指 fork 仓库并维护一份裁剪过的清单副本,MIT 许可证(Copyright (c) 2022 public-apis)明确允许复制、修改与再许可,只需保留版权声明。

让这份清单经久耐用的是它的条目格式。每个 API 是一行五项事实:链接到官方文档的名称、由贡献规则限制在 100 字符以内的描述、是否支持 HTTPS、是否支持 CORS,以及需要什么认证。这恰好回答了开发者原本要逐家核对的几个问题。

解决什么问题

  • 找真正免费的 API 通常要逐个翻定价页;清单把这一步压缩成表格行。
  • 各家认证方式不同,OAuth、apiKey 字符串、X-Mashape-Key 头、User-Agent 头或无需认证,猜错的代价是返工。
  • 浏览器端调用没有 CORS 的 API 会直接失败;CONTRIBUTING.md 明确写着:没有正确的 CORS 配置,API 只能在服务端使用。
  • 公开 API 目录天然招来营销投稿;维护者在文档中写明拒绝以营销为目的的 PR,坚持把它当社区工具。

工作原理

  1. 打开 README.md,选一个分类小节;条目在各分区内按字母顺序排列。
  2. 读一行:API 名称链接到文档,描述不超过 100 字符,Auth、HTTPS、CORS 三列直接给出关键信息。
  3. 按固定词表理解 Auth:OAuth、apiKey、X-Mashape-Key、No、User-Agent。
  4. 按 Yes、No、Unknown 理解 CORS;No 意味着只能在服务端调用,不能在浏览器页面直连。
  5. 若该行带 Call this API 链接,fork 对应的 Postman 集合;APILayer 套件在 README 中链接了官方集合。
  6. 想自托管:按 MIT 条款 fork 仓库,删除未核验的分类,并保留 LICENSE 中的版权声明。

仓库里到底有什么:一个文件与一套格式

目录是 README.md 中一组按字母排序的 Markdown 表格。每行遵循 CONTRIBUTING.md 固定的格式:| API | Description | Auth | HTTPS | CORS | Call this API |。文档给出的示例条目是 NASA('NASA data, including imagery'),Auth 为 No、HTTPS 为 Yes、CORS 为 Yes。描述不得超过 100 字符,且每列表格两侧各留一个空格。

有两列是封闭词表。Auth 只接受 OAuth、apiKey、X-Mashape-Key、No、User-Agent 五个值;CORS 只接受 Yes、No、Unknown。Call this API 列在存在时链接 Postman 集合。关键文件共三个:README.md(目录本体)、CONTRIBUTING.md(格式与规则)、LICENSE(MIT)。

一次坐下来就能完成的试用路径

  • 打开 README.md,跳到目标分类小节读表格;每个 API 名称都直接链接到其文档。
  • 先按 Auth 与 CORS 过滤:Auth = No 且 CORS = Yes 的行无需密钥,可在浏览器页面直接调用。
  • 要用被推广的 APILayer 套件,fork README 链接的官方 Postman 集合;README 宣称 60 秒内上手。
  • 自托管方式:fork 仓库,删掉没有核验过的分类,并保留 LICENSE 中的 MIT 版权声明。

维护规则,以及清单会过时的位置

  • 每个 PR 只加一个链接;PR 标题格式为 'Add Api-name API'(文档示例:'Add Blockchain API');提交需 squash 后再送审。
  • 描述上限 100 字符,各分类内强制字母排序。
  • 营销目的的 PR 会被书面拒绝;API 必须完全免费或至少有免费层,且不得先购买设备或服务才能使用。
  • 已收录 API 的新版本不单独收录;CONTRIBUTING.md 注明旧版本会被弃用。
  • 源资料中没有自动化存活检测,表格行可能比它指向的端点活得更久。

谁适合关注

适合关注

  • 黑客松与演示项目:几分钟内选定免费数据源。
  • fork MIT 授权表格、裁剪后作为内部 API 短名单的团队。
  • 浏览器端项目:CORS 列直接预筛可以直连的 API。

可以先跳过

  • 需要 SLA、支持合同或在线率保证的生产服务,仓库只提供链接,不运营这些 API。
  • 需要机器可读 OpenAPI 规范而非人工可读 Markdown 的人。
  • 承受不起第三方 API 消失或转入付费的项目。

风险与注意事项

低

仓库交付的是 MIT 授权的文本,没有安装、没有运行时;真正的风险在被链接的第三方服务商一侧。

  • 无运行时:交付物只有 README.md、CONTRIBUTING.md 与 LICENSE。
  • MIT 许可证(Copyright (c) 2022 public-apis)允许复制、修改与再许可,仅需保留声明。
  • 表格行指向外部服务商,其定价、密钥或可用性的变化不会同步到本仓库。
  • 维护靠人工,每 PR 一个链接、描述 100 字符上限,源资料中未见自动存活校验。
  • 仓库本身不索取凭据、不执行任何代码;风险从你调用被列出的服务商开始。
  • Auth 列预先标明凭据模型:OAuth、apiKey、X-Mashape-Key 头、User-Agent 头或 No。
  • HTTPS 列逐行标注传输加密。
  • CORS 列区分可浏览器调用与仅限服务端,依据是 CONTRIBUTING.md 的明确警告。
  • CONTRIBUTING.md 拒绝需要先购买设备或服务才能使用的 API。
  • 限流、服务条款与密钥存放仍需逐家查阅服务商自己的文档。

替代方案比较

方案适用场景代价
APILayer
想要单一供应商:一个账号、一个控制台、一个 API key,覆盖地理编码、邮箱校验、航班与行情数据。商业套餐;在 README 中被直接推广。
RapidAPI Hub
想要统一计费、密钥与用量分析的市场平台。免费增值,按 API 订阅计费。
free-for-dev
想要覆盖整个 SaaS 免费层(不限于 HTTP API)的清单。免费,社区维护。
OpenAPI Directory (APIs.guru)
需要机器可读的 OpenAPI 规范用于生成客户端,而非 Markdown 表格。免费开源。

这个趋势说明了什么

Fork 成内部目录

MIT 许可证明确授予使用、复制、修改与再许可的权利。把表格裁剪到团队已核验的服务商,托管在自家文档旁边。

在 fork 中保留 LICENSE 版权声明,然后删掉所有未核验的分类。

先查格式再写客户端

Auth 与 CORS 都是封闭词表,筛选可以机械化:Auth = No 且 CORS = Yes 的行零配置即可在浏览器运行;CORS = No 的行必须经服务端转发。

任选一个分类小节,抄出 Auth = No 且 CORS = Yes 的行,在浏览器控制台各发一次请求。

给 fork 加一层存活检测

CONTRIBUTING.md 注明旧版本 API 会被弃用,表格行可能指向已下线的端点。加定时检查的 fork 能把静态 Markdown 变成受监控的目录。

在你的 fork 里写一个每周任务,对每个条目端点发请求,并标记无响应的行。

下一步建议

先核验三行,再决定用一个 API

这份目录压缩的是发现环节,不是核验环节。把省下的时间用来确认候选服务商仍然免费、仍然可用。

  1. 打开 README.md,选一个分类,抄出符合 Auth、HTTPS、CORS 要求的三行。
  2. 逐个打开链接的文档页,确认当前定价、限流与密钥要求。
  3. 若该行有 Call this API 链接,fork 对应 Postman 集合并发一个示例请求。
  4. 把核验过的行连同日期记进自己的 fork,为下次检查留下基线。

RepoDaily 判断

一份 MIT 授权的免费 API 检索捷径,靠严格的五列格式撑了多年。fork 它,按 Auth 与 CORS 过滤,再逐家核验后动工。

信息来源