找接口找到怀疑人生?这份47万星的免费API清单,10分钟帮你跑通第一个
找接口找到怀疑人生?这份47万星的免费API清单,10分钟帮你跑通第一个
上周有个朋友跟我吐槽:周末想给自家的小网站加个"显示北京天气"的小功能,本来以为半小时能搞定,结果从下午两点折腾到天黑。
不是他不会写代码,而是卡在了最前面那一步——找一个真正能用、还不要钱的接口。
搜出来的文章一大堆,点进去十个有八个已经打不开;好不容易找到一个,注册要填信用卡;再换一个,文档像天书,照着抄还报错。
后来我甩给他一个 GitHub 上的老牌仓库,他十分钟就把第一个接口跑通了。
这个仓库叫 public-apis,一个攒了 47 万颗星 的免费接口清单。
一、它到底是个啥?可以理解成"接口版的黄页"
先打个比方。
你想在小区门口开个小吃店,最头疼的是什么?不是炒菜,是找货源:哪家送菜的靠谱、哪家要押金、哪家只接大单不接小单。
public-apis 干的就是这件事——它自己不生产任何数据,只是把全世界两千多个免费开放的接口,整理成一张巨大的表格,还贴心地标好了:这家要不要门票、走不走正门、能不能从商场侧门直接进。
你可以把它想象成一本**"接口版大众点评"**:不卖菜,只告诉你哪家店开着门、要不要会员卡、能不能外带。
就是这么一本"电话簿",在 GitHub 上排进了全球前三,五十多个分类从猫猫狗狗的图片,一路排到金融行情、天气气象、区块链数据。
二、它凭什么能火到47万星?
我翻完整个清单,觉得它最聪明的地方,是把程序员最怕的几个坑,直接写成了四列小标签。
第一列:要不要"门票"(Auth)
这一列只有几个值:No、apiKey、OAuth 之类。
No 就是完全免费敞开,复制链接就能用;apiKey 就像进小区要刷卡,得先注册领个钥匙。很多新手最惨的经历,就是文档看了半小时,最后发现"哦,要先申请密钥,还得等审核"。
这张表一眼就告诉你,省下的是半条命。
第二列和第三列:能不能走"正门"(HTTPS、CORS)
这两个词听着吓人,其实特别好懂。
HTTPS 就像门牌上有没有"安全锁"标志,没有的话,浏览器会直接给你脸色看。
CORS 更形象:它决定了你家网页能不能"直接从商场侧门进去拿东西"。如果不支持,你在网页前端直接调用就会被保安拦住,只能绕到后端去拿。
多少人代码写得没错,报错却永远是那一行红字,根子就在这。清单提前给你标好了 Yes/No,等于提前告诉你哪扇门能推。
第四列:一句话说清它是干嘛的
不超过一百个字符,不玩虚的。
还有个细节挺圈粉:这个仓库是社区人工维护的,专门有人写脚本自动查重、查死链,还明文规定——纯打广告的、必须先买硬件的、只有七天试用的,一律不收。所以它才能活这么多年还没变成"广告墙"。
顺便说个新变化:今年它还单独开了一个 MCP 服务器专区。简单说,就是让 AI 助手也能直接"点菜"调接口,不用你再手写代码。对正在玩 AI Agent 的人来说,这算是意外之喜。
三、十分钟跑通第一个接口,我拿真实的试了试
下面这套流程,我愿称之为"最小闭环":不追求完美,先让数据在屏幕上动起来。
第一步:别逛菜单,先说人话
很多人一进清单就开始从上往下翻,翻着翻着就迷路了。
正确姿势是反过来:先写一句人话需求。比如"我想在网页上显示北京的实时气温"。
需求越具体,筛选越快。
第二步:卡三个硬条件
- 门票:Auth 必须是
No(先别碰要钥匙的) - 安全:HTTPS 必须是
Yes - 跨域:如果要在网页里直接用,CORS 也得是
Yes
三个条件一卡,两千多条瞬间缩到几十条,选择困难症当场痊愈。
第三步:不看文档,先看它"活没活"
这一步是我最推荐的——别急着读文档,先让它回你一句话。
在电脑终端里敲一行极简的 curl 加上接口地址,或者在浏览器地址栏里直接粘贴访问,屏幕上就会吐出一串数据。
我随手试了三个:
- 查天气的 Open-Meteo:返回北京实时气温 5.0℃,天气代码 0(晴天)。不用注册,不用钥匙,秒回。
- 讲猫的 Cat Facts:返回一条冷知识——"世界上第一场猫展,1871 年在伦敦水晶宫举办"。
- 狗狗图片的 Dog CEO:直接回一个图片链接,打开就是一只毛茸茸的狗。
能返回数据,就说明它活着;返回一堆看不懂的报错,就换下一个。 这一步花不了两分钟,却能帮你省掉后面两小时。
第四步:把结果存成一行"地址"
跑通之后,别让它随风而去。
把"接口地址 + 用途 + 哪天测的"记成一行小笔记,就像手机里存一个常用外卖地址。下次要用,直接复制,不用再翻一遍清单。
到这里,十分钟刚刚好。
四、这十分钟里,出现这三个信号就赶紧撤
免费的东西最贵的不是钱,是时间。我总结了三个"止损信号":
信号一:注册要信用卡
写着"免费",点进去却让你绑卡。这种大概率是"试用七天自动续费",别犹豫,直接跳过。
信号二:返回 401 或 403
这通常不是你的错,是它在说"你没资格"。如果清单上明明标着 No,实测却要密钥,说明这条信息过期了,换一家。
信号三:文档页面打不开,或者满屏都是"即将上线"
一个连自己说明书都懒得维护的接口,你很难指望它半夜三点还稳定上班。
还有个小提醒:看到页面返回的是一大段网页源码,而不是规规矩矩的数据,也说明八成走错门了。
五、门槛到底有多低?
说句实在话,低到有点出乎意料。
不需要独立显卡,不需要跑什么大模型,一台普通笔记本就够,甚至一部手机都能完成一半——浏览器地址栏粘一下,就能看到返回结果。
适合谁?
- 学生党:课程设计、毕业项目缺数据,这里能直接捞;
- 自媒体和独立开发者:想做个"每天一句猫冷知识"的小程序,素材现成;
- 产品经理:做原型演示,不用等后端排期;
- AI 爱好者:配合 MCP 专区,让 AI 助手自己去查天气、查汇率。
但也要把丑话说前头:免费不等于随便用。很多接口写着"非商业用途",你要真拿去做收费产品,记得看清条款;免费额度也常常有上限,别一上来就猛刷。
它更像是"原型的加速器",不是"生产环境的承重墙"。
六、写在最后
我特别喜欢这个仓库的一点是:它没有教你任何高深技术,只是老老实实告诉你——世界上有这么多好东西是免费的,只是你之前不知道在哪儿找。
以前我们做一个小功能,卡在"找数据"上能耗掉一整天;现在十分钟,一个接口就能在屏幕上活过来。
这种"从想法到看见结果"的速度,才是普通人最该享受的技术红利。
最后想问问你:你上一次为了找一个能用的免费接口,折腾了多久? 是为了天气、汇率、图片,还是某个奇怪又好玩的冷知识?评论区聊聊,说不定你踩过的坑,正好能帮到下一个人。