Survey Says Facebook API Has Most Headaches and Horror Stories

Adam DuVander, August 11th, 2011

FacebookA 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.

Tags: Issues
Both comments and pings are currently closed.

36 Responses to “Survey Says Facebook API Has Most Headaches and Horror Stories”

August 11th, 2011
at 9:16 am
Comment by: Facebook Wins “Worst API” in Developer Survey | TechCrunch

[...] Image Source: Programmable Web [...]

August 11th, 2011
at 9:22 am
Comment by: Facebook Wins “Worst API” in Developer Survey | Droid Universe

[...] Image Source: Programmable Web [...]

August 11th, 2011
at 9:25 am
Comment by: Facebook Wins “Worst API” in Developer Survey « GhazaliRidzwan.com

[...] Image Source: Programmable Web [...]

August 11th, 2011
at 9:28 am
Comment by: Facebook Wins “Worst API” in Developer Survey

[...] Image Source: Programmable Web [...]

August 11th, 2011
at 9:29 am
Comment by: Facebook Wins “Worst API” in Developer Survey - Latest Bollywood, Lifestyle, Health, Movies | Ebabaji

[...] Image Source: Programmable Web [...]

August 11th, 2011
at 10:15 am
Comment by: Facebook Wins “Worst API” in Developer Survey | TechDiem.com

[...] Image Source: Programmable Web [...]

August 11th, 2011
at 11:00 am
Comment by: Linkfest 2.0 August 11, 2011 StockTwits Social Web Index $SWEB

[...] Survey Says Facebook API Has Most Headaches and Horror Stories  (Programmable web) [...]

August 11th, 2011
at 12:27 pm
Comment by: Facebook Wins “Worst API” in Developer Survey | TxtJive.Com

[...] Image Source: Programmable Web [...]

August 11th, 2011
at 12:38 pm
Comment by: Does Facebook Really Have the Worst API?

[...] 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. [...]

August 11th, 2011
at 1:01 pm
Comment by: Facebook Wins “Worst API” in Developer Survey « IT Freedom

[...] Image Source: Programmable Web [...]

August 11th, 2011
at 1:07 pm
Comment by: Facebook Wins “Worst API” in Developer Survey | XSDirect

[...] Image Source: Programmable Web [...]

August 11th, 2011
at 2:23 pm
Comment by: Tencent Vs. Sina: A Look At Who’s Winning The Battle For China’s Tweets [Infographic] - Tech News

[...] 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 [...]

August 11th, 2011
at 2:28 pm
Comment by: Facebook Wins “Worst API” in Developer Survey | Modern Techie

[...] Image Source: Programmable Web [...]

August 11th, 2011
at 3:11 pm
Comment by: Developer survey finds Facebook has the worst API | ZDNet

[...] 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. [...]

August 11th, 2011
at 6:11 pm
Comment by: Matt Kelly

Hey everyone, I’m a partner engineer at Facebook. I posted a response on TechCrunch, where I originally read about this study. Here’s a link to my reply: http://techcrunch.com/2011/08/11/facebook-wins-worst-api-in-developer-survey/?fb_comment_id=fbc_10150279454842731_18152549_10150279639152731

In short, we’re working hard and making strides, but we have a lot of work to do. We love hearing feedback—keep giving it to us. It keeps us hungry to make things better.

August 11th, 2011
at 6:25 pm
Comment by: Facebook Wins “Worst API” in Developer Survey « Briginfo

[...] Image Source: Programmable Web [...]

August 11th, 2011
at 7:24 pm
Comment by: Facebook y su API de miedo | IdentidadGeek

[...] Imagen: Programmable Web [...]

August 12th, 2011
at 2:32 am
Comment by: bopazmino

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.

August 12th, 2011
at 2:47 am
Comment by: ワーストAPIはFacebook–デベロッパのアンケート調査より

[...] 画像出典: Programmable Web [...]

August 12th, 2011
at 2:49 am
Comment by: La API de Facebook es la que más quebraderos de cabeza provoca a los desarrolladores

[...] | Programmable Web Más información | Facebook Developers me gusta 0 Para votar identifícate o regístrate [...]

August 12th, 2011
at 3:27 am
Comment by: API大评选,Facebook最烂 - 雷锋网 - 专注于移动互联网创业&创新的科技博客

[...] Image Source: Programmable Web [...]

August 12th, 2011
at 6:01 am
Comment by: Dan

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

August 12th, 2011
at 6:35 am
Comment by: Según desarrolladores, Facebook tiene la peor API

[...] | TechCrunch | Hacker News | Programmable Web. Categorías: Facebook, Internet, Redes Sociales, Web Etiquetas: api, [...]

August 12th, 2011
at 1:34 pm
Comment by: Sharer » Blog Archive » API大评选,Facebook最烂

[...] Image Source: Programmable Web [...]

August 12th, 2011
at 8:02 pm
Comment by: 社交网络Facebook 获得最差开发接口称号,还黑客文化?!吹牛吧 | TechFrom科技源

[...] 图片来自 Programmable Web [...]

August 13th, 2011
at 12:04 pm
Comment by: Facebook Wins “Worst API” in Developer Survey » RSS Blog | O melhor da Blogosfera

[...] Image Source: Programmable Web [...]

August 13th, 2011
at 2:37 pm
Comment by: SummaLogic - Blog

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

August 14th, 2011
at 5:24 am
Comment by: У Facebook худшее API? | Новости современных технологий, свежие стартапы - Новости Интернет - Ваш гид в мире IT | obache

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

August 15th, 2011
at 2:02 am
Comment by: API Måndag – Google+, GleSYS och Facebook « API – Mashup.se

[...] 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 [...]

August 15th, 2011
at 10:04 pm
Comment by: Facebook API es la peor | Vuelodigital.com

[...] Fuente e imagen vía: Programmable Web [...]

August 16th, 2011
at 1:16 pm
Comment by: jose

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

August 18th, 2011
at 2:34 am
Comment by: Est-ce que l’API de Facebook est-elle vraiment la pire ? | Le blog des nouvelles technologies : Web, Technologies, Développement, Interopérabilité

[...] 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. [...]

August 24th, 2011
at 7:50 am
Comment by: Facebook Wins “Worst API” in Developer Survey | TechCrunch – API Marketing

[...] Image Source: Programmable Web [...]

August 30th, 2011
at 6:43 pm
Comment by: Dor de cabeça com APIs web: mais regra do que exceção « fabiano florentino

[...] 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 [...]

May 11th, 2012
at 6:02 am
Comment by: Oh great, Facebook wants our apps now too » HD Network Technology Blog

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

July 3rd, 2012
at 2:59 pm
Comment by: Today in APIs: Facebook, $5K Developer Challenge and 13 New APIs

[...] 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 [...]

Follow the PW team on Twitter

ProgrammableWeb
APIs, mashups and code. Because the world's your programmable oyster.

John Musser
Founder, ProgrammableWeb

Adam DuVander
Executive Editor, ProgrammableWeb. Author, Map Scripting 101. Lover, APIs.