cheat sheets.

Cheat Sheet Title: [ no_spaces_alphanumeric_only ]

Cheat Sheet:
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

Your cheat sheet will be editable (fixable) by anyone. Each cheat sheet is essentially a wiki page. It may also be used by millions of people for reference purposes from the comfort of their command line. If this is okay with you, please save.