Overview 

Reddit is a social news website where users submit original comments and content. Social news and link sharing is one of the more unique ways that content is shared online. With a mix of original and found content, broken into hundreds of categories Reddit covers nearly everything. With streams to collect hot topics, new topics, or keyword search to find only relevant posts, our Reddit streams allow you to get the data you need. The Data Collector will allow you to connect to as many of the available Reddit streams as you’d like.

Gnip provides managed access to Reddit’s public API via the Data Collector. See below for details on the specific type of access supported, and sample payloads.


Data Collector Streams 

Input: Keywords/phrases

Output: Posts matching the keywords you specify

  • Whitespace between multiple terms operates as an AND operator, matching results where both terms appear in any order.
  • Adding quotes acts as a phrase match, matching results where both terms are present in the specified order.
  • Adding a ‘-‘ before a term acts as a negation (e.g. apple -fruit)

Keyword Search - Recent

Input: Keywords/phrases

Output: Recent posts matching the keywords you specify

  • Whitespace between multiple terms operates as an AND operator, matching results where both terms appear in any order.
  • Adding quotes acts as a phrase match, matching results where both terms are present in the specified order.
  • Adding a ‘-‘ before a term acts as a negation (e.g. apple -fruit)

Topics - Hot

Input: Reddit topics, as defined by Reddit (i.e. 'news', 'politics', 'music')

Output: Stream of 'hot' posts in Reddit-defined topics

  • Not suitable for searching on generic keywords.

Topics - New

Input: Reddit topics, as defined by Reddit (i.e. 'news', 'politics', 'music')

Output: Stream of new posts in Reddit-defined topics

  • Not suitable for searching on generic keywords.

Sample Payloads