Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

PRAW, an acronym for `Python Reddit API Wrapper`, is a python package that allows for simple access to reddit's API.

Project description

[![Build Status](https://travis-ci.org/praw-dev/praw.png)](https://travis-ci.org/praw-dev/praw)

# Introduction

PRAW, an acronym for "Python Reddit API Wrapper", is a python package that
allows for simple access to reddit's API. PRAW aims to be as easy to use as
possible and is designed to follow all of [reddit's API
rules](https://github.com/reddit/reddit/wiki/API). You have to give a useragent
that follows the rules, everything else is handled by PRAW so you needn't worry
about violating them.

Here's a quick peek, getting the first 5 submissions from
the 'hot' section of the 'opensource' subreddit:

```python
import praw
r = praw.Reddit(user_agent='my_cool_application')
submissions = r.get_subreddit('opensource').get_hot(limit=5)
[str(x) for x in submissions]
```

This will display something similar to the following:

```python
['10 :: Gun.io Debuts Group Funding for Open Source Projects\n Gun.io',
'24 :: Support the Free Software Foundation',
'67 :: The 10 Most Important Open Source Projects of 2011',
'85 :: Plan 9 - A distributed OS with a unified communication protocol and I/O...',
'2 :: Open-source webOS is dead on arrival ']
```

# Installation
You can install via `pip`

pip install praw

Or via `easy_install`

easy_install praw

You can also install via `setup.py`, this requires either a download or
checkout of the code first. Downloading PRAW from [the cheeseshop]
(http://pypi.python.org/pypi/praw) is recommended, as downloading from github
or doing a checkout may give you a between releases unstable codestate.

# First download or checkout the code then run
python setup.py install

PRAW works with Python 2.6, 2.7, 3.1, 3.2, and 3.3.

# Examples and Configuration

For a number of simple code examples, details on PRAW's
configuration files and links to projects which use this package see the
[wiki](https://github.com/praw-dev/praw/wiki).


# FAQ
> Why is everything so slow?

Usually that has to do with how fast reddit is responding at the moment. Check
the site, see if it's responding quicker when accessing it in your browser.
Otherwise, we respect the "no more than one API call per two seconds" rule, so
if you're trying to do a bunch of quick requests in succession you're going to
be spaced out to one call per second. If you're having a specific issue besides
something covered by one of those two things, please let us know (or file a
ticket) and we'll check it out.


# License
All of the code contained here is licensed by the GNU GPLv3.

Project details


Release history Release notifications

History Node

5.4.0

History Node

5.3.0

History Node

5.2.0

History Node

5.1.0

History Node

5.0.1

History Node

5.0.0

History Node

4.6.0

History Node

4.5.1

History Node

4.5.0

History Node

4.4.0

History Node

4.3.0

History Node

4.2.0

History Node

4.1.0

History Node

4.0.0

History Node

4.0.0rc3

History Node

4.0.0rc2

History Node

4.0.0rc1

History Node

4.0.0b23

History Node

4.0.0b22

History Node

4.0.0b21

History Node

4.0.0b20

History Node

4.0.0b19

History Node

4.0.0b18

History Node

4.0.0b17

History Node

4.0.0b16

History Node

4.0.0b15

History Node

4.0.0b14

History Node

4.0.0b13

History Node

4.0.0b12

History Node

4.0.0b11

History Node

4.0.0b10

History Node

4.0.0b9

History Node

4.0.0b8

History Node

4.0.0b7

History Node

4.0.0b6

History Node

4.0.0b5

History Node

4.0.0b4

History Node

4.0.0b3

History Node

4.0.0b2

History Node

4.0.0b1

History Node

3.6.2

History Node

3.6.1

History Node

3.6.0

History Node

3.5.0

History Node

3.4.0

History Node

3.3.0

History Node

3.2.1

History Node

3.2.0

History Node

3.1.0

History Node

3.0.0

History Node

2.1.21

History Node

2.1.20

History Node

2.1.19

History Node

2.1.18

History Node

2.1.17

History Node

2.1.16

History Node

2.1.15

History Node

2.1.14

History Node

2.1.13

History Node

2.1.12

History Node

2.1.11

History Node

2.1.10

History Node

2.1.9

History Node

2.1.8

History Node

2.1.7

History Node

2.1.6

History Node

2.1.5

History Node

2.1.4

History Node

2.1.3

History Node

2.1.2

History Node

2.1.1

History Node

2.1.0

History Node

2.0.15

History Node

2.0.14

History Node

2.0.13

History Node

2.0.12

History Node

2.0.11

History Node

2.0.10

This version
History Node

2.0.8

History Node

2.0.7

History Node

2.0.6

History Node

2.0.5

History Node

2.0.4

History Node

2.0.3

History Node

2.0.2

History Node

2.0.1

History Node

2.0

History Node

1.0.16

History Node

1.0.15

History Node

1.0.14

History Node

1.0.13

History Node

1.0.12

History Node

1.0.11

History Node

1.0.10

History Node

1.0.9

History Node

1.0.8

History Node

1.0.7

History Node

1.0.6

History Node

1.0.5

History Node

1.0.4

History Node

1.0.3

History Node

1.0.2

History Node

1.0.1

History Node

1.0

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
praw-2.0.8.tar.gz (60.4 kB) Copy SHA256 hash SHA256 Source None Feb 2, 2013

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page