Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

PyInstapaper is a Python wrapper for the full Instapaper API.

Project description


.. image::

.. image::

.. image::
:alt: Documentation Status

Instapaper_ is a tool for saving web pages to read later, e.g. offline on a
mobile device. PyInstapaper is a Python wrapper for the `full Instapaper API`_.

.. _Instapaper:
.. _full Instapaper API:

To use it, in addition to your Instapaper account username and password,
you'll need to request API credentials from Instapaper.


.. code-block:: python

from pyinstapaper.instapaper import Instapaper, Folder



# Get the 10 latest instapaper bookmarks for the given account and do
# something with the article text
bookmarks = instapaper.get_bookmarks('starred')
for bookmark in enumerate(bookmarks):

# Create a new folder
folder = Folder(instapaper, title='cool stuff')
result = folder.add()


To install PyInstapaper, simply:

.. code-block:: bash

pip install pyinstapaper

Additional info

* Free software: MIT License
* Documentation:
* Boilerplate courtesy of cookiecutter:
* Thanks to `Ryan Galloway`_ for pointing the way to using the Python oauth2
library for Instapaper's XAuth implementation, though ideally pyinstapaper
would use `requests-oauthlib`_

.. _Ryan Galloway:
.. _requests-oauthlib:


0.1.0 (2015-09-26)

* First release on PyPI.

0.2.0 (2018-05-02)

* Python 3 compatibility
* Added 'have' param to get_bookmarks

Project details

Download files

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

Files for pyinstapaper, version 0.2.2
Filename, size File type Python version Upload date Hashes
Filename, size pyinstapaper-0.2.2-py2.py3-none-any.whl (5.8 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size pyinstapaper-0.2.2.tar.gz (12.6 kB) File type Source Python version None Upload date Hashes View

Supported by

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