Reddit tools

"what do people on Reddit say about X", "find threads complaining about Y", "who is asking for a tool like ours".

• Everything new in a community since you last looked, use reddit_get_new_posts (ranked search is never complete).
• Reading one thread, use reddit_get_post and reddit_get_comments.
• Choosing communities to watch, use reddit_search_subreddits.

A list, ranked, not exhaustive. Each row has id, subreddit, title, author, created_at, score, comments, upvote_ratio, url, link_url, body (cut at 2000 characters), flair, over_18, is_video.

1 credit per call, up to about 25 posts; nothing on NoData. Cached 1 hour.

"what do people reply when someone asks about X", "find recommendations of a competitor inside threads", mining opinions rather than thread titles.

• Thread titles and bodies, use reddit_search_posts.
• Every comment on one thread, use reddit_get_comments.
• New activity in a community, use reddit_get_new_posts.

A list, ranked, not exhaustive. Each row has id, post_id, post_title, parent_id (the comment it answers, null at top level), subreddit, author, created_at, score, body (cut at 2000 characters), url, depth (0 at top level, null for a reply, whose depth search does not say).

1 credit per call, one page. Cached 1 hour.

"anything new in r/startups since yesterday", "watch these subreddits for mentions of our category", any repeated look at the same communities.

• Keyword search across all of Reddit, use reddit_search_posts (ranked, not complete).
• Reading a thread, use reddit_get_post and reddit_get_comments.
• Choosing which subreddits to watch, use reddit_search_subreddits.

A list, oldest first. Each row has id, subreddit, title, author, created_at, score, comments, upvote_ratio, url, link_url, body, flair, over_18, is_video. coverage[] per subreddit: covered_from, complete, pages_fetched. covered_from later than since, or complete false, means the window was cut: raise pages, shorten since, or pass meta.cursor. next_since is the value to send as since next time; it overlaps by two minutes, so dedupe rows on id. A subreddit that fails (a typo, a private community) is listed in errors[] and the others still answer.

1 credit per subreddit per page. Three subreddits at the default is 3 credits. Never cached.

A row from a search or a check-in is worth reading properly, or you need the full text a row cut at 2000 characters.

• The replies, use reddit_get_comments.
• Finding threads in the first place, use reddit_search_posts or reddit_get_new_posts.

One record with id, subreddit, title, author, created_at, score, comments, upvote_ratio, url, link_url, body (full), flair, over_18, is_video, locked, archived.

1 credit. Cached 1 hour.

"what did people reply", judging whether a thread is worth answering, pulling the objections out of a discussion.

• Comments across many threads, use reddit_search_comments.
• The post itself, use reddit_get_post.

A list, in reading order: a reply follows the comment it answers. Each row has id, post_id, post_title, parent_id (the comment it answers, null at top level), subreddit, author, created_at, score, body (cut at 2000 characters), url, depth (0 is top level). meta.cursor loads more of the thread.

1 credit per call, one page of the thread. Cached 1 hour.

"which subreddits talk about X", picking the communities to pass to reddit_get_new_posts, sizing where a conversation happens.

• A full directory of subreddits about a topic (this counts a sample of posts, so a quiet community can be missing).
• One community's rules and size, use reddit_get_subreddit.
• The posts themselves, use reddit_search_posts.

A list, most posts in the sample first. Each row has name, url, posts_in_sample, example_post_url. Search carries no community size; reddit_get_subreddit gives weekly visitors.

1 credit. Cached 1 hour.

Before you post or reply anywhere, to read the rules on self promotion; sizing a community found by reddit_search_subreddits.

• The posts in the community, use reddit_get_new_posts or reddit_search_posts.
• Finding communities, use reddit_search_subreddits.

One record with name, url, weekly_active_users (visitors in a week, Reddit's measure of size; it publishes no member count), weekly_contributions (posts and comments in a week), description, rules (the text as written; read it, it is not parsed into flags), submit_text, created_at.

1 credit. Cached 7 days.