免费公开API速查手册:798个接口、48个分类与认证选型指南
【免费下载链接】public-api-listsA curated list of free public APIs — searchable, community-maintained, with a free JSON API.项目地址: https://gitcode.com/GitHub_Trending/pu/public-api-lists
public-api-lists 是一份社区维护的免费公开 API(free public APIs)清单,把 798 个接口按 48 个分类整理成统一表格,逐条标注认证方式、HTTPS 与 CORS 支持。与其把它当成一份目录,不如当作一本「怎么查、怎么挑、怎么防坑」的速查手册——本文就按这条主线展开。
找免费 API 时最容易卡住的三个环节
用过的开发者多半被这三件事拖慢过,先摆出来,后面的检索法就是逐个化解它们。
官网之间来回跳转
每个服务商都有自己的文档站、注册页和示例代码,找一个天气接口可能要开十几个标签页对比。这份清单把接口名、描述、认证、HTTPS、CORS 收进同一张表,横向对比不用切换页面。
认证方式看不懂
同样是「调一个接口」,有的直接返回 JSON,有的要先申请 key,有的要走 OAuth 授权流程。清单里每个接口都用同一套标记写清认证要求,扫一眼就能判断接入成本。
接口停服没有备选
免费接口最大的风险是随时可能下线。清单里同一领域通常并列收录两到三个接口,挑一个主用、留一两个备用,就不至于被单点故障卡住。
把这三个坑摊开看,会发现它们大多能靠「查表」化解。
🔍 三步检索法:定认证、挑分类、核字段
打开 README.md,检索基本按固定顺序走,能少走很多弯路。
第一步 先确认要不要认证
先想清楚调用端是谁:浏览器前端直连,就别碰需要后端保管密钥的接口;纯练手和演示,优先挑「No」标记的接口。
第二步 用 48 个分类锁定领域
文件顶部的 Index 是 48 个分类的锚点导航,例如Weather、Finance、Development、Games & Comics。先按领域跳到对应表格,范围立刻从 798 缩到十几行。
第三步 核对 HTTPS 与 CORS 两列
前端项目尤其要看 CORS 是否为 Yes,否则浏览器会直接拦截跨域请求;HTTPS 为 No 的接口,生产环境建议谨慎使用。三步走完,候选基本就剩两三个。
具体到表里,先看清 48 个分类都装了些什么。
🧭 48 个分类的分布:高频场景对应哪些领域
分类大致覆盖「拿数据来展示」和「接业务、接工具」两大类,可以照着场景对号入座。
数据与展示类
想做随机图片墙、天气小组件、动漫/影视资料卡,就去看 Animals、Photography、Video、Weather、Anime 这几个分类,里面无需认证的接口占比很高,适合快速出效果。
业务与工具类
做检索、翻译、数据校验、金融与加密货币行情,对应 Development、Text Analysis、Finance、Cryptocurrency 等分类,多数需要 API 密钥,但返回结构更规范,适合放进正式项目。
上图标红的是收录在清单里的一个搜索引擎抓取接口,属于「业务与工具类」的典型:一行请求就能拿到结构化搜索结果,省去自己解析网页。分类选好后,真正决定「好不好接」的是认证方式。
🔑 三种认证方式怎么选
清单里 798 个接口的认证标记分布如下,选型时按这张表对即可:
| 认证方式 | 接口数 | 典型用途 |
|---|---|---|
| 无需认证(No) | 371 | 前端直连、原型演示 |
| API 密钥(apiKey) | 346 | 需要稳定限额的个人/小项目 |
| OAuth | 77 | 需要访问用户账户数据 |
| 其他(X-Mashape-Key) | 4 | 早期网关接口 |
判断口径很简单:不碰用户数据 → 优先无需认证;调用量大或要更高限额 → API 密钥;要读用户的私有内容(邮箱、日历、社交账号)→ 走 OAuth。无需认证的接口基本是「拿来就用」,比如随手抓一张随机狗狗图:
const res = await fetch('https://dog.ceo/api/breeds/image/random'); const { message } = await res.json(); // message 即图片 URL console.log(message);API 密钥放在哪里才安全
密钥永远别硬编码进前端或提交进仓库:放环境变量或后端配置,由服务端代理转发,前端只跟自己的后端说话。
即便选对了接口,也难免遇到它哪天打不开。
🛟 接口突然不可用:备份与降级的三条要点
免费接口没有 SLA 保障,提前留后路比事后补救省事。
- 多源备份:核心功能固定保留 2–3 个同类接口,主用挂了能秒切,清单里同一分类往往就够用。
- 缓存与降级:把不易变的响应做本地缓存;接口不可用时返回上一份数据或兜底内容,而不是直接报错。
- 代理与重试:对网络不稳定的接口加有限次指数退避重试;涉及大规模抓取时,可用住宅代理池分散来源、降低单点被封概率。
最后落到一句话:这份清单更适合哪些项目,以及马上能做的几件事。
适合哪些项目,以及接下来能做的三件事
更适合:练手 demo、教学演示、个人小项目,以及需要稳定免费数据源、但不想为每个接口单独调研的团队。不太适合:对可用性有硬性 SLA 要求、或依赖单一付费接口独占数据的生产核心链路——这类场景应把清单当作「备选池」而非唯一依赖。
📋 接下来你可以做的三件事:
- 打开 README.md,用「三步检索法」挑一个无需认证的接口,跑通第一个请求。
- 把项目 clone 到本地(
git clone https://gitcode.com/GitHub_Trending/pu/public-api-lists),方便在 48 个分类里全文搜索关键词。 - 给关键功能留好 2 个备选接口,并把 API 密钥放进环境变量;发现好用的接口,可参考 .github/CONTRIBUTING.md 的流程提交补充。
【免费下载链接】public-api-listsA curated list of free public APIs — searchable, community-maintained, with a free JSON API.项目地址: https://gitcode.com/GitHub_Trending/pu/public-api-lists
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考