APIs.json

APIs.json Specification

The APIs.json specification defines a machine-readable JSON or YAML format for describing API operations. Unlike OpenAPI which describes the technical interface of a single API, APIs.json describes the surrounding operations of one or more APIs — documentation, authentication, pricing, terms of service, support, and other properties. Created by Kin Lane and Steven Willmott in May 2014, the specification is maintained as an informal IETF draft at apisjson.org. The current stable version is 0.19, published November 6, 2024. APIs.json files are placed at the domain root as /apis.json or /apis.yml for automated discovery by robots and search engines.

Documentation GitHub

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/apis-json-specification"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

API entry from apis.yml

aid: apis-json:apis-json-specification
name: APIs.json Specification
description: The APIs.json specification defines a machine-readable JSON or YAML format for describing
  API operations. Unlike OpenAPI which describes the technical interface of a single API, APIs.json describes
  the surrounding operations of one or more APIs — documentation, authentication, pricing, terms of service,
  support, and other properties. Created by Kin Lane and Steven Willmott in May 2014, the specification
  is maintained as an informal IETF draft at apisjson.org. The current stable version is 0.19, published
  November 6, 2024. APIs.json files are placed at the domain root as /apis.json or /apis.yml for automated
  discovery by robots and search engines.
humanURL: https://apisjson.org
tags:
- API Description
- API Discovery
- API Operations
- Machine-Readable
- Specification
- Standard
tags_raw:
- API Description
- API Discovery
- API Operations
- Machine Readable
- Specification
- Standard
properties:
- type: Documentation
  url: https://apisjson.org/schema/
- type: Specification
  url: https://raw.githubusercontent.com/api-evangelist/apis-json/refs/heads/main/spec/apisjson_0.19.txt
- type: JSONSchema
  url: https://raw.githubusercontent.com/api-evangelist/apis-json/refs/heads/main/json-schema/apis-json-schema-0.19.yaml
  title: Schema v0.19
- type: JSONSchema
  url: https://raw.githubusercontent.com/api-evangelist/apis-json/refs/heads/main/json-schema/apis-json-schema-0.18.yaml
  title: Schema v0.18
- type: JSONSchema
  url: https://raw.githubusercontent.com/api-evangelist/apis-json/refs/heads/main/json-schema/apis-json-schema-0.17.yaml
  title: Schema v0.17
- type: JSONSchema
  url: https://raw.githubusercontent.com/api-evangelist/apis-json/refs/heads/main/json-schema/apis-json-schema-0.20.yaml
  title: Schema v0.20 (Draft)