Skip to main content

Python SDK for the Facebbok Graph API

Project description

fb is a python sdk for the Facebook Graph Api. The sdk provides two
methods for interacting largely with facebook. One for publishing to facebook,
publish(), and another for retrieving objects from facebook as python dictionary,
get_object()

sudo pip install fb

1. Publishing to Facebook

For publishing, use the publish() method. At developers.facebook.com/docs/reference/api/publishing/
under ‘Other Objects’, see list of publish categories except “photos”. Publishing includes
wrirting wall post, liking objects, creating events and albums, etc. Currently photo
upload is not supported. Upon publish, the method will return a python dictionary containing
the id of the object being published, you can save the id for further interaction with the object.

Example of publishing to facebook

import fb
# Go to developers.facebook.com/tools/explorer to generate test token
token=”the facebook token you are going to use
facebook=fb.graph.api(token)

#Post on the current user’s wall
facebook.publish(cat=”feed”, id=”me”, message=”My faecbook status”)

#Like an object(wall post, photo and anything thats likable in facebook) with id=object_id
facebook.publish(cat=”likes”, id=object_id)

#Comment on an objects thats commentable
facebook.publish(cat=”comments”, id=object_id, message=”My comment”)

#Create an album
facebook.publish(cat=”albums”, id=”me”, name=”Album Name”, message=”Album Details”)

#Create an event
facebook.publish(cat=”events”, id=”me”, name=”My Event”, start_time=”2013-10-16-12:20”, end_time=”2013-10-18-14:30” )

Important

In addition to ‘cat’ (the category) and ‘id’, publish takes any parameter thats
valid for the publish category(cat). Like “message” for “feed”, “name” for “albums”,
nothing for “likes”, etc. Check facebook doc for full list of valid parameters
for each kind of publishing. If you find that a parameter is raising error,
it maybe because this sdk does not yet support the parameter, or facebook doesn’t allow
the parameter for that published category. If you find that the sdk does not support the
parameter, please report the bug to the author.

2. Fetch Objects from Facebook

Objects can be fetched in two ways using the get_object() method.
Fetch “single” object with it’s given “fields” passed in a list.
Or retrieve “multiple” objects passed with their “ids” in a list.

Example of retrieving objects from facebook

#Retrieve given fields for a single object
object=facebook.get_object(cat=”single”, id=object_id, fields=[“name”, “email” ] )

#Retrieve ALL fields for a single object
object=facebook.get_object(cat=”single”, id=object_id, fields=[ ] )

#Rertieve multiple objects
object=facebook.get_object(cat=”multiple”, ids=[‘zuck’, ‘me’] )

Project details


Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page