项目概览

public-apis 是一个社区驱动的免费 API 聚合列表,目前在 GitHub 上拥有 409,830 个 stars,44,271 个 forks。项目创建于 2016 年 3 月,至今已近 10 年历史,是同类项目中 star 最多的一个。

仓库地址:https://github.com/public-apis/public-apis

它解决了什么问题

做项目时,我们经常需要调用各种接口:天气数据、股票行情、新闻资讯、图片素材……一个一个 Google 不仅耗时,而且很难判断接口是否稳定、是否免费、是否需要认证。

public-apis 就是来解决这个问题的。它把散落在互联网各处的免费 API 整理到一个列表里,每个 API 都标注了关键信息,方便开发者快速找到适合自己项目的接口。

收录范围

项目按类别组织,涵盖 50+ 领域

分类代表性 API
天气OpenWeatherMap, Weatherstack
金融Fixer (汇率), Marketstack (股票)
动漫Jikan, Kitsu
动物Cat Facts, Dog Facts, Cataas
地理位置IPstack, OpenCage Geocoding
新闻News API, Guardian, New York Times
加密货币CoinGecko, CryptoCompare
词典Free Dictionary, Oxford
音乐Spotify, Apple Music, Last.fm
视频YouTube, Twitch, IMDb

每个 API 的标注信息

这是 public-apis 最有价值的地方。每个接口都统一标注了:

  • API:接口名称和链接
  • Description:一句话描述功能
  • Auth:认证方式(apiKey / OAuth / No)
  • HTTPS:是否支持加密连接
  • CORS:是否允许跨域调用

这些信息让你可以快速判断一个接口能否直接用于你的前端项目,而不需要点进去看文档。

典型 API 详解

1. 天气类

OpenWeatherMap 是最流行的免费天气 API 之一:

  • 免费额度:60 次/分钟
  • 支持:当前天气、预报、空气质量
  • Auth:需要 API Key
  • CORS:支持

Weatherstack

  • 免费额度:1000 次/月
  • 特点:历史天气数据
  • Auth:需要 API Key
  • CORS:支持

2. 金融类

Fixer

  • 免费额度:1500 次/月
  • 提供:170+ 货币汇率
  • Auth:需要 API Key
  • HTTPS:支持

Marketstack

  • 免费额度:500 次/月
  • 提供:全球股票市场数据
  • Auth:需要 API Key
  • HTTPS:支持

3. 动漫类

Jikan (/anime)

  • 免费额度:无限制
  • 提供:MyAnimeList 数据
  • Auth:不需要
  • CORS:支持
  • 亮点:完全免费,无需注册

4. 动物类

Cataas (Cat as a Service)

  • 免费额度:无限制
  • 提供:猫图片和 GIF
  • Auth:不需要
  • CORS:支持
  • 亮点:完全免费,适合 Demo 和占位图

Dog Facts

  • 免费额度:无限制
  • 提供:随机狗狗趣闻
  • Auth:不需要
  • CORS:支持

适用场景

public-apis 特别适合:

  1. 练手项目 —— 需要免费接口快速搭建原型
  2. 学习 API 调用 —— 各种类型的接口都有,适合练习
  3. Hackathon —— 时间紧迫时快速找到可用的接口
  4. 工具脚本 —— 天气、汇率等日常小工具的数据源

同类对比

项目StarsAPI 数量特点
public-apis409,8301500+分类最全,社区最大
AnyAPI8.2k200+偏向付费 API
Public APIs2.1k150+规模较小

使用注意

  1. 免费额度:大部分免费 API 都有调用限制,生产环境使用请注意配额
  2. 稳定性:社区维护的列表,部分接口可能随时失效
  3. 认证:大多数接口需要注册获取 API Key
  4. 遵守条款:每个接口的使用条款不同,商用前请仔细阅读

总结

public-apis 是开发者必备的 bookmark。虽然 40 万星说明它已经非常出名,但对于还没用过的人来说,它确实是那种「早知道早受益」的工具。

作为日常工具收藏一个,做项目时能省不少查找时间。


我的 Fork 版本

为了方便中文用户使用,我已经 Fork 了该项目,并创建了中文和日文本地化 README:

Fork 版本会定期同步上游更新,同时提供更友好的中文/日文阅读体验。


项目信息