What Makes a Great API? The Five Keys

We've seen over 6,500 APIs added to our directory, but we acknowledge they're not all great. In fact, there's a known secret if you've spent much time with APIs: creating a great API is really, really hard. There are a few attributes we've noticed that can make a big difference. Yesterday ProgrammableWeb's John Musser gave a standing room only talk at OSCon about the topic of a great API and boiled it down to five keys.

5 Keys to a Great API

  • Provide a valuable service
  • Have a plan and a business model
  • Make it simple and flexible
  • It should be managed and measured
  • Provide great developer support

The slides are embedded below and provide more detail about each of the five keys. Rare is the API that has all five. The first, a valuable service, might be the most important. If you built an otherwise great API on top of a lousy service, it's lipstick on a pig.

Similarly, you can't just staple an API on to a great service. You need to plan it and then you need to support it. Then, if you manage and measure the API, you'll likely realize it needs to be flexible to fit many different developer needs.

Even if your API is supporting another service, it is still itself a full-fledged product. A truly great API acknowledges this by hitting all five keys.

Adam DuVander The former ProgrammableWeb Executive Editor, Adam is an API expert now helping regular people connect them at Zapier. Previously he worked at API companies SendGrid and Orchestrate, and wrote for Wired and Webmonkey. Adam is also the author of mapping API cookbook Map Scripting 101. Find him at AdamD.org.

Comments (8)

[...] try to stay positive at ProgrammableWeb. We’ve talked a lot about the keys to a great API, but not so much about what some of the lesser APIs do. And, with a directory of over 6,000 APIs, [...]

[...] the keys to a great API is one that is managed or measured. One of the common questions we get at ProgrammableWeb is [...]

Thank you very much for the presentation... It help me to understand more about how to choose an api source :)

[...] in July, John Musser wrote a excellent post over at programmableweb on what it takes to build great APIs (also check out his OSCON slides on [...]