skip to navigation
skip to content

Not Logged In

scrapelib 0.9.1

a library for scraping things

Latest Version: 1.0.0

scrapelib is a library for making requests to websites, particularly those that may be less-than-reliable.

scrapelib originated as part of the Open States project to scrape the websites of all 50 state legislatures and as a result was therefore designed with features desirable when dealing with sites that have intermittent errors or require rate-limiting.

As of version 0.7 scrapelib has been retooled to take advantage of the superb requests library.

Advantages of using scrapelib over alternatives like httplib2 simply using requests as-is:

  • All of the power of the suberb requests library.
  • HTTP, HTTPS, and FTP requests via an identical API
  • support for simple caching with pluggable cache backends
  • request throttling
  • configurable retries for non-permanent site failures
  • optional robots.txt compliance

scrapelib is a project of Sunlight Labs (c) 2013. All code is released under a BSD-style license, see LICENSE for details.

Written by James Turk <>

  • Michael Stephens - initial urllib2/httplib2 version
  • Joe Germuska - fix for IPython embedding
  • Alex Chiang - fix to test suite


  • python 2.7 or 3.3
  • requests >= 1.0


scrapelib is available on PyPI and can be installed via pip install scrapelib

PyPI package:



Example Usage

import scrapelib
s = scrapelib.Scraper(requests_per_minute=10, follow_robots=True)

# Grab Google front page

# Will raise RobotExclusionError

# Will be throttled to 10 HTTP requests per minute
while True:
File Type Py Version Uploaded on Size
scrapelib-0.9.1.tar.gz (md5) Source 2014-03-28 12KB
  • Downloads (All Versions):
  • 85 downloads in the last day
  • 652 downloads in the last week
  • 2738 downloads in the last month