Skip to content
Instapaper Python API
Python
Branch: master
Clone or download
Pull request Compare This branch is 3 commits ahead of rsgalloway:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore
MANIFEST.in
README.rst
example.py
instapaper.py
requirements_dev.txt
setup.py
test_instapaper.py
tox.ini

README.rst

Instapaper

Unofficial full Instapaper API Python wrapper.

Installation

Using easy install

$ easy_install instapaper

Or from source

$ git clone https://github.com/rsgalloway/instapaper.git
$ cd instapaper
$ python setup.py install

Basic Usage

Logging in:

>>> from instapaper import Instapaper as ipaper
>>> i = ipaper(INSTAPAPER_KEY, INSTAPAPER_SECRET)
>>> i.login(email_address, password)

Getting bookmarks:

>>> marks = i.bookmarks()

Get the html:

>>> marks[0].html

Or the raw text:

>>> marks[0].text

Folders:

>>> folders = i.folders()
>>> for f in folders:
...     print f.folder_id, f.title

Move bookmark:

>>> marks[0].move(f.folder_id)

Playback

Have a long commute home from work? Have your Instapaper bookmarks read back to you using "utter" (pip install utter). You can even have them read back to you in a differnet language, for example Italian:

>>> import utter
>>> for m in marks:
...     utter.play(m.text, target="it")
You can’t perform that action at this time.