PRAW

PRAW stands for Python Reddit API Wrapper.

PRAW uses a simple approach to the Reddit API, allowing concrete data to be retrieved using just a few lines of code.

The library has reached stable status and includes support for most of Reddit's API, including for retrieving hot topics, recent threads, images, comments, user details and lots more.

Besides this, OAuth 2.x support is also included, allowing developers to create Reddit apps and allow Reddit users to use their Reddit credentials to authenticate on other sites.

What is new in this release:

• Fixed "multiple values for argument" error when solving captchas.

What is new in version 3.3.0:

• Fixed "multiple values for argument" error when solving captchas.

What is new in version 3.0.0:

• Added get_message() to fetch a single Message object by its ID.
• Added get_sticky() to get a Subreddit's sticky post.
• Refresh tokens can be specified in praw.ini via oauth_refresh_token.
• Added create_multireddit() to create a new Multireddit.
• Added copy_multireddit() to copy a Multireddit.
• Added edit_multireddit() to edit an existing Multireddit.
• Added get_multireddits() to get a list of Multireddits belonging to the requested user.
• Added rename_multireddit() to rename an existing Multireddit.
• Added set_suggested_sort() to change a submission's sort order.
• Added method as optional parameter to request_json(), so that a request method other than ‘POST' can be specified.

What is new in version 2.1.21:

• FEATURE:
• Added the get_flair_choices() method to the Submission class, which returns the choices for user flair in the subreddit and the current flair of the authenticated user.
• Added the get_flair_choices() method to the Submission class, which returns the choices for link flair on this submission as well as it's current flair.
• BUGFIX:
• Python 3 issue with func_defaults.

What is new in version 2.1.20:

• FEATURE:
• Added the get_flair_choices() method to the Submission class, which returns the choices for user flair in the subreddit and the current flair of the authenticated user.
• Added the get_flair_choices() method to the Submission class, which returns the choices for link flair on this submission as well as it's current flair.
• BUGFIX:
• Python 3 issue with func_defaults.

What is new in version 2.1.15:

• FEATURE:
• Added save OAuth scope to save() and unsave().
• BUGFIX:
• Google AppEngine bug with platform.platform.
• CHANGE:
• Using get_flair() now requires moderator access. See this r/redditdev thread.
• Increase the dependency of update_checker to 0.9 or later.

What is new in version 2.1.13:

• FEATURE:
• Support building wheel binary distributions.
• get_submission() and from_url() now supports URL parameters. Both included within the url and explicitly via the "params" argument.
• CHANGES:
• The dependency on update_checker has been increased to >= 0.8.
• REDDIT:
• Add support for changes to UserLists on reddit.
• Using get_flair_list now requires moderator access. See this r/redditdev thread
• BUGFIX:
• Configuration parsing for store_json_result.
• Duplicate bug in BoundedSet.

What is new in version 2.1.10:

• Added:
• get_new_subreddits() to return the newest subreddits.
• The arguments save and send_replies to submit().
• Create and add history scope to get_comments(), get_disliked(), get_liked(), get_overview(), get_submitted(), get_hidden() and get_saved().

What is new in version 2.1.6:

• Fixed:
• PRAW automatically retries failed requests to reddit if the error is likely to be a temporary one.

What is new in version 2.1.5:

• FEATURE:
• select_flair() method added, can be used to change your flair without moderator access on subreddits that allow it.
• Added sticky() and unsticky() to sticky and unsticky a submission to the top of a subreddit.
• Added arguments syntax and period to search().
• PRAW will now try to use the http_proxy environment variable for proxy settings, if no proxy is set in the configuration file.
• BUGFIX:
• get_stylesheet() erroneously required moderator access. It now just requires that the authenticated user has access to the subreddit.
• Bug that prevented the usage of search() when called from Subreddit.

What is new in version 2.1.4:

• FEATURE:
• get_mod_mail() can now be used to get moderator mail from individual subreddits, instead of all moderated subreddits, just like get_mod_queue().
• BUGFIX"
• Fixed an error in get_mod_queue(), get_reports(), get_spam() and get_unmoderated() when calling them from Reddit without giving the subreddit argument explicitly.

What is new in version 2.1.1:

• FEATURE:
• Added praw.helpers.comment_stream() to provide a never-ending stream of new comments.
• BUGFIX:
• Don't cache requests whose responses will result in an exception. This bug was introduced in version 2.1.0.

What is new in version 2.0.15:

• PRAW can now use a proxy server.

Requirements:

• Python 2.6 or higher