APIs.json

APIs.json is a machine-readable metadata format used to describe APIs (Application Programming Interfaces) and their associated resources. It acts as a discovery format similar to how robots.txt helps search engines discover web pages. The goal of APIs.json is to simplify the process of finding, cataloging, and integrating APIs by providing a standardized way to document the follow details.

• Technical - With APIs.json you can index OpenAPI, but also Postman or Bruno collections, and any other machine-readable artifact that defines the surface area of individual APIs.
• Business - With APIs.json you can index the aspects of API operations that business stakeholders will care most, like discovery, onboarding, billing, and areas more aligned with business.
• Common - Using APIs.json, you can define the technical and business details of each individual API, but also the shared properties available across many APIs in a standardized way.

APIs.json can provide an index for an entire API portal, or a single API in a GitHub repository. APIs.json can be indexed to provide search and discovery for APIs, but also a machine-readable artifact that can be used to govern the operations surrounding APIs. APIs.json is designed to do for API operations, what OpenAPI has done for APIs.