The Three Cs of API Websites: What's Most Important?

Adam DuVander
Aug. 17 2011, 04:00AM EDT

We see a lot of APIs. Our directory lists over 3,500 APIs, with dozens of new ones added every week. If you're a developer, you probably see a lot of APIs, too. Like us, you probably know a good one when you see it, but we'd like to be able to help you identify the developer-friendly APIs and pick them out of the crowded pack. That's where our "three Cs" come in and where we could use your help refining this system of API evaluation.

  • Clarity: Do developers know what to do?
  • Cost: Is it available and obvious?
  • Community: How are developers supported?

We hope you'll help us by taking this quick survey on the Three Cs. Clarity, Cost and Community are how we've broken down the important aspects of developer programs and API websites. Each has criteria we believe helps developers create the best applications they can.

In addition to seeing a lot of APIs, we see a handful of API surveys. Time and again developers say "good documentation" is the most important thing. The three Cs all encompass documentation in some way, so we're looking to dig a little deeper.

What's more important--client libraries or an API reference? There isn't a definitive answer to that question, or any other we could ask about other criteria. But we'd like to hear what you think. And we know we probably missed something, too, so we hope you'll let us know about it.

We'll publish the aggregated results to this blog and we'll also use it to help you find developer-friendly APIs. Please take the survey and let us know what's important to you.

Adam DuVander -- Adam heads developer relations at Orchestrate, a database-as-a-service company. He's spent many years analyzing APIs and developer tools. Previously he worked at SendGrid, edited ProgrammableWeb and wrote for Wired and Webmonkey. Adam is also the author of mapping API cookbook Map Scripting 101.

Comments

Comments(5)

bill

I would guess Jason means throttling. We have attempted to use APIs that make no mention of throttling, only to find out in testing that we can only make X calls in a minute. Anything beyond this is throttled. Believe it or not, this API was for taking orders. Bad implementation of denial of service protection. We picked another partner who did not have throttled APIs.