La nueva Graph API de Facebook es un intento de simplificar drásticamente la manera en que los creadores de sitios web leen y escriben información desde y hacia Facebook. La API presenta una vista simple y consistente de la información social en Facebook (el “social graph”) representada de manera uniforma como objetos (por ejemplo personas, fotos, eventos y fan pages) y las conexiones entre estos objetos (por ejemplo personas, fotos, eventos y fan pages).

Cada objeto en el graph tiene un ID único. Es posible llamar la información asociada a un objeto utilizando sólo URL, como por ejemplo https://graph.facebook.com/ID. En un ejemplo más concreto, la página oficial de la Plataforma de Facebook tiene el identificador 19292868552 y con él podemos obtener la información del objeto en https://graph.facebook.com/19292868552:

{

"name": "Facebook Platform",
"type": "page",
"website": http://developers.facebook.com,
"username": "platform",
"founded": "May 2007",
 "company_overview": "Facebook Platform enables anyone to build...",
"mission": "To make the web more open and social.",
"products": "Facebook Application Programming Interface (API)...",
"fan_count": 449921,
"id": 19292868552,
"category": "Technology"
}

De forma alterna, las personas y páginas con nombres de usuario pueden ser llamados utilizando su nombre como identificador. Dado que "platform" es el nombre de usuario de la página que llamamos antes, el URL https://graph.facebook.com/platform nos regresará la misma información. Todas las respuestas son objetos JSON y se acceden de la misma manera. Algunos ejemplos que vienen con la documentación oficial:

• Usuarios: https://graph.facebook.com/btaylor (Bret Taylor)
• Páginas: https://graph.facebook.com/cocacola (página de Coca-Cola)
• Eventos: https://graph.facebook.com/251906384206 (el evento Facebook Developer Garage Austin)
• Grupos: https://graph.facebook.com/2204501798 (Grupo de usuarios de Emacs)
• Aplicaciones: https://graph.facebook.com/2439131959 (la aplicación Graffiti)
• Mensajes de estatus: https://graph.facebook.com/367501354973 (Un mensaje de estatus de Bret)
• Fotos: https://graph.facebook.com/98423808305 (Una foto de la página de Coca-Cola)
• Albumes de fotos: https://graph.facebook.com/99394368305 (El wall de fotos de Coca-Cola)
• Videos: https://graph.facebook.com/614004947048 (Una plática en Tornado)
• Notas: https://graph.facebook.com/122788341354 (Una nota anunciando Facebook para iPhone)

Todos los objetos en FAcebook están conectados unos a otros por medio de relaciones, por ejemplo, Bret Taylor es fan de la página de Coca-Cola y Bret Taylor y Arjun Banker son amigos. Estas relaciones se llaman conexiones en el API. Las conexiones entre elementos se puede leer utilizando la estructura de URL https://graph.facebook.com/ID/CONNECTION_TYPE. Las conexiones soportadas para personas y páginas incluyen:

• Amigos: https://graph.facebook.com/me/friends
• Feed de noticias: https://graph.facebook.com/me/home
• Feed de perfil (wall): https://graph.facebook.com/me/feed
• Gustos: https://graph.facebook.com/me/likes
• Películas: https://graph.facebook.com/me/movies
• Libros: https://graph.facebook.com/me/books
• Notas: https://graph.facebook.com/me/notes
• Fotos: https://graph.facebook.com/me/photos
• Videos: https://graph.facebook.com/me/videos
• Eventos: https://graph.facebook.com/me/events
• Grupos: https://graph.facebook.com/me/groups

Todos los diferentes tipos de objetos y conexiones que están soportados se encuentran documentados en la documentación de referencia de la API de Graph.

Links de utilidad:

• Sitio de Facebook para programadores
• Página de la Graph API de Facebook
• Documentación de referencia de la Graph API
• Ejemplo de una implementación en PHP
• Ejemplo de una implementación en Python
• Más información sobre JSON