Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Python wrapper for the Buffer API

Project Description

|img| puffer |qs| |bs| |cc| |rtd| |gitter|
Simple to use python wrapper for the Buffer API

.. |img| image::
:width: 30
.. |qs| image::
.. |bs| image::
.. |cc| image::
.. |rtd| image::
.. |gitter| image::

### ORM`ish
------------ details some useful entities:
* user
* profile
* update
* link
* info

Every entity can be seen as an object that has attributes and methods. Those
methdos and attributes are linked to certain endpoints.

All objects are special dicts. For example, you can do something like:
```python => '12455678976asd'
user => {...}

If you want to see more complete examples, click [here](../master/examples)

#### Authorization
Get access_token using buffer [docs](


service = AuthService(client_id, client_secret, redirect_uri)

url = service.authorize_url

# Access the url and retrieve the token
auth_code = #Paste the code from the redirected url

access_token = service.get_access_token(auth_code)

api = service.create_session(access_token)

#### User
A user represents a single Buffer user account.


api = API(client_id='client_id',

# instantiate an user object
user = User(api=api)

print user
print user.timezone

#### Profile
A Buffer profile represents a connection to a single social media account.

profiles = Profiles(api=api)
print profiles.all() # get all profiles

# filter profiles using some criteria
profile = Profiles(api=api).filter(service='twitter')[0]
print profile # my twitter profile

# get schedules of my twitter profile
print profile.schedules

# update schedules times for my twitter profile
profile.schedules = {
'days': ['tue', 'thu'],
'times': ['13:45']

#### Update
An update represents a single post to a single social media account.

# retrieve a single update based on an id
update = Update(api=api, id='51de8d33e48c051712000019')
print update

# get update's interactions
print update.interactions

# edit
update = update.edit(text="Hey!")

# publish now

# move to top

# delete

#### Updates and profiles

# get all pending updates of a social network profile
profile = Profiles(api=api).filter(service='twitter')[0]
print profile.updates.pending

# get all sent updates of a social network profile
print profile.updates.sent

# retrieve all update's interactions
print profile.updates.sent[0].interactions

# shuffle updates
print profile.updates.shuffle(count=10)

# reorder updates
print profile.updates.reorder(['51dd27629f7fdf520d00009a'])

# create an update
print"Hello there", now=True)

#### Links
A link represents a unique URL that has been shared through Buffer

# get a link's shares
print Link(api=api, url='').shares

#### Info
Returns an object with the current configuration that Buffer is using,
including supported services, their icons and the varying limits of character
and schedules.

# instantiate the api object
api = API(client_id='client_id',

# get api's info

Release History

This version
History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(18.1 kB) Copy SHA256 Hash SHA256
Wheel 3.5 Jul 29, 2016
(19.8 kB) Copy SHA256 Hash SHA256
Source None Jul 29, 2016

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting