BT

New Early adopter or innovator? InfoQ has been working on some new features for you. Learn more

APIs.guru Joins Growing List of API Indexes

| by Benjamin Young on Jun 10, 2016. Estimated reading time: 2 minutes |

APIs.guru is the latest entry into the API definition indexing, curation, and discovery space.

The open source (MIT-licensed) community curated index currently includes 236 API descriptions which cover 6,271 endpoints. APIs.guru is focused on becoming the "Wikipedia for REST APIs."

APIs.guru is entering an increasingly crowded market with other API indexing sites including The API Stack, API Commons, APIs.io, AnyAPI, and older indexes such as ProgrammableWeb's API Directory. These API indexes share a common goal says APIEvangelist.com blogger Kin Lane:

Developers around the world are using these definitions in their work, and modern API tooling and service providers are using them to define the value they bring to the table. To help the API sector reach the next level, we need you to step up and share the API definitions you have with API Stack, APIs.io, or APIs.guru, and if you have the time and skills, we could use your help crafting other new API definitions for popular services available today.

The APIs.guru content is curated primarily by its creator, Ivan Goncharov. According to a DataFire Blog entry, the initial content was populated "using a combination of automated scraping and human curation to crawl the web for machine-readable API definitions."

The submissions are then matched against the following evaluation criteria:

  • Filter out private and non-reliable APIs.
  • Convert different formats into OpenAPI(fka Swagger) 2.0
  • Fix mistakes, ~80% of spec have some
  • Add additional data, like: logo, categories, …
  • Update specs on daily basis

The index itself is available as a single JSON file hosted via GitHub Pages at https://api.apis.guru/v2/list.json

The file contains a single JSON object with API IDs as keys in the format: <provider>[:<service>]. The contents of each API description include when the description was added, the currently preferred version of the API, and links to OpenAPI (formerly known as Swagger) documentation for the service. There is also a relatively free form info object that contains basic title and description information along with x-* keys for various provider specific information.

Additions to the API index can be made through an Add API page which opens an issue on the APIs-guru/api-models repository on GitHub. Once added, the referenced API spec definition will be converted from the submitted format (RAML, API Blueprint, WADL, etc) into OpenAPI 2.0. Lastly, a daily script is run to monitor updates to the original API definition.

Rate this Article

Adoption Stage
Style

Hello stranger!

You need to Register an InfoQ account or or login to post comments. But there's so much more behind being registered.

Get the most out of the InfoQ experience.

Tell us what you think

Allowed html: a,b,br,blockquote,i,li,pre,u,ul,p

Email me replies to any of my messages in this thread

APIs.guru by Ivan Goncharov

Thank you for the great article. It especially helpful since my primary goal right now is to build a community around APIs.guru.

I also want to add that Roman Gotsiy(github.com/RomanGotsiy) contribute a lot to this project, moreover, he is the mastermind behind APIs.guru website.
More on who we are and why we working on this project: apis.guru/about/

We plan to setup blog and make a few post about project goals, roadmap, etc.
Meanwhile, you can get some additional info from this slides: www.slideshare.net/IvanGoncharov5/nordic-api-da...

Allowed html: a,b,br,blockquote,i,li,pre,u,ul,p

Email me replies to any of my messages in this thread

Allowed html: a,b,br,blockquote,i,li,pre,u,ul,p

Email me replies to any of my messages in this thread

1 Discuss

Login to InfoQ to interact with what matters most to you.


Recover your password...

Follow

Follow your favorite topics and editors

Quick overview of most important highlights in the industry and on the site.

Like

More signal, less noise

Build your own feed by choosing topics you want to read about and editors you want to hear from.

Notifications

Stay up-to-date

Set up your notifications and don't miss out on content that matters to you

BT