Skip to main content

An easy to use HTTP client

Project description

urlfetch is a simple, lightweight and easy to use HTTP client for Python. It is distributed as a single file module and has no depencencies other than the Python Standard Library.


  • Distributed as a single file module, has no depencencies other than the Python Standard Library.
  • Pure Python, works fine with gevent.
  • Small codebase, about 1000 lines and 30% are comments and blank lines. Only 10 minutes you can know every detail.
  • Random user-agent.
  • Support streaming.


$ pip install urlfetch

Hello, world

import urlfetch

response = urlfetch.get('')
print response.status, response.reason
print len(response.content)

Uploading files

import urlfetch

response =
    headers = {
        'Referer': '',
    files = {
        'fieldname1': open('/path/to/file', 'rb'),
        #'fieldname2': 'file content', # file must have a filename
        'fieldname3': ('filename', open('/path/to/file2', 'rb')),
        'fieldname4': ('filename', 'file content'),
    data = {
        'foo': 'bar'

print response.status, response.content

Project details

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page