Directory of API definitions in OpenAPI(aka Swagger) 2.0 format.
API access to collection: Go!

Our goal is to create a machine-readable Wikipedia for REST APIs with the following principals:

• 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 want to reference this project and you need an icon or even a banner, check our branding guide.

The project was started by Ivan Goncharov of APIs.guru, it is now maintained by Mike Ralphson of Mermade Software. Check out our other OpenAPI-related projects.

APIs.guru provide services and consultancy around GraphQL, OpenAPI/Swagger spec and APIs in general. You can contact us at [email protected] / [email protected]

What does APIs.guru do?

• Filter out private and non-reliable APIs.
• Convert different formats into OpenAPI(fka Swagger) 2.0
• 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 (email owner, pay money, etc.).
• Persistant - 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.

Update procedure

All definitions are automatically updated from their original source. You can see it under x-origin property inside each of swagger.yaml files. We run our update script at least weekly and manually check diffs before commit. If you see some APIs are not updated for more than 2 weeks please open an issue.

Existing integrations

• https://any-api.com - Documentation and Test Consoles for Public APIs
• https://sdks.io - Explore Automatically Generated SDKs
• https://cenit.io - Data integration platform
• commandcar - Curl on steroids
• https://datafire.io - allows you to process and transfer data between APIs, databases, and more
• Material Swagger UI Hub - testing and exploring hub for Material Swagger UI demo
• Paw - The most powerful 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

Also used as test suite in following projects:

• swagger-parser - Swagger 2.0 parser and validator for Node and browsers
• SwaggerProvider - F# Type Provider for Swagger
• ReDoc - Swagger-generated API Reference Documentation
• ardoq-swagger-addon - Ardoq Open API (Swagger) Addon
• swagvali - Module to build validators for Swagger(OpenApi) Request parameters and Response objects
• swagger-search - An application that collects and indexes swagger docs from your microservices architecture

Integration with 3rd-party services

We discourage you from using Github RAW links or Git directly, repository structure isn't stable and could be changed in future. Instead, we strongly recomend you to use our REST API.

Licenses

All code is released under the MIT licence.
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 principal.

Definition sources

Some definitions are taken from Open Source projects:

• darklynx/swagger-api-collection - OpenAPI(aka Swagger) description for Instagram API
• Mermade/bbcparse - OpenAPI(aka Swagger) definition for BBC Nitro and iBL APIs
• amardeshbd/medium-api-specification - OpenAPI (aka Swagger 2.0) description for Medium API
• faragorn/open-api-specs - OpenAPI definition for Giphy API