Reddit 2024

Source Vitals

Source Attributes	Description

Source Attributes	Description
Data Collection Method	real-time firehose
Geographic Coverage	global, more than 100 languages
Key Use Cases	product & market research; company reputation analysis; news events & public attitudes
Delivery Methods	Full stream; filtered stream; search APIs

Data Dictionary

Premium Content Field	Field Definition	Example	Additional Notes

Premium Content Field	Field Definition	Example	Additional Notes
Author	Reddit username	natethegreatt1
AuthorAvatar	The Avatar image of a Reddit user	https://www.redditstatic.com/avatars/defaults/v2/avatar_default_4.png
AuthorAwardeeKarma	Indicating the number of karma points received by an author in the form of Reddit awards	6
AuthorAwarderKarma	Indicating how much karma the author has awarded to other users	0
AuthorDescription	A free-text description from the author's profile page	Writing technical articles at http://www.yourdevopsguy.com . @codinglanguages on Twitter.
AuthorFlairText	Reddit users can set different "flair text" for each subreddit they subscribe to. For example, a resident of the Shoreditch neighborhood of London might set their flair text in the subreddit /r/London to "Shoreditch".	Shoreditch	Appears as author_flair_text in Full Stream
AuthorKarma	A user's karma reflects how much a user has contributed to the Reddit community by an approximate indication of the total votes a user has earned on their submissions ("post karma") and comments ("comment karma"). When posts or comments get upvoted, that user gains some karma.	34799
AuthorUrl	Profile URL for the author of the post or comment	https://www.reddit.com/user/DnDExplainforme	Appears as author_url in Full Stream
Body	Post or comment text	"Looking for vegetarian (NOT VEGAN - cheese and dairy is encouraged!) ideas to fill croissants and baguettes. The menu is central/eastern European, but any and all ideas are welcome!"
BodyHTML	Post or comment text in HTML format	"<!-- SC_OFF --><div class=\"md\"><p>Looking for vegetarian (NOT VEGAN - cheese and dairy is encouraged!) ideas to fill croissants and baguettes. The menu is central/eastern European, but any and all ideas are welcome!</p>\n</div><!-- SC_ON -->"	Appears as body_html in Full Stream
CrossPostParent	The "Name" value or Reddit ID for the parent post of the crossposted post represented by the message itself. Crossposting occurs when a post is reposted to a new subreddit.	t3_15bfi0
ExtKey	Post ID prefixed with the message's 'thing type', t3 for a post, t1 for a comment. Same value as ‘Name”	t3_8n5ysz	In Search API, can use ExtKey or Name field In Full Stream, only Name field available
Gilded	Indicates whether a user has received a gift of Reddit Gold from another user for this post or comment.	5
Id	Legacy Socialgist unique internal numeric ID only available in Search API	16317972	Available via Search API only, not Full Stream
Inserted	Timestamp for when the message was inserted into the /Reddit/Search index	2018-05-30 05:09:41	Available via Search API only, not Full Stream
IsVideo	"true" or "false" value indicating whether the post contains a video that was natively uploaded to Reddit. Note that when the only video in a message is embedded from an external link from a site such as YouTube, "IsVideo" will appear as blank or "false", and metadata about the video will be provided in the "Media" object instead.	true
Language	Language of the message’s text	English
LanguageCode	Two-letter language code following ISO 639-1 format	en
LastModified	Date the message was last modified by the user	2018-05-30 05:09:41	Available via Search API only, not Full Stream
LinkFlairText	Descriptive text provided by the post author for a link	check it out!	Appears as link_flair_text in Full Stream
LinkId	For comments, the parent post ID On posts, will always be null	t3_8myxzd	Appears as link_id in Full Stream Allows you to tie a comment to its parent post.
Media	A json object that describes multimedia content included in a post, such as a photo or video	"media": { "type": "youtube.com", "oembed": { "provider_url": "https://www.youtube.com/", "version": "1.0", "title": "Ole Gunnar Solskjaer Answers The Web's Most Searched Questions About Him \| Autocomplete", "type": "video", "thumbnail_width": 480, "height": 338, "width": 600, "html": "<iframe width=\"600\" height=\"338\" src=\"https://www.youtube.com/embed/HgimD6zJxKg?feature=oembed&enablejsapi=1\" frameborder=\"0\" allow=\"accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture\" allowfullscreen></iframe>", "author_name": "Sky Sports Football", "provider_name": "YouTube", "thumbnail_url": "https://i.ytimg.com/vi/HgimD6zJxKg/hqdefault.jpg", "thumbnail_height": 360, "author_url": "https://www.youtube.com/channel/UCNAf1k0yIjyGu3k9BwAg3lg" }
Name	Unique ID for a post or comment. Same value as ExtKey	t3_8n5ysz
NumComments	Number of comments for a post. Currently this is always zero, not yet updated	5	Appears as num_comments in Full Stream
Origin	Internal reference value. May be required for debugging.	20200501_050050_5eabe5424644b.1
Over18	Boolean indicating whether the post is tagged as NSFW by Reddit. Only applies to posts,not comments. Hourly rechecks on posts are done and any that are TRUE will be included in the compliance feed for deletion.	true	Appears as over_18 in Full Stream
ParentId	For comments, either the parent post ID (same as LinkId), or the parent comment ID when the comment is a nested reply. On posts, will always be null.	t3_8myxzd	Appears as parent_id in Full Stream Allows you to fully reconstruct the Reddit conversation thread including post, comments, and nested replies
ParsedLinks	All links extracted from the text of posts and comments. Typically external URLs.	`"0": { "Type": "text", "Title": "Here", "Url": "https://imgur.com/a/uCPaaUI" }`
Permalink	URL for a message	https://www.reddit.com/r/Cooking/comments/8n5ysz/what_are_some_great_nonmeat_fillings_for/
Published	Date the message was created	2018-05-30 05:09:39
Subreddit	Name of subreddit where message was posted	Cooking
SubredditId	Unique ID for a subreddit. Prefix is always "t5_" for 'thing type' = subreddit.	t5_2qh7f	Appears as subreddit_ID in Full Stream
SubredditSubscribers	Count of subscribers to subreddit at time of posting	29
SubredditTitle	Title of the subreddit.	World News
Thing	Thing type which can be "link", meaning a post, or "comment"	link
Title	Title of a message	"What are some great non-meat fillings for croissant and baguette sandwiches?"	The title also appears as a separate field under the Data object without keyword highlighting if that was selected in the Search API.
TitleHTML	HTML title of a message	“`Canadian miners use China's rare metals ban to push back <Keyword>on</Keyword> <Keyword>Trump</Keyword> tariffs`"
Thumbnail	Link to thumbnail image uploaded as part of message. If image not uploaded, field contains "self" or "default"	https://a.thumbs.redditmedia.com/_M008KHK52zt9jpEopUumEL8WAqwyROUgYvC5TAc6f8.jpg
Url	Can be external links or reddit.com URLs depending on how the post was created.	http://hindi.cnmsports.com/cricket/india-vs-england-1st-test-today-playing-11-for-both-teams

Example Messages

Post Full Stream:

{
   "thing":"link",
   "id":"t3kp2s",
   "name":"t3_t3kp2s",
   "author":"Top_Argument9010",
   "author_url":"https://www.reddit.com/user/Top_Argument9010",
   "created":1646068906,
   "permalink":"https://www.reddit.com/r/u_Top_Argument9010/comments/t3kp2s/itsmyne/",
   "subreddit":"u_Top_Argument9010",
   "subreddit_id":"t5_5tstle",
   "body":"If you're looking for affordable tokens, I recommend $MYNE tokens for you. I'm sure it will be worth it.",
   "body_html":"
If you're looking for affordable tokens, I recommend $MYNE tokens for you. I'm sure it will be worth it.

\n
",
   "author_flair_text":null,
   "gilded":0,
   "parent_id":null,
   "link_id":null,
   "url":"https://www.reddit.com/r/u_Top_Argument9010/comments/t3kp2s/itsmyne/",
   "link_flair_text":null,
   "num_comments":0,
   "over_18":false,
   "thumbnail":"self",
   "media":null,
   "is_video":false,
   "crosspost_parent":null,
   "upvote_ratio":1,
   "language":"English",
   "language_code":"en",
   "title":"ITSMYNE",
   "subreddit_subscribers":0,
   "author_karma":2,
   "author_avatar":"https://www.redditstatic.com/avatars/defaults/v2/avatar_default_4.png",
   "author_awardee_karma":0,
   "author_awarder_karma":0,
   "author_description":null,
   "subreddit_title":""
}

Post REST API:

{"Id":27786810723,
   "ExtKey":"t3_spyziu",
   "Title":"Hello World - Get Started",
   "Published":"2022-02-11 13:04:39",
   "Inserted":"2022-02-11 13:05:25",
   "LastModified":"2022-02-15 12:48:06",
   "Data":{
      "Language":"English",
      "LanguageCode":"en",
      "Title":"Hello World - Get Started",
      "SubredditSubscribers":5,
      "AuthorKarma":1,
      "AuthorAvatar":"https:\/\/styles.redditmedia.com\/t5_5dha09\/styles\/profileIcon_snoo3ad78399-1569-4553-a233-ed88393e71de-headshot.png?width=256&height=256&crop=256:256,smart&s=a97b2b72d54ad01979c061a9a9af1b3cee60c045",
      "AuthorAwardeeKarma":0,
      "AuthorAwarderKarma":0,
      "AuthorDescription":"",
      "SubredditTitle":"rawlabs",
      "Thing":"link",
      "Name":"t3_spyziu",
      "Author":"jeposner",
      "AuthorUrl":"https:\/\/www.reddit.com\/user\/jeposner",
      "Permalink":"https:\/\/www.reddit.com\/r\/rawlabs\/comments\/spyziu\/hello_world_get_started\/",
      "Subreddit":"rawlabs",
      "SubredditId":"t5_5dhagb",
      "Body":"[https:\/\/github.com\/raw-labs\/hello-world](https:\/\/github.com\/raw-labs\/hello-world)\n\nalso an accompanying video:\n\n[https:\/\/raw-labs.com\/resource\/get-started-raw-hello-world\/](https:\/\/raw-labs.com\/resource\/get-started-raw-hello-world\/)",
      "BodyHtml":"<!-- SC_OFF --><div class=\"md\"><p><a href=\"https:\/\/github.com\/raw-labs\/hello-world\">https:\/\/github.com\/raw-labs\/hello-world<\/a><\/p>\n\n<p>also an accompanying video:<\/p>\n\n<p><a href=\"https:\/\/raw-labs.com\/resource\/get-started-raw-hello-world\/\">https:\/\/raw-labs.com\/resource\/get-started-raw-hello-world\/<\/a><\/p>\n<\/div><!-- SC_ON -->",
      "AuthorFlairText":"",
      "Gilded":0,
      "Score":"1",
      "ParentId":"",
      "LinkId":"",
      "Url":"https:\/\/www.reddit.com\/r\/rawlabs\/comments\/spyziu\/hello_world_get_started\/",
      "LinkFlairText":"",
      "NumComments":"0",
      "Over18":false,
      "Thumbnail":"self",
      "Media":"",
      "IsVideo":false,
      "CrosspostParent":"",
      "UpvoteRatio":1,
      "ParsedLinks":{
         "Link":[
            {
               "Link":"https:\/\/www.reddit.com\/r\/rawlabs\/comments\/spyziu\/hello_world_get_started\/",
               "Title":"https:\/\/www.reddit.com\/r\/rawlabs\/comments\/spyziu\/hello_world_get_started\/",
               "Type":"int"
            }
         ]
      }
   }

Comment Full Stream:

{
   "thing":"comment",
   "id":"hyso57m",
   "name":"t1_hyso57m",
   "author":"yeahboiiiioi",
   "author_url":"https://www.reddit.com/user/yeahboiiiioi",
   "created":1646066681,
   "permalink":"https://www.reddit.com/r/yorickmains/comments/t313to/can_a_full_build_level_18_yorick_destroy_nexus/hyso57m/",
   "subreddit":"yorickmains",
   "subreddit_id":"t5_37i85",
   "body":"Yeah same. It also makes kiting really easy and lets your ghouls rack up a lot more chip damage as the enemies try to chase you down",
   "body_html":" Yeah same. It also makes kiting really easy and lets your ghouls rack up a lot more chip damage as the enemies try to chase you down",
   "author_flair_text":null,
   "gilded":0,
   "parent_id":"t1_hyru8ww",
   "link_id":"t3_t313to",
   "url":null,
   "link_flair_text":null,
   "num_comments":null,
   "over_18":null,
   "thumbnail":null,
   "media":null,
   "is_video":null,
   "crosspost_parent":null,
   "upvote_ratio":null,
   "language":"English",
   "language_code":"en",
   "title":"can a full build level 18 Yorick destroy nexus turret without wave?",
   "subreddit_subscribers":18783,
   "author_karma":2306,
   "author_avatar":"https://www.redditstatic.com/avatars/defaults/v2/avatar_default_0.png",
   "author_awardee_karma":30,
   "author_awarder_karma":0,
   "author_description":null,
   "subreddit_title":"r/Zedongmains"
}

Comment REST API:

{
   "Id":617413739809,
   "ExtKey":"t1_hq6ig5u",
   "Title":"Writing Hello World in Python - Python Course for Beginners",
   "Published":"2021-12-27 19:16:55",
   "Inserted":"2021-12-27 19:17:37",
   "LastModified":"2021-12-29 10:23:34",
   "Data":{
      "Language":"English",
      "LanguageCode":"en",
      "Title":"Writing Hello World in Python - Python Course for Beginners",
      "SubredditSubscribers":65034,
      "AuthorKarma":4258,
      "AuthorAvatar":"https:\/\/styles.redditmedia.com\/t5_4v5km3\/styles\/profileIcon_snoo88bbf1e9-c70f-433a-a2f1-e333b528eb67-headshot.png?width=256&height=256&crop=256:256,smart&s=88b81540680fcff7dad4d4a4015f4a73fac956ec",
      "AuthorAwardeeKarma":28,
      "AuthorAwarderKarma":0,
      "AuthorDescription":"",
      "SubredditTitle":"Quick python tips to add to your collection",
      "Thing":"comment",
      "Name":"t1_hq6ig5u",
      "Author":"jfp1992",
      "AuthorUrl":"https:\/\/www.reddit.com\/user\/jfp1992",
      "Permalink":"https:\/\/www.reddit.com\/r\/pythontips\/comments\/rplde7\/writing_hello_world_in_python_python_course_for\/hq6ig5u\/",
      "Subreddit":"pythontips",
      "SubredditId":"t5_3evbu",
      "Body":"    hello = h\n    world = w\n\n    # Lowercase from here on as I'm on mobile, this is a comment\n\n    Print('hello world')\n    Print(hello world')\n    Print ('hello', w)\n    Print(h, w)\n    Print(f'hello {w}')\n    Print(f'{h} {w}')\n    Print(f\"{h} 'world'\")\n\nEdit: I hope that rendered ok",
      "BodyHtml":"<div class=\"md\"><pre><code>hello = h\nworld = w\n\n# Lowercase from here on as I'm on mobile, this is a comment\n\nPrint('hello world')\nPrint(hello world')\nPrint ('hello', w)\nPrint(h, w)\nPrint(f'hello {w}')\nPrint(f'{h} {w}')\nPrint(f\"{h} 'world'\")\n<\/code><\/pre>\n\n<p>Edit: I hope that rendered ok<\/p>\n<\/div>",
      "AuthorFlairText":"",
      "Gilded":0,
      "ParentId":"t3_rplde7",
      "LinkId":"t3_rplde7",
      "Url":"",
      "LinkFlairText":"",
      "NumComments":"",
      "Over18":"",
      "Thumbnail":"",
      "Media":"",
      "IsVideo":"",
      "CrosspostParent":"",
      "UpvoteRatio":"",
      "ParsedLinks":{
         "Link":[
            
         ]
      }
   }
}

Reddit 2024

Data Dictionary

Example Messages

Related content