A class for Subreddits.

To obtain an instance of this class for subreddit r/redditdev execute:

subreddit = reddit . subreddit ( "redditdev" )

While r/all is not a real subreddit, it can still be treated like one. The following outputs the titles of the 25 hottest submissions in r/all :

for submission in reddit . subreddit ( "all" ) . hot ( limit = 25 ): print ( submission . title )

Multiple subreddits can be combined with a + like so:

for submission in reddit . subreddit ( "redditdev+learnpython" ) . top ( "all" ): print ( submission )

Subreddits can be filtered from combined listings as follows. Note that these filters are ignored by certain methods, including comments , gilded() , and SubredditStream.comments() .

for submission in reddit . subreddit ( "all-redditdev" ) . new (): print ( submission )

Typical Attributes

This table describes attributes that typically belong to objects of this class. Since attributes are dynamically provided (see Determine Available Attributes of an Object), there is not a guarantee that these attributes will always be present, nor is this list necessarily complete.

Attribute Description can_assign_link_flair Whether users can assign their own link flair. can_assign_user_flair Whether users can assign their own user flair. created_utc Time the subreddit was created, represented in`Unix Time`_. description Subreddit description, in Markdown. description_html Subreddit description, in HTML. display_name Name of the subreddit. id ID of the subreddit. name Fullname of the subreddit. over18 Whether the subreddit is NSFW. public_description Description of the subreddit, shown in searches and on the “You must be invited to visit this community” page (if applicable). spoilers_enabled Whether the spoiler tag feature is enabled. subscribers Count of subscribers. user_is_banned Whether the authenticated user is banned. user_is_moderator Whether the authenticated user is a moderator. user_is_subscriber Whether the authenticated user is subscribed.

Note Trying to retrieve attributes of quarantined or private subreddits will result in a 403 error. Trying to retrieve attributes of a banned subreddit will result in a 404 error.

__init__ ( reddit, display_name=None, _data=None ) ¶ Initialize a Subreddit instance. Parameters: reddit – An instance of Reddit .

– An instance of . display_name – The name of the subreddit. Note This class should not be initialized directly. Instead obtain an instance via: reddit.subreddit("subreddit_name")

banned ¶ Provide an instance of SubredditRelationship . For example to ban a user try: reddit . subreddit ( "SUBREDDIT" ) . banned . add ( "NAME" , ban_reason = "..." ) To list the banned users along with any notes, try: for ban in reddit . subreddit ( "SUBREDDIT" ) . banned (): print ( f '{ban}: {ban.note}' )

collections ¶ Provide an instance of SubredditCollections . To see the permalinks of all Collection s that belong to a subreddit, try: for collection in reddit . subreddit ( "SUBREDDIT" ) . collections : print ( collection . permalink ) To get a specific Collection by its UUID or permalink, use one of the following: collection = reddit . subreddit ( "SUBREDDIT" ) . collections ( "some_uuid" ) collection = reddit . subreddit ( "SUBREDDIT" ) . collections ( permalink = 'https://reddit.com/r/SUBREDDIT/collection/some_uuid' )

Provide an instance of CommentHelper . For example, to output the author of the 25 most recent comments of r/redditdev execute: for comment in reddit . subreddit ( "redditdev" ) . comments ( limit = 25 ): print ( comment . author )

contributor ¶ Provide an instance of ContributorRelationship . Contributors are also known as approved submitters. To add a contributor try: reddit . subreddit ( "SUBREDDIT" ) . contributor . add ( "NAME" )

controversial ( time_filter: str = 'all', **generator_kwargs ) → Iterator[Any]¶ Return a ListingGenerator for controversial submissions. Parameters: time_filter – Can be one of: all, day, hour, month, week, year (default: all). Raises: ValueError if time_filter is invalid. Additional keyword arguments are passed in the initialization of ListingGenerator . This method can be used like: reddit . domain ( "imgur.com" ) . controversial ( "week" ) reddit . multireddit ( "samuraisam" , "programming" ) . controversial ( "day" ) reddit . redditor ( "spez" ) . controversial ( "month" ) reddit . redditor ( "spez" ) . comments . controversial ( "year" ) reddit . redditor ( "spez" ) . submissions . controversial ( "all" ) reddit . subreddit ( "all" ) . controversial ( "hour" )

emoji ¶ Provide an instance of SubredditEmoji . This attribute can be used to discover all emoji for a subreddit: for emoji in reddit . subreddit ( "iama" ) . emoji : print ( emoji ) A single emoji can be lazily retrieved via: reddit . subreddit ( "blah" ) . emoji [ "emoji_name" ] Note Attempting to access attributes of an nonexistent emoji will result in a ClientException .

filters ¶ Provide an instance of SubredditFilters . For example, to add a filter, run: reddit . subreddit ( "all" ) . filters . add ( "subreddit_name" )

flair ¶ Provide an instance of SubredditFlair . Use this attribute for interacting with a subreddit’s flair. For example to list all the flair for a subreddit which you have the flair moderator permission on try: for flair in reddit . subreddit ( "NAME" ) . flair (): print ( flair ) Flair templates can be interacted with through this attribute via: for template in reddit . subreddit ( "NAME" ) . flair . templates : print ( template )

fullname ¶ Return the object’s fullname. A fullname is an object’s kind mapping like t3 followed by an underscore and the object’s base36 ID, e.g., t1_c5s96e0 .

gilded ( **generator_kwargs ) → Iterator[Any]¶ Return a ListingGenerator for gilded items. Additional keyword arguments are passed in the initialization of ListingGenerator . For example, to get gilded items in subreddit r/test : for item in reddit . subreddit ( "test" ) . gilded (): print ( item . id )

hot ( **generator_kwargs ) → Iterator[Any]¶ Return a ListingGenerator for hot items. Additional keyword arguments are passed in the initialization of ListingGenerator . This method can be used like: reddit . domain ( "imgur.com" ) . hot () reddit . multireddit ( "samuraisam" , "programming" ) . hot () reddit . redditor ( "spez" ) . hot () reddit . redditor ( "spez" ) . comments . hot () reddit . redditor ( "spez" ) . submissions . hot () reddit . subreddit ( "all" ) . hot ()

message ( subject: str, message: str, from_subreddit: Union[Subreddit, str, None] = None ) ¶ Send a message to a redditor or a subreddit’s moderators (mod mail). Parameters: subject – The subject of the message.

– The subject of the message. message – The message content.

– The message content. from_subreddit – A Subreddit instance or string to send the message from. When provided, messages are sent from the subreddit rather than from the authenticated user. Note that the authenticated user must be a moderator of the subreddit and have the mail moderator permission. For example, to send a private message to u/spez , try: reddit . redditor ( "spez" ) . message ( "TEST" , "test message from PRAW" ) To send a message to u/spez from the moderators of r/test try: reddit . redditor ( "spez" ) . message ( "TEST" , "test message from r/test" , from_subreddit = "test" ) To send a message to the moderators of r/test , try: reddit . subreddit ( "test" ) . message ( "TEST" , "test PM from PRAW" )

mod ¶ Provide an instance of SubredditModeration . For example, to accept a moderation invite from subreddit r/test : reddit . subreddit ( "test" ) . mod . accept_invite ()

moderator ¶ Provide an instance of ModeratorRelationship . For example to add a moderator try: reddit . subreddit ( "SUBREDDIT" ) . moderator . add ( "NAME" ) To list the moderators along with their permissions try: for moderator in reddit . subreddit ( "SUBREDDIT" ) . moderator (): print ( f '{moderator}: {moderator.mod_permissions}' )

modmail ¶ Provide an instance of Modmail . For example, to send a new modmail from the subreddit r/test to user u/spez with the subject test along with a message body of hello : reddit . subreddit ( "test" ) . modmail . create ( "test" , "hello" , "spez" )

muted ¶ Provide an instance of SubredditRelationship . For example, muted users can be iterated through like so: for mute in reddit . subreddit ( "redditdev" ) . muted (): print ( f '{mute}: {mute.note}' )

new ( **generator_kwargs ) → Iterator[Any]¶ Return a ListingGenerator for new items. Additional keyword arguments are passed in the initialization of ListingGenerator . This method can be used like: reddit . domain ( "imgur.com" ) . new () reddit . multireddit ( "samuraisam" , "programming" ) . new () reddit . redditor ( "spez" ) . new () reddit . redditor ( "spez" ) . comments . new () reddit . redditor ( "spez" ) . submissions . new () reddit . subreddit ( "all" ) . new ()

classmethod parse ( data: Dict[str, Any], reddit: Reddit ) → Any¶ Return an instance of cls from data . Parameters: data – The structured data.

– The structured data. reddit – An instance of Reddit .

post_requirements ( ) ¶ Get the post requirements for a subreddit. Returns: A dict with the various requirements. The returned dict contains the following keys: domain_blacklist

body_restriction_policy

domain_whitelist

title_regexes

body_blacklisted_strings

body_required_strings

title_text_min_length

is_flair_required

title_text_max_length

body_regexes

link_repost_age

body_text_min_length

link_restriction_policy

body_text_max_length

title_required_strings

title_blacklisted_strings

guidelines_text

guidelines_display_policy For example, to fetch the post requirements for r/test : print ( reddit . subreddit ( "test" ) . post_requirements )

quaran ¶ Provide an instance of SubredditQuarantine . This property is named quaran because quarantine is a Subreddit attribute returned by Reddit to indicate whether or not a Subreddit is quarantined. To opt-in into a quarantined subreddit: reddit . subreddit ( "test" ) . quaran . opt_in ()

random ( ) ¶ Return a random Submission. Returns None on subreddits that do not support the random feature. One example, at the time of writing, is r/wallpapers . For example, to get a random submission off of r/AskReddit : submission = reddit . subreddit ( "AskReddit" ) . random () print ( submission . title )

random_rising ( **generator_kwargs ) → Iterator[Submission]¶ Return a ListingGenerator for random rising submissions. Additional keyword arguments are passed in the initialization of ListingGenerator . For example, to get random rising submissions for subreddit r/test : for submission in reddit . subreddit ( "test" ) . random_rising (): print ( submission . title )

rising ( **generator_kwargs ) → Iterator[Submission]¶ Return a ListingGenerator for rising submissions. Additional keyword arguments are passed in the initialization of ListingGenerator . For example, to get rising submissions for subreddit r/test : for submission in reddit . subreddit ( "test" ) . rising (): print ( submission . title )

rules ¶ Provide an instance of SubredditRules . Use this attribute for interacting with a subreddit’s rules. For example, to list all the rules for a subreddit: for rule in reddit . subreddit ( "AskReddit" ) . rules : print ( rule ) Moderators can also add rules to the subreddit. For example, to make a rule called "No spam" in the subreddit "NAME" : reddit . subreddit ( "NAME" ) . rules . mod . add ( short_name = "No spam" , kind = "all" , description = "Do not spam. Spam bad" )

search ( query, sort='relevance', syntax='lucene', time_filter='all', **generator_kwargs ) ¶ Return a ListingGenerator for items that match query . Parameters: query – The query string to search for.

– The query string to search for. sort – Can be one of: relevance, hot, top, new, comments. (default: relevance).

– Can be one of: relevance, hot, top, new, comments. (default: relevance). syntax – Can be one of: cloudsearch, lucene, plain (default: lucene).

– Can be one of: cloudsearch, lucene, plain (default: lucene). time_filter – Can be one of: all, day, hour, month, week, year (default: all). For more information on building a search query see: https://www.reddit.com/wiki/search For example to search all subreddits for praw try: for submission in reddit . subreddit ( "all" ) . search ( "praw" ): print ( submission . title )

sticky ( number=1 ) ¶ Return a Submission object for a sticky of the subreddit. Parameters: number – Specify which sticky to return. 1 appears at the top (default: 1). Raises prawcore.NotFound if the sticky does not exist. For example, to get the stickied post on the subreddit r/test : reddit . subreddit ( "test" ) . sticky ()

stream ¶ Provide an instance of SubredditStream . Streams can be used to indefinitely retrieve new comments made to a subreddit, like: for comment in reddit . subreddit ( "iama" ) . stream . comments (): print ( comment ) Additionally, new submissions can be retrieved via the stream. In the following example all submissions are fetched via the special subreddit r/all : for submission in reddit . subreddit ( "all" ) . stream . submissions (): print ( submission )

stylesheet ¶ Provide an instance of SubredditStylesheet . For example, to add the css data .test{color:blue} to the existing stylesheet: subreddit = reddit . subreddit ( "SUBREDDIT" ) stylesheet = subreddit . stylesheet () stylesheet += ".test{color:blue}" subreddit . stylesheet . update ( stylesheet )

submit ( title, selftext=None, url=None, flair_id=None, flair_text=None, resubmit=True, send_replies=True, nsfw=False, spoiler=False, collection_id=None, discussion_type=None ) ¶ Add a submission to the subreddit. Parameters: title – The title of the submission.

– The title of the submission. selftext – The Markdown formatted content for a text submission. Use an empty string, "" , to make a title-only submission.

– The Markdown formatted content for a submission. Use an empty string, , to make a title-only submission. url – The URL for a link submission.

– The URL for a submission. collection_id – The UUID of a Collection to add the newly- submitted post to.

– The UUID of a to add the newly- submitted post to. flair_id – The flair template to select (default: None).

– The flair template to select (default: None). flair_text – If the template’s flair_text_editable value is True, this value will set a custom text (default: None).

– If the template’s value is True, this value will set a custom text (default: None). resubmit – When False, an error will occur if the URL has already been submitted (default: True).

– When False, an error will occur if the URL has already been submitted (default: True). send_replies – When True, messages will be sent to the submission author when comments are made to the submission (default: True).

– When True, messages will be sent to the submission author when comments are made to the submission (default: True). nsfw – Whether or not the submission should be marked NSFW (default: False).

– Whether or not the submission should be marked NSFW (default: False). spoiler – Whether or not the submission should be marked as a spoiler (default: False).

– Whether or not the submission should be marked as a spoiler (default: False). discussion_type – Set to CHAT to enable live discussion instead of traditional comments (default: None). Returns: A Submission object for the newly created submission. Either selftext or url can be provided, but not both. For example to submit a URL to r/reddit_api_test do: title = "PRAW documentation" url = 'https://praw.readthedocs.io' reddit . subreddit ( "reddit_api_test" ) . submit ( title , url = url ) See also submit_image() to submit images

to submit images submit_video() to submit videos and videogifs

to submit videos and videogifs submit_poll() to submit polls

to submit polls submit_gallery() . to submit more than one image in the same post

submit_gallery ( title, images, *, collection_id=None, discussion_type=None, flair_id=None, flair_text=None, nsfw=False, send_replies=True, spoiler=False ) ¶ Add an image gallery submission to the subreddit. Parameters: title – The title of the submission.

– The title of the submission. images – The images to post in dict with the following structure: {"image_path": "path", "caption": "caption", "outbound_url": "url"} , only "image_path" is required.

– The images to post in dict with the following structure: , only is required. collection_id – The UUID of a Collection to add the newly- submitted post to.

– The UUID of a to add the newly- submitted post to. discussion_type – Set to CHAT to enable live discussion instead of traditional comments (default: None).

– Set to to enable live discussion instead of traditional comments (default: None). flair_id – The flair template to select (default: None).

– The flair template to select (default: None). flair_text – If the template’s flair_text_editable value isTrue, this value will set a custom text (default: None).

– If the template’s value isTrue, this value will set a custom text (default: None). nsfw – Whether or not the submission should be marked NSFW (default: False).

– Whether or not the submission should be marked NSFW (default: False). send_replies – When True, messages will be sent to the submission author when comments are made to the submission (default: True).

– When True, messages will be sent to the submission author when comments are made to the submission (default: True). spoiler – Whether or not the submission should be marked asa spoiler (default: False). Returns: A Submission object for the newly created submission. If image_path in images refers to a file that is not an image, PRAW will raise a ClientException . For example to submit an image gallery to r/reddit_api_test do: title = "My favorite pictures" image = "/path/to/image.png" image2 = "/path/to/image2.png" image3 = "/path/to/image3.png" images = [ { "image_path" : image }, { "image_path" : image2 , "caption" : "Image caption 2" , }, { "image_path" : image3 , "caption" : "Image caption 3" , "outbound_url" : "https://example.com/link3" , }, ] reddit . subreddit ( "reddit_api_test" ) . submit_gallery ( title , images ) See also submit() to submit url posts and selftexts

to submit url posts and selftexts submit_image() . to submit single images

. to submit single images submit_poll() to submit polls

to submit polls submit_video() . to submit videos and videogifs

submit_image ( title, image_path, flair_id=None, flair_text=None, resubmit=True, send_replies=True, nsfw=False, spoiler=False, timeout=10, collection_id=None, without_websockets=False, discussion_type=None ) ¶ Add an image submission to the subreddit. Parameters: title – The title of the submission.

– The title of the submission. image_path – The path to an image, to upload and post.

– The path to an image, to upload and post. collection_id – The UUID of a Collection to add the newly- submitted post to.

– The UUID of a to add the newly- submitted post to. flair_id – The flair template to select (default: None).

– The flair template to select (default: None). flair_text – If the template’s flair_text_editable value is True, this value will set a custom text (default: None).

– If the template’s value is True, this value will set a custom text (default: None). resubmit – When False, an error will occur if the URL has already been submitted (default: True).

– When False, an error will occur if the URL has already been submitted (default: True). send_replies – When True, messages will be sent to the submission author when comments are made to the submission (default: True).

– When True, messages will be sent to the submission author when comments are made to the submission (default: True). nsfw – Whether or not the submission should be marked NSFW (default: False).

– Whether or not the submission should be marked NSFW (default: False). spoiler – Whether or not the submission should be marked as a spoiler (default: False).

– Whether or not the submission should be marked as a spoiler (default: False). timeout – Specifies a particular timeout, in seconds. Use to avoid “Websocket error” exceptions (default: 10).

– Specifies a particular timeout, in seconds. Use to avoid “Websocket error” exceptions (default: 10). without_websockets – Set to True to disable use of WebSockets (see note below for an explanation). If True , this method doesn’t return anything. (default: False ).

– Set to to disable use of WebSockets (see note below for an explanation). If , this method doesn’t return anything. (default: ). discussion_type – Set to CHAT to enable live discussion instead of traditional comments (default: None). Returns: A Submission object for the newly created submission, unless without_websockets is True . If image_path refers to a file that is not an image, PRAW will raise a ClientException . Note Reddit’s API uses WebSockets to respond with the link of the newly created post. If this fails, the method will raise WebSocketException . Occasionally, the Reddit post will still be created. More often, there is an error with the image file. If you frequently get exceptions but successfully created posts, try setting the timeout parameter to a value above 10. To disable the use of WebSockets, set without_websockets=True . This will make the method return None , though the post will still be created. You may wish to do this if you are running your program in a restricted network environment, or using a proxy that doesn’t support WebSockets connections. For example to submit an image to r/reddit_api_test do: title = "My favorite picture" image = "/path/to/image.png" reddit . subreddit ( "reddit_api_test" ) . submit_image ( title , image ) See also submit() to submit url posts and selftexts

to submit url posts and selftexts submit_video() . to submit videos and videogifs

. to submit videos and videogifs submit_gallery() . to submit more than one image in the same post

submit_poll ( title: str, selftext: str, options: List[str], duration: int, flair_id: str = None, flair_text: str = None, resubmit: bool = True, send_replies: bool = True, nsfw: bool = False, spoiler: bool = False, collection_id: str = None, discussion_type: str = None ) ¶ Add a poll submission to the subreddit. Parameters: title – The title of the submission.

– The title of the submission. selftext – The Markdown formatted content for the submission. Use an empty string, "" , to make a submission with no text contents.

– The Markdown formatted content for the submission. Use an empty string, , to make a submission with no text contents. options – A list of two to six poll options as str .

– A of two to six poll options as . duration – The number of days the poll should accept votes, as an int . Valid values are between 1 and 7 , inclusive.

– The number of days the poll should accept votes, as an . Valid values are between and , inclusive. collection_id – The UUID of a Collection to add the newly- submitted post to.

– The UUID of a to add the newly- submitted post to. flair_id – The flair template to select (default: None).

– The flair template to select (default: None). flair_text – If the template’s flair_text_editable value is True, this value will set a custom text (default: None).

– If the template’s value is True, this value will set a custom text (default: None). resubmit – When False, an error will occur if the URL has already been submitted (default: True).

– When False, an error will occur if the URL has already been submitted (default: True). send_replies – When True, messages will be sent to the submission author when comments are made to the submission (default: True).

– When True, messages will be sent to the submission author when comments are made to the submission (default: True). nsfw – Whether or not the submission should be marked NSFW (default: False).

– Whether or not the submission should be marked NSFW (default: False). spoiler – Whether or not the submission should be marked as a spoiler (default: False).

– Whether or not the submission should be marked as a spoiler (default: False). discussion_type – Set to CHAT to enable live discussion instead of traditional comments (default: None). Returns: A Submission object for the newly created submission. For example to submit a poll to r/reddit_api_test do: title = "Do you like PRAW?" reddit . subreddit ( "reddit_api_test" ) . submit_poll ( title , selftext = "" , options = [ "Yes" , "No" ], duration = 3 )

submit_video ( title, video_path, videogif=False, thumbnail_path=None, flair_id=None, flair_text=None, resubmit=True, send_replies=True, nsfw=False, spoiler=False, timeout=10, collection_id=None, without_websockets=False, discussion_type=None ) ¶ Add a video or videogif submission to the subreddit. Parameters: title – The title of the submission.

– The title of the submission. video_path – The path to a video, to upload and post.

– The path to a video, to upload and post. videogif – A bool value. If True , the video is uploaded as a videogif, which is essentially a silent video (default: False ).

– A value. If , the video is uploaded as a videogif, which is essentially a silent video (default: ). thumbnail_path – (Optional) The path to an image, to be uploaded and used as the thumbnail for this video. If not provided, the PRAW logo will be used as the thumbnail.

– (Optional) The path to an image, to be uploaded and used as the thumbnail for this video. If not provided, the PRAW logo will be used as the thumbnail. collection_id – The UUID of a Collection to add the newly- submitted post to.

– The UUID of a to add the newly- submitted post to. flair_id – The flair template to select (default: None ).

– The flair template to select (default: ). flair_text – If the template’s flair_text_editable value is True, this value will set a custom text (default: None ).

– If the template’s value is True, this value will set a custom text (default: ). resubmit – When False, an error will occur if the URL has already been submitted (default: True ).

– When False, an error will occur if the URL has already been submitted (default: ). send_replies – When True, messages will be sent to the submission author when comments are made to the submission (default: True ).

– When True, messages will be sent to the submission author when comments are made to the submission (default: ). nsfw – Whether or not the submission should be marked NSFW (default: False).

– Whether or not the submission should be marked NSFW (default: False). spoiler – Whether or not the submission should be marked as a spoiler (default: False).

– Whether or not the submission should be marked as a spoiler (default: False). timeout – Specifies a particular timeout, in seconds. Use to avoid “Websocket error” exceptions (default: 10).

– Specifies a particular timeout, in seconds. Use to avoid “Websocket error” exceptions (default: 10). without_websockets – Set to True to disable use of WebSockets (see note below for an explanation). If True , this method doesn’t return anything. (default: False ).

– Set to to disable use of WebSockets (see note below for an explanation). If , this method doesn’t return anything. (default: ). discussion_type – Set to CHAT to enable live discussion instead of traditional comments (default: None). Returns: A Submission object for the newly created submission, unless without_websockets is True . If video_path refers to a file that is not a video, PRAW will raise a ClientException . Note Reddit’s API uses WebSockets to respond with the link of the newly created post. If this fails, the method will raise WebSocketException . Occasionally, the Reddit post will still be created. More often, there is an error with the image file. If you frequently get exceptions but successfully created posts, try setting the timeout parameter to a value above 10. To disable the use of WebSockets, set without_websockets=True . This will make the method return None , though the post will still be created. You may wish to do this if you are running your program in a restricted network environment, or using a proxy that doesn’t support WebSockets connections. For example to submit a video to r/reddit_api_test do: title = "My favorite movie" video = "/path/to/video.mp4" reddit . subreddit ( "reddit_api_test" ) . submit_video ( title , video ) See also submit() to submit url posts and selftexts

to submit url posts and selftexts submit_image() to submit images

to submit images submit_gallery() . to submit more than one image in the same post

Subscribe to the subreddit. Parameters: other_subreddits – When provided, also subscribe to the provided list of subreddits. For example, to subscribe to r/test : reddit . subreddit ( "test" ) . subscribe ()

top ( time_filter: str = 'all', **generator_kwargs ) → Iterator[Any]¶ Return a ListingGenerator for top submissions. Parameters: time_filter – Can be one of: all, day, hour, month, week, year (default: all). Raises: ValueError if time_filter is invalid. Additional keyword arguments are passed in the initialization of ListingGenerator . This method can be used like: reddit . domain ( "imgur.com" ) . top ( "week" ) reddit . multireddit ( "samuraisam" , "programming" ) . top ( "day" ) reddit . redditor ( "spez" ) . top ( "month" ) reddit . redditor ( "spez" ) . comments . top ( "year" ) reddit . redditor ( "spez" ) . submissions . top ( "all" ) reddit . subreddit ( "all" ) . top ( "hour" )

traffic ( ) ¶ Return a dictionary of the subreddit’s traffic statistics. Raises prawcore.NotFound when the traffic stats aren’t available to the authenticated user, that is, they are not public and the authenticated user is not a moderator of the subreddit. The traffic method returns a dict with three keys. The keys are day , hour and month . Each key contains a list of lists with 3 or 4 values. The first value is a timestamp indicating the start of the category (start of the day for the day key, start of the hour for the hour key, etc.). The second, third, and fourth values indicate the unique pageviews, total pageviews, and subscribers, respectively. Note The hour key does not contain subscribers, and therefore each sub-list contains three values. For example, to get the traffic stats for r/test : stats = reddit . subreddit ( "test" ) . traffic ()

Unsubscribe from the subreddit. Parameters: other_subreddits – When provided, also unsubscribe from the provided list of subreddits. To unsubscribe from r/test : reddit . subreddit ( "test" ) . unsubscribe ()

widgets ¶ Provide an instance of SubredditWidgets . Example usage Get all sidebar widgets: for widget in reddit . subreddit ( "redditdev" ) . widgets . sidebar : print ( widget ) Get ID card widget: print ( reddit . subreddit ( "redditdev" ) . widgets . id_card )