Python Easy Facebook API
Make requests to the facebook graph api easily.
Docs
Instantiate the class
from python_easy_facebook_apy import FbApi
# We recommend seriously use a library like python_dotenv to store the facebook access token and the page id.
# To learn how to get access_token and page_id read "Get Access Token and Page ID" in the end of this file.
access_token = "<your access token>"
page_id = "<your page id>"
api = FbApi(
access_token=access_token
page_id=page_id
)
# ...
To add a Text Post
post = api.text_post(
content="<your post content>"
)
To add a Photo Post
post = api.photo_post(
# You can use any framework or library like Flask or Django to store your image and upload to facebook
# Example:
# image_url="https://example.com/image.jpg"
image_url="<your image url>"
)
To add a Text with Photo Post
post = api.text_with_photo_post(
content="<your post content>"
image_url="<your image url>"
)
Submitting the post
# Makes the POST request to the Facebook Graph API
response = post.submit_post()
# Prints the id of the post, or instead, if you had an error with the `access token` or with the `page id` it will show the error details
print(response.json())
Use custom endpoints
To use custom endpoints you can import the class FacebookService
from python_facebook_easy_api import FacebookService
"""
At the moment, this library only make post requests, but it's planned add support to all methods
Example:
POST - https://graph.facebook.com/<page_id>/<custom_endpoint>
payload: {
# The rest of the body
**body,
'access_token': access_token
}
"""
custom_endpoint = FacebookService(
access_token="<your access token>",
page_id="<your page id>",
custom_endpoint="<the facebook graph api endpoint>" # Example: feed
)
# This creates a post with the text "hi"
response = custom_request.submit_request(
{
'message': 'hi'
}
)
print(response.json())
# ...
# Else you can create your own class extending the facebook service
# Example:
class MyCustomPost(FacebookService):
def __init__(self, ...):
FacebookService.__init__(
self,
custom_endpoint="..."
# ...
)
def submit_post(self):
body = {
# ...
}
self.submit_request(body)
Getting the Access Token
-
Firstly, go to Facebook Developer
-
Create a developer account
-
Then, create an application and select that the app type is
Business app
, or something like this -
After you created an application, hover with the mouse the
Tools
menu and selectApi Graph Explorer
-
In the
App Meta
field, select your app that you already created -
Then, in the permissions field, you need to select theese permissions:
- pages_show_list
- pages_read_engagement
- pages_manage_posts
- public_profile
-
After selected the permissions, click on the
Generate Access Token
button, you will see a new window that you have to agree everything and select the Facebook Page that you want to connect, NOTE: below the name of any page, is the page id, you must copy and save on a secure place, if you're usingdotenv
(I seriously recommend use that), you must save thepage id
, with a key likePAGE_ID=<your page id>
in a.env
file. -
And, finally, the last step, after generating the token, you must click on the
User or page
field and select your page, the token will change and you have to copy it and save to use on your app (that token is really sensitive, you have to store it on a environment variable, usingdotenv
)