Разбирался с API всех популярных соцсетей и для себя составил рейтинг социалок удобства для разработчика. Самая поганая соцсеть - одноклассники. Наиболее запутанная документация, точнее разрозненный набор вики статей. Апофеоз всему - физлица не могут добавлять виджеты (они же игры и приложения) на сайт одноклассников. Требуют заключить договор с предоставлением всех бумаг для юрлиц. Большего бреда придумать сложно.

Больше всего мне понравились вконтакте: отличная документация, все расписано. На хорошем уровне гугл, но постоянно остается ощущение недостаточности - скорее всего не хватает демо примеров с разбором. Гуглу поставлю 4. Яндекс по документации за последнее время подтянулся.