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!

A python wrapper around GetPocket API V3.

Project Description


[![Build Status](](

This package provides a wrapper class around [GetPocket]( V3 APIs.


You can checkout [pocket-cli](, which is an application for reading / listing /managing your pocket articles from the terminal


pip install pocket-api


First, you have to [Create your consumer key]( from getpocket's developer console. To get the access token, you have to authorize the app on your own account. There are tools on the web that can automate this for you such as [fxneumann's OneClickPocket](

from pocket import Pocket, PocketException

p = Pocket(
consumer_key='<Your Consumer Key>',
access_token='<Your Access Token>'

# Fetch a list of articles
print(p.retrieve(offset=0, count=10))
except PocketException as e:

# Add an article

# Start a bulk operation and commit
1168820736, 'Python'
1168820736, 'Web Development'


* Add an article

add(url, title, tags, tweet_id)

* Retrieve articles

retrieve(state, favorite, tag, contentType,
sort, detailType, search, domain,
since, count, offset)

Bulk Actions
* Add an article to bulktime_of_action

bulk_add(item_id, ref_id, tags, time_of_action, title, url)

* Archive article

archive(item_id, time_of_action)

* Reread an article

readd(item_id, time_of_action)

* Mark article as favorite

favorite(item_id, time_of_action)

* Remove favorite mark from article

unfavorite(item_id, time_of_action)

* Delete an article from list

delete(item_id, time_of_action)

* Add tag to article

tags_add(item_id, tags, time_of_action)

* Remove tag from article

tags_remove(item_id, tags, time_of_action)

* Replace tags on article

tags_replace(item_id, tags, time_of_action)

* Clear tags from article

tags_clear(item_id, time_of_action)

* Rename a tag

tag_rename(old_tag, new_tag, time_of_action)

* Reset bulk actions (removes all previously registered actions)


* Send request of all bulk items to getpocket


Release History

This version
History Node


History Node


History Node


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
(5.3 kB) Copy SHA256 Hash SHA256
Source None Sep 24, 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