The Social Media Movement is slowly moving towards monetisation. Social Business, yes even Social Enterprise, is neigh.
Infographics bite the dust in an ever-increasing frenzy to prove that social is here to stay, to rule, to conquer the world!
And as yet another evidence of that, API’s are brought forward – by the hundreds, no the thousands – to prove that the Brave New Open World has finally (yeah, really finally this time, right?) come
Well, I don’t think so. API’s suck – big time
First of all, API’s aren’t open. The fact that you can read about an API and use it, by making a request to it and getting data in return, is not a god-like miracle: it’s so self-evident that it’s boring. If you call an API open because it does allow you to do that, you might as well call a radio open, or a TV: change the channel, and – oh no!, it’s a miracle – you get a different set of data on the spot.
API’s are closed: the companies that offer them, decide what’s in them, when it’s in them, where it’s in them, and how it’s in them: and you just have to put up with that
Second of all, API’s are for free, mostly, and no uptime is guaranteed. Whenever an API breaks down, it’s tough luck. Does it stop supporting a method, or suddenly change the return value, its order, or dataype, without telling you? Normal behaviour.
API’s are “a gift from God”, if you like: they come and go without much, if any, notice. Builds a business around a free API? You better think twice before billing your customers – what if the API stops, changes, backfires, dies?
I’m a registered Twitter API developer, but I never get an email or something when it changes. That sucks
Third, API’s are badly documented, if any. The Twitter API? I consider that wholly undocumented, sorry. Yes you get a small description per function, and if you drill deeper, also a description of some parameters to use when you call the function, but none of the return ones get described, let alone mentioned.
Their format? Unknown, have to find out for yourself.
Their occurrence? Lawd knows.
When can you count on a value to be there, i.e. when is it mandatory, and when is it conditional or just optional? You tell me – Twitter doesn’t
Is this just an unfortunate example? No, Twitter is actually fairly well documented. Compared to Facebook and e.g. their open graph protocol, they’re amateur-ish, but compared to all the others, they’re swell.
I went to Programmable Web, a site that tracks down so-called Open API’s, lists them on their website and does a short summary of them with links. Handy
I tried a few: most of these are just bait-sites, where you find a small promise and a big button for Pricing Details or Contact Our Sales. Some are in Russian, Chinese – how useful is that? Open? I just picked a few, please judge for yourself how very usefull, intuitive, clear, concise, helpful… – ah forget it:
- 5gig (unintelligible)
- 8coupons (bait link)
- ACStechnologies (techfest gone wild)
- ActiveCollab (confusingly content-free)
- Adegga (fairly OK)
- 100 Faktovobome (or something)
- Alert-grid (pretty good, with error codes even)
- Aloga (not an API, but a Motorola dev platform?)
- Amsterdam Museum (embarassingly embarassing)
- Adobe Flash feeds (I always love a completely empty page)
- Affinity Live (I’m fairly impressed. Yes, I am)
Social Business? Still remains a techfest for the full 100% it seems – if you rely on API.

(Cross-posted @ Business or Pleasure? – why not both)
Interesting viewpoints Martijn and I’d be the first to say there are some less than perfect APIs out there – they can be hard to use, subject to change and many of the things you mention. However, on the whole I think you may point is way off base – primarily you call self evident and boring that you can access data in this way, when in fact it absolutely isn’t – APIs are in their infancy in many ways and what came before was – screen scrapping, RSS if you were lucky and certainly not the level of programmatic control you have now. I should declare that I work at 3scale (http://www.3scale.net) and so not surprisingly have some bias – but also maybe some perspective!
There are certainly things to be fixed but what you are saying Is akin to saying *this web thing SUCKS* in 1995/96 – yeah it was clunky, slow, a lot of the content was random, you couldn’t move for animated gifs etc. – but it *worked*. Plus the fact that it worked meant people built it out and it became what we have to day (whether all the evolutions are good is a debate for another day). APIs are at a similar stage – there are a few thousand public APIs a lot more private but they are a tiny fraction of the web – most of the web doesn’t have a programmatic interface yet of any sort.
I think your comments on APIs being closed, have no uptime guarantees etc. are with respect rather out of date – there are a lot of companies who provide APIs which are mission critical to their business and they treat them as such (including many of our customers): they obsess about uptime, there SLA, there is versioning, you can use them in commercial and non-commercial ways and they are often more reliable than a company’s website. You see this in many sectors – Media, Financial Data, eCommerce etc. not to mention in B2B APIs for procurement etc.
Openness is one of those tricky terms that bites you back – what does it mean? Id’ say it should be thought of in the same way as the web – the web *itself* is open – anybody can put up a site with whatever access terms they like – it’s the same with an API. Just as with the web some APIs are public, free and accessible to all – and others are pay-to-play. I don’t think this is any different.
Lastly you counted useful and useless APIs – ultimately it isn’t the API that counts it’s what’s behind it – the data, the service, etc. – it’s the same as for the web – there may be millions of sites out there you consider completely useless. Presumably if they truly are useless eventually whoever runs them will shut them down, but many will be useful to some people and some will be useful to many. Companies in general don’t put effort into opening an API unless there’s some real utility there – for some companies it’s becoming central to their business.
There’s no doubt that current technology is still limited, sometimes documentation is lacking and APIs can be hard to use – but it’s early days. I’d rather be able to do what I can with the twitter API today than wait for someone to bring out something perfect – that’s not the way anybody learns and evolves. REST prevalence is certainly helping things, as is just the increasing numbers of APIs being built – it all helps move the ball forward.
Thought provoking article Martijn. While I do think I agree with Steven Willmott in that the fact APIs exist is a huge plus, I’d be really interested in what you think makes good documentation? We have need to document APIs for our clients and are trying to figure out the best way forward.
Hi Steven, Mike
Steven, you are way off here, and evidently don’t know where I come from: 15 years of global enterprise B2B experience are tattooed on my forehead.
Your comparison to the web in 1995 is hence ridiculous – describing services and offering them has been done for over many, many decades now.
“It’s early days” – that’s what e.g. klout keeps saying about themself, using it as an excuse to deliver an enormously crappy service. Join the hordes Steven! If this is how you think about quality of service, your attempt to get free publicity for 3scale just bit you in the ass
Mike, splendid point. I touch upon that at the last chapter of my Integration book: http://www.martijnlinssen.com/2011/03/perfect-integration-13-dos.html. I’m currently working on something more elaborate with rewards to API’s, and expect to release that within the next days or weeks
I think we may have to agree to disagree Martijn. There’s no attempt to get free publicity – I took the time to respond on your blog to points you raised – despite the fact that they were couched in very conflict heavy language. Strangely enough, I actually care a whole lot about APIs because they have the power to make the web 10,000x more powerful than it is today.
We take quality of service extremely seriously – as do many companies which provide APIs and no doubt that will increase. Just pick APIs like Xignite, ebay, paypal, Amazon, Expedia etc. – all of these are absolutely API driven businesses – 100’s of millions of transactions flow across some of them daily.
You can’t have your cake and eat it – either APIs get out there in the while and grow with usage, feedback and experience or they don’t get out there at all. If people are unhappy about what’s out there then there is no obligation to use them – just wait till they improve (or something improves upon them). In the meantime other people will be building a ton of value on them.
Is there too much hype around some APIs – sure, but there is too much hype around plenty of things in almost any category you can think of. That doesn’t make the whole category invalid.
Martijn, it is clear to me you are asserting that many of the API’s are crap today. I tend to agree with you, there is no standardization, no SLA, no nothing. It is like the wild-wild west.
What is not clear to me is your “follow-on” statement to the “API’s are crap”. Are you saying, “look, API’s are crap today, therefore it will not amount to anything in the future”? Or “API’s are crap today, so the industry needs to figure out how to standardize and make it useful”?
Hi John,
Yes. And no.
API’s are giving access to systems from the outside, which is fine and can even be fun, and useful. But if they are to be used, their business use must be well described.
There will never be standards on the API level as in one talking to the other, although it could be managed if they were to properly mature and function to a decent level of publish and subscribe.
What can be easily achieved, is a standard in API description: no nonsense stuff like wsdl or xsd, which are just tech formats, but clear human business rules about how to disclose the business function to the user. Currently API’s are tech ground at the very best, and that simply needs to change
It’s like a car mechanic describing the use of a car – that wouldn’t sell for shit now would it?
I’ll be posting on this in the very near future, and we have something cooking in the UK, probably broader. Keep you posted!