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 library for the API

Project Description

Python library for the API.


Use the library directly:

import instapaperlib

instapaperlib.auth("username", "password")
instapaperlib.add_item("username", "password", "URL", "title")
# with selection test set
instapaperlib.add_item("username", "password", "URL", "title", "selection")

Create an instance to work with:

from instapaperlib import Instapaper

i = Instapaper("username", "password")

Catch the return codes to work with:

from instapaperlib import Instapaper

i = Instapaper("username", "password")
(statuscode, statusmessage) = i.add_item("URL", "title")

Also catch the response header:

from instapaperlib import Instapaper

i = Instapaper("username", "password")
(statuscode, statusmessage, title, location) = i.add_item("URL", "title", response_info=True)

Or use the cli client: -u user -p password -t title URL

If you have set your username:password in ~/.instapaperrc: URL


Install via pip:

pip install instapaperlib

Or, if you must:

easy_install instapaperlib


  • fork the repo
  • add your changes and tests so I don’t accidentally break anything in the future
  • run the tests: python instapaperlib/
  • open a pull request (also runs the tests via Travis CI)
  • high-five yourself, you’re awesome

0.5.1 (2016-01-13)

  • fix travis.yml misconfig that only ran tests on master branch

0.5.0 (2016-01-13)

  • add support for new instapaper API

0.4.0 (2010-09-06)

  • add support for JSONP
  • add support for redirect=close

0.3.1 (2010-06-05)

  • add doctest unit test
  • catch exception in auth because of new query method

0.3.0 (2010-05-24)

  • Choose between HTTP/HTTPS (HTTPS standard)
  • Set selection for added URL
  • proper use of auto-title parameter
  • Response headers (Content-Location, X-Instapaper-Title) are returned

0.2.0 (2010-05-20)

  • Restructured as python package
  • PyPi compatibility
  • Add CLI client

0.1.0 (2010-05-01)

  • Basic library working
  • Working add_item
Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
instapaperlib-0.5.1.tar.gz (4.5 kB) Copy SHA256 Checksum SHA256 Source Jan 14, 2016

Supported By

WebFaction WebFaction Technical Writing 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 Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting