Skip to content
Facepy makes it really easy to use Facebook's Graph API
Python Makefile
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
facepy Bump version to 1.0.11 Sep 29, 2019
tests Add assertion for expires_at Sep 29, 2019
.gitignore get_extended_access_token using api_version=2.3+ returns json instead… Jul 10, 2015
.travis.yml Add 3.6 to CI and tox, remove old versions May 19, 2017
LICENSE Initial commit Apr 20, 2011 Replace references to HISTORY.rst with Sep 28, 2014
requirements.txt Add badges for Python versions and downloads Apr 17, 2019 Don't merge version history into package description Sep 29, 2019
tox.ini Remove support for Python 2.6 and 3.3 Apr 17, 2019


version pythons downloads build license


from facepy import GraphAPI

# Initialize the Graph API with a valid access token (optional,
# but will allow you to do all sorts of fun stuff).
graph = GraphAPI(oauth_access_token)

# Get my latest posts

# Post a photo of a parrot
    path = 'me/photos',
    source = open('parrot.jpg', 'rb')

Facepy can do more than reading your latest posts and posting photographs of parrots, but you'll have to read the documentation to find out how.

Please note that Facepy does not do authentication with Facebook; it only consumes its API. To get an access token to consume the API on behalf of a user, use a suitable OAuth library for your platform (if you're using Django, for example, you might use Fandjango).


$ pip install facepy


  • Fork the repository.
  • Do your thing (preferably on a feature branch).
  • Write a test that demonstrates that the bug was fixed or the feature works as expected.
  • Send a pull request and bug me until I merge it!

I love you

Johannes Gorset made this. You should tweet me if you can't get it to work. In fact, you should tweet me anyway.

I love Schibsted

I work at Schibsted Products & Technology with a bunch of awesome folks who are every bit as passionate about building things as I am. If you're using Facepy, we probably want to hire you.

You can’t perform that action at this time.