Skip to main content

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

Project description

https://travis-ci.org/praw-dev/praw.svg?branch=master https://coveralls.io/repos/praw-dev/praw/badge.svg?branch=master

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. 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:

>>> 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:

['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 communicatioprotocol  I/O...',
  '2 :: Open-source webOS is dead on arrival ']

Installation

PRAW works with python 2.6, 2.7, 3.1, 3.2, 3.3, and 3.4. The recommended way to install is via pip

$ pip install praw

If you want to run the development version of PRAW try:

$ pip install --upgrade https://github.com/praw-dev/praw/archive/master.zip

If you don’t have pip installed, then the Hitchhiker’s Guide to Python has a section for setting it up on Windows, Mac and Linux. There is also a Stack overflow question on installing pip on Windows that might prove helpful.

Alternatively you can do it via easy_install

$ easy_install praw

Support

The official place to ask questions about PRAW, reddit and other API wrappers is r/redditdev. If the question is more about Python and less about PRAW, such as “what are generators”, then you’re likely to get more, faster and more in-depth answers in r/learnpython.

If you’ve uncovered a bug or have a feature request, then make an issue on our project page at github.

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

Documentation

PRAW’s documentation, which includes tutorials, information on configuring PRAW and other good stuff can be found at readthedocs.

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

This version
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

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-3.2.1-py2.py3-none-any.whl (68.4 kB) Copy SHA256 hash SHA256 Wheel 3.4 Aug 19, 2015
praw-3.2.1.zip (1.8 MB) Copy SHA256 hash SHA256 Source None Aug 19, 2015

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