Sitelet https://github.com/ontola/openapi-directory
Skip to content
 
 

Latest commit

 

History

4,612 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

banner

Fork maintenance: This is ontola/openapi-directory, focused on official descriptions of well-known industry APIs. The source registry lists the service artifacts checked by the weekly workflow. The updater compares complete vendor content, preserves existing curation, and validates each import. Reviewed sources can resolve external references, materialize code samples, replay exact patches, or discover newer numeric releases; recipes are source-specific.

See the updater guide for reproducible commands and AGENTS.md for scope, completed work and unresolved candidates. Workflow runs publish an official-source-audit artifact containing the JSON freshness report and raw source snapshots. A failed audit can contain successful comparisons alongside recorded validation or source-health blockers. A match establishes agreement with the configured source, not freshness of every API offered by that vendor.

Imports are delivered in separate PRs for each API, with provenance in the spec's info block. Automatic update PR creation and monthly discovery remain implementation work. Use this fork's committed API files for its additions; a public collection API serving this fork has not been published. The inherited badges, REST API, RSS, integrations, sponsorship and upstream contribution material below describe APIs.guru.

APIs in collection OpenAPI definitions Endpoints

Share on Twitter Follow on Twitter

Directory of API definitions in OpenAPI(fka Swagger) 2.0 and 3.x formats.
Upstream collection API: documentation, with upstream RSS feeds for added and updated APIs.

Add API

Our goal is to create the most comprehensive, standards-compliant and up-to-date directory of machine-readable API definitions, with the following principles:

  • Open source, community driven project.
  • Only publicly available APIs (free or paid).
  • Anyone can add or change an API, not only API owners.
  • All data can be accessed through a REST API.

If you reference this project and you need an icon or even a banner, check our branding guide.

APIs.guru provide services and consultancy around the GraphQL and OpenAPI specifications and APIs in general. You can contact us at founders@apis.guru

Become a partner

What does APIs.guru do?

  • Filter out private and non-reliable APIs
  • Convert non-OpenAPI formats into OpenAPI 3.x
  • Fix mistakes, ~80% of definitions have some
  • Add additional data, like: logo, categories, …
  • Update definitions on at least a weekly basis

API definition acceptance criteria

  • Public - anyone can access it as long as they follow some clearly defined steps (subscribe, pay fees, etc.).
  • Persistent - API is made with long-lived goal, and not for a particular event (conference, hackathon, etc.).
  • Useful - API should provide useful functionality not only for its owner.

Fork update procedure

Weekly checks cover only registered sources. They are read-only; they publish drift, separate additions/removals, validation results and source revisions. The report includes unsupported and archived sources rather than silently treating them as current. Historical files outside the registry have no freshness guarantee.

To refresh an API, follow the maintenance commands and fork contribution instructions. A declared version bump adds a new directory; unchanged vendor versions can require an in-place content refresh. Each spec's info.x-origin identifies its source and info.x-conversion records transformations. Report fork-specific stale descriptions or missing official sources in this fork's issues.

@seriousme kindly runs a backup validation process based on the official OpenAPI-Specification JSON Schemas here.

Inherited upstream integrations

Become a backer

  • HTTP Toolkit Beautiful & open-source tools to debug, test and develop with HTTP(S)
  • OpenAPI-Directory-JS - The OpenAPI directory precompiled & indexed for JS usage & searching
  • Apideck - Faster data integration through Unified APIs
  • Microsoft Kiota - Generate an API client to call any OpenAPI described API
  • API Tracker - Aggregates 14,000+ APIs, SDKs, API specifications, integrations and DX profiles. It aims to help developers access the information they need to integrate APIs faster
  • API Watch - Keep track of the APIs you use
  • https://pipedream.com/ - The integration platform built for developers
  • https://any-api.com - Documentation and Test Consoles for Public APIs
  • https://datafire.io - Allows you to process and transfer data between APIs, databases, and more
  • https://sdks.io - Explore Automatically Generated SDKs
  • https://cenit.io - Data integration platform
  • commandcar - Curl on steroids
  • Material Swagger UI Hub - testing and exploring hub for Material Swagger UI demo
  • Paw - HTTP client for Mac - You can import definitions and directly play with the APIs, see how
  • Bitscoop - A better way to create and maintain integrations
  • WinSwag - A UWP app for loading Swagger definitions and exploring REST APIs
  • ReadMe.io - Beautiful, personalized, interactive developer hubs
  • Velosimo - Integration platform for eGovernment
  • Mockoon - API mock samples for your project

Also used as test suite in the following projects:

  • Speakeasy - Generate SDKs Now. Gives your users the DevEx that makes API integrations easy
  • ReDoc - OpenAPI-generated API Reference Documentation
  • swagger-parser - OpenAPI parser and validator for Node and browsers
  • OpenAPI-schema-validator - OpenApi schema validation for OpenApi versions v2, v3.0.x and v3.1.x
  • SwaggerProvider - F# Type Provider for Swagger
  • ardoq-swagger-addon - Ardoq OpenAPI addon
  • swagvali - Module to build validators for OpenAPI Request parameters and Response objects
  • swagger-search - An application that collects and indexes swagger docs from your microservices architecture
  • Schemathesis - Framework for property-based API testing

Integration with 3rd-party services

The upstream project recommends its REST API for upstream collection access. That service is not a verified publication endpoint for this fork's additions. For fork content, read the committed files under APIs and pin the repository revision when you need reproducibility. A fork index must be published and checked for consumer access before it can be advertised here.

Licenses

All API definitions contributed to project by authors are covered by the CC01.0 license.
All API definitions acquired from public sources under the Fair use principle.

Definition sources

Some definitions are taken from Open Source projects:

Contributors

This project exists thanks to all the people who contribute.

Asynchronous APIs

See also AsyncAPI-Directory

Backers

Thank you to all our backers! 🙏 Become a backer.

Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website. Become a sponsor.

Partners

Support this project by becoming a partner. Your logo will be displayed prominently in this project and we will work with you to publicise and showcase your projects. Become a partner.

This project is tested with BrowserStack.

Releases

Packages

Contributors

Languages