FACEBOOK GRAPH CHEAT SHEET
==========================
INTRODUCTION
============
Object Output:
{
"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"
}
All objects in Facebook can be accessed in the same way:
https://graph.facebook.com/ID/CONNECTION_TYPE
* Users: https://graph.facebook.com/btaylor (Bret Taylor)
* Pages: https://graph.facebook.com/cocacola (Coca-Cola page)
* Events: https://graph.facebook.com/251906384206 (Facebook Developer Garage
Austin)
* Groups: https://graph.facebook.com/2204501798 (Emacs users group)
* Applications: https://graph.facebook.com/2439131959 (the Graffiti app)
* Status messages: https://graph.facebook.com/367501354973 (A status message
from Bret)
* Photos: https://graph.facebook.com/98423808305 (A photo from the Coca-Cola
page)
* Photo albums: https://graph.facebook.com/99394368305 (Coca-Cola's wall
photos)
* Videos: https://graph.facebook.com/614004947048 (A Facebook tech talk on
Tornado)
* Notes: https://graph.facebook.com/122788341354 (Note announcing Facebook
for iPhone 3.0)
Logged-in User Objects
* Friends: https://graph.facebook.com/me/friends
* News feed: https://graph.facebook.com/me/home
* Profile feed (Wall): https://graph.facebook.com/me/feed
* Likes: https://graph.facebook.com/me/likes
* Movies: https://graph.facebook.com/me/movies
* Books: https://graph.facebook.com/me/books
* Notes: https://graph.facebook.com/me/notes
* Photos: https://graph.facebook.com/me/photos
* Videos: https://graph.facebook.com/me/videos
* Events: https://graph.facebook.com/me/events
* Groups: https://graph.facebook.com/me/groups
SELECTION
=========
fields => https://graph.facebook.com/bgolub?fields=id,name,picture
ids => https://graph.facebook.com?ids=arjun,vernal
current user => https://graph.facebook.com/me
INSTROSPECTION
==============
https://graph.facebook.com/331218348435?metadata=1
{
"name": "Facebook Developer Garage Austin - SXSW Edition",
"metadata": {
"connections": {
"feed": "http://graph.facebook.com/331218348435/feed",
"picture": "https://graph.facebook.com/331218348435/picture",
"invited": "https://graph.facebook.com/331218348435/invited",
"attending": "https://graph.facebook.com/331218348435/attending",
"maybe": "https://graph.facebook.com/331218348435/maybe",
"noreply": "https://graph.facebook.com/331218348435/noreply",
"declined": "https://graph.facebook.com/331218348435/declined"
}
}
}
AUTHORIZATION
=============
https://graph.facebook.com/220439?access_token=...
The steps to obtain an access token are:
* Get App ID and secret.
* Redirect the user to https://graph.facebook.com/oauth/authorize with your
client_id and the callback URL:
https://graph.facebook.com/oauth/authorize?
client_id=...&
redirect_uri=http://www.example.com/oauth_callback
* Redirect the user back to the callback URL you specified with a verification
string in the argument code, which can be exchanged for an oauth access token.
https://graph.facebook.com/oauth/access_token?
client_id=...&
redirect_uri=http://www.example.com/oauth_callback&
client_secret=...&
code=...
* Use the access token returned by the request above to make requests on behalf
of the user:
https://graph.facebook.com/me?access_token=...
PUBLISH TO FACEBOOK
===================
curl -F 'access_token=...' \
-F 'body=Hello, Arjun. I like this new API.' \
https://graph.facebook.com/arjun/feed
curl -F 'access_token=...' \
https://graph.facebook.com/313449204401/likes
We support writing the following types of objects:
Method Description Arguments
-------------------------------------------------------------------------------
/PROFILE_ID/feed write to the given profile's feed/wall message,
picture, link, name, description
/POST_ID/comments comment on the given post message
/POST_ID/likes like the given post none
/PROFILE_ID/notes write a note on the given profile message, subject
/PROFILE_ID/links write a link on the given profile link, message
/EVENT_ID/attending attend the given event none
/EVENT_ID/maybe maybe attend the given event none
/EVENT_ID/declined decline the given event none
curl -F 'access_token=...' \
-F 'message=I am posting to my own feed. I am awesome.' \
https://graph.facebook.com/me/feed
DELETING OBJECT
===============
DELETE https://graph.facebook.com/ID?access_token=... HTTP/1.1
https://graph.facebook.com/COMMENT_ID?method=delete
PICTURES
========
<img src="https://graph.facebook.com/herryanto/picture"/>
* People: http://graph.facebook.com/herryanto/picture
* Events: http://graph.facebook.com/331218348435/picture
* Groups: http://graph.facebook.com/335845912900/picture
* Pages: http://graph.facebook.com/DoloresPark/picture
* Applications: http://graph.facebook.com/2318966938/picture
* Photo Albums: http://graph.facebook.com/platform/picture
PICTURE SIZES:
- square (50x50)
- small (50 pixels wide, variable height)
- large (about 200 pixels wide, variable height)
http://graph.facebook.com/herryanto/picture?type=large.
PAGING
======
* limit, offset: https://graph.facebook.com/me/likes?limit=3
* until, since (a unix timestamp or any date accepted by strtotime):
https://graph.facebook.com/search?until=yesterday&q=orange
SEARCH
======
https://graph.facebook.com/search?q=QUERY&type=OBJECT_TYPE
* All public posts: https://graph.facebook.com/search?q=watermelon&type=post
* People: https://graph.facebook.com/search?q=mark&type=user
* Pages: https://graph.facebook.com/search?q=platform&type=page
* Events: https://graph.facebook.com/search?q=conference&type=event
* Groups: https://graph.facebook.com/search?q=programming&type=group
News Feed: https://graph.facebook.com/me/home?q=facebook
ANALYTICS
=========
Obtain Access Token:
curl -F type=client_cred \
-F client_id=your_app_id \
-F client_secret=your_app_secret \
https://graph.facebook.com/oauth/access_token
https://graph.facebook.com/app_id/insights?access_token=...
https://graph.facebook.com/app_id/insights/share_views/day?access_token=...
Params:
* since
* until
https://graph.facebook.com/app_id/insights?access_token=...&since=yesterday
PERMISSIONS
===========
PUBLISHING PERMISSIONS
----------------------
publish_stream : Enables your application to post content, comments, and likes
to a user's stream and to the streams of the user's friends,
without prompting the user each time.
create_event : Enables your application to create and modify events on the
user's behalf
rsvp_event : Enables your application to RSVP to events on the user's
behalf
sms : Enables your application to send messages to the user and
respond
to messages from the user via text message
offline_access : Enables your application to perform authorized requests on
behalf of the user at any time.
By default, most access tokens expire after a short time
period
to ensure applications only make requests on behalf of the
user
when the are actively using the application.
This permission makes the access token returned by our OAuth
endpoint long-lived.
DATA PERMISSIONS
----------------
User permission Friends permission Description
---------------------------------------------------------------------------------
-
email not available Provides access to the user's primary email
address in the email property
read_stream not available Provides access to all the posts in the
user's
News Feed and enables your application to
perform
searches against the user's News Feed
user_about_me friends_about_me Provides access to the "About Me" section
of the
profile in the about property
user_activities friends_activities Provides access to the user's list of
activities
as the activities connection
user_birthday friends_birthday Provides access to the full birthday with
year
as the birthday_date property
user_education_history friends_education_history
Provides access to education history as the
education property
user_events friends_events Provides access to the list of events the
user is
attending as the events connection
user_groups friends_groups Provides access to the list of groups the
user is a
member of as the groups connection
user_hometown friends_hometown Provides access to the user's hometown in
the
hometown property
user_interests friends_interests Provides access to the user's list of
interests
as the interests connection
user_likes friends_likes Provides access to the list of all of the
pages
the user has liked as the likes connection
user_location friends_location Provides access to the user's current
location as
the current_location property
user_notes friends_notes Provides access to the user's notes as the
notes
connection
user_online_presence friends_online_presence
Provides access to the user's
online/offline presence
user_photo_video_tags friends_photo_video_tags
Provides access to the photos the user has
been
tagged in as the photos connection
user_photos friends_photos Provides access to the photos the user has
uploaded
user_relationships friends_relationships
Provides access to the user's family and
personal
relationships and relationship status
user_religion_politics friends_religion_politics
Provides access to the user's religious and
political
affiliations
user_status friends_status Provides access to the user's most recent
status message
user_videos friends_videos Provides access to the videos the user has
uploaded
user_website friends_website Provides access to the user's web site URL
user_work_history friends_work_history
Provides access to work history as the work
property
read_friendlists not available Provides read access to the user's friend
lists
read_requests not available Provides read access to the user's friend
requests
