apis.io is a federated, agent-friendly API discovery network. It indexes API providers from across the public internet — their APIs, capabilities, schemas, event-driven specs, governance rules, vocabularies, and JSON-LD contexts — and exposes each slice of metadata at its own subdomain. This repo is the hub: the homepage, the blog, the build pipeline, and the cross-network stats.
Live site: https://apis.io
index.html,_layouts/,_includes/,assets/— the apis.io homepage and shared site chrome_posts/— the apis.io blog (network updates, provider profiles, weekly roundups)_data/— cross-network data includingstats.json(the homepage counts), canonical capabilities, and category suggestionsscripts/build.py— the build pipeline. Reads from the api-evangelist provider repos and emits Jekyll collections into every other site repo in the network. Run withEVANGELIST_DIR=/path/to/provider/repos python3 scripts/build.py.scripts/generate-blog-images.py— generates banner images for blog posts via Gemini Imagenscripts/generate-icons.py,scripts/suggest-categories.py,scripts/diff-stats.py— supporting tooling for the network
The build pipeline reads a directory of api-evangelist provider repositories — each one a Git-versioned APIs.json profile of a single API provider — and produces:
- Provider, API, capability, schema, AsyncAPI, JSON-LD, and rule records as Jekyll markdown
- A federated api-catalog (RFC 9727) feed
- Search indexes for each subdomain
- Cross-network stats consumed by the homepage
Each subdomain site is its own Git repo and its own Jekyll deploy on GitHub Pages.
| Site | Repo | What it indexes |
|---|---|---|
| apis.io | network | Search hub, blog, build pipeline |
| developer.apis.io | portal | Developer portal & feeds |
| providers.apis.io | providers | API provider profiles |
| apis.apis.io | apis | Individual API records |
| capabilities.apis.io | capabilities | Naftiko capability specs |
| schemas.apis.io | schemas | JSON Schemas |
| asyncapi.apis.io | asyncapi | AsyncAPI event-driven specs |
| json-ld.apis.io | json-ld | JSON-LD contexts |
| rules.apis.io | rules | Spectral governance rules |
| vocabularies.apis.io | vocabularies | Provider vocabularies |
| tags.apis.io | tags | API tag index |
| examples.apis.io | examples | API usage examples |
- APIs.json — the machine-readable specification that indexes API operations
- API Commons — the standard vocabulary of common operational properties referenced by APIs.json
- Naftiko — the open-source framework that runs capability specs as REST, MCP, and Agent Skill surfaces
- api-evangelist — the upstream provider profile repos this network is built from
APIs.io, APIs.json, and API Commons are projects led by Kin Lane and Steve Willmott. Open issues here for site or build questions; open issues at apisjson.org or apicommons.org for spec-level questions.