Survey Says Facebook API Has Most Headaches and Horror Stories

A survey of API experiences raised some of the largest problems developers encounter, including which companies cause them. The Facebook API was mentioned far and away more than any other in long-form answers to questions about headaches, horror stories and other issues while integrating with APIs. Also mentioned often were Google APIs and the Twitter API. While it should be noted that all three are also among the most popular for developers, there are lessons to be learned in mining the results of this survey put out to Hacker News readers.

Over 100 developers answered the nine question survey in June posted by photo aggregation service Trove. The full results are available from the Trove blog. While the survey had multiple choice questions to get at some generic issues, long-form answers (which received between 31 and 88 responses each) asked for more detail. That's where developers harped on specific companies.

"Facebook, Facebook, Facebook," one developer wrote in response to a question about horror stories. "They release half-baked stuff that doesn't work, shut down existing functionality without replacing it, and never document anything correctly."

Poor documentation and changes to the API were the most common issues that developers noted, regardless of company. But Facebook definitely took the brunt of the attack. "Facebook continually alters stuff thus rapidly outdating my apps," one developer wrote.

Another was more succinct: "Facebook. Everything is broken."

Google also received its share of negative comments, though they were spread across several services. One developer mentioned the Google Buzz API, which did not launch with the service. Two more complained that the Google Plus API is not available.

While Twitter had a handful of negative comments, it also received almost as many positive comments, and more than any other service. "The Twitter documentation is top notch," one developer wrote.

The survey also asked how many services developers use. Nearly two-thirds of developers use three or more services, with a full third using between four and six. There were nine developers who typically use 11 or more services. Wow.

Interestingly, OAuth was also the subject of developer ire. It's being widely adopted as the go-to authentication scheme, but that doesn't make it perfect. "It’s a standard that no one seems to be standardized on," one developer wrote. In fact, if we were to get really general with the survey results, you might say inconsistency and unpredictability are the two things that give developers the most headaches.

Be sure to check out the whole survey if you're into the details. And keep a look out for Trove's follow-up survey.

For those interested in our analysis, we've published our tally of long-form answers.

Be sure to read the next Surveys article: Survata’s Consumer Feedback API Helps Power Business Decisions


Comments (36)

[...] equipe editorial do InfoQ Brasil]Adam DuVander, do blog Programmable Web, publicou recentemente pesquisa sobre o uso de APIs. Nela, foram levantados alguns dos maiores problemas que os desenvolvedores encontram ao utilizar [...]

[...] Programmable Web подсчитали упоминания о конкретных API, чтобы попытаться определить, какой из них вызывает частый гнев со стороны разработчиков. [...]


If you adjust the numbers according to the total numbers of devs on each platform, the conclusions would be much different.

[...] to ensure the integrity of their interfaces. Anybody that has ever expended effort to use the Facebook API can relate to this [...]

[...] Programmable Web (a site owned by ReadWriteWeb sponsor Alcatel-Lucent) counted up the mentions of specific APIs to try to determine which one drew the most ire from developers. [...]

[...] headaches.The Google APIs were in second place, and the Twitter APIs came in third.Image Source: Programmable WebOf course, these three services are also the most popular among today’s developers, so it’s not [...]

[...] Programmable Web counted up the mentions of specific APIs to try to determine which one developers hated most. Facebook technically tied with Other at 19 API Headaches. [...]

I'm surprised LinkedIn API wasn't mentioned more often. It's a mess and not complete at all. We sure shouldn't forget that the more an API is used the more it has chances to provoke nighmares for developers.

I was quite happy with the twitter API, I found it quite simple and straightforward to implement.

oAuth isn't in itself the cause for the problems, but maybe some things were too much left at the implementor's will and implementations differ often from one service to another. You have to adjust everytime.

[...] om Facebook jobbar hårt på sina APIer så är de inte så populära bland utvecklare visar en undersökning. Föga överraskande så utnämns Facebook som det jobbigaste APIet att jobba med, följt av Google [...]


This story is misleading. Facebook is indeed a pain, but if you really want to suffer, try integrating with open social!

[...] Web programmable s’est appuyé sur cette étude afin de comptabiliser les mentions faites sur chacune des API afin de tenter de déterminer laquelle a provoqué le plus de commentaires négatifs de la part des développeurs. [...]

[...] having a fully featured replacement ready to go, but this is acceptable behaviour online. And I’m not the first to experience these feelings, [...]

[...] can have the best designed API around (not that Facebook’s API is without headaches), but what really matters is that it still needs to return the right [...]