Reddit posts API

Collects public Reddit posts — a keyword search (site-wide or inside one subreddit) or a subreddit listing — with title, subreddit, author, score, comment count, creation time, link target and flair. Read from the legacy render, whose post nodes carry those values as attributes, so counts are exact. No API key, no login, no browser.

$0.0005 per delivered post, up to 250 posts per run. Nothing delivered means nothing charged.

Inputs

• query (string) — Keywords to search. Omit to list a subreddit instead.
• subreddit (string) — Subreddit name, e.g. "webscraping" (with or without r/).
• sort (string) — Search: relevance | top | new | comments. Listing: hot | new | top | rising.
• time (string) — Restrict to a period (search and top listings).
• country (string) — ISO 3166-1 alpha-2 code — proxy exit geo and Google locale (gl). Omit for the default pool.
• max_results (integer) — How many posts to deliver at most (1–250). You pay only for delivered posts.

What one post looks like

• rank (integer) — 1-based position across pages.
• id (string, nullable) — Reddit fullname/id of the post.
• title (string, nullable) — Post title.
• subreddit (string, nullable) — Subreddit (r/name).
• author (string, nullable) — Author username.
• score (integer, nullable) — Net upvotes.
• comments (integer, nullable) — Comment count.
• created_at (string, nullable) — Creation time (ISO 8601).
• permalink (string, nullable) — Post URL on reddit.com.
• url (string, nullable) — What the post links to (self-post = its permalink path).
• domain (string, nullable) — Target domain (self.<sub> for text posts).
• nsfw (boolean) — NSFW flag.
• flair (string, nullable) — Post flair when set.

FAQ

What does the Reddit posts API return?

Collects public Reddit posts — a keyword search (site-wide or inside one subreddit) or a subreddit listing — with title, subreddit, author, score, comment count, creation time, link target and flair. Read from the legacy render, whose post nodes carry those values as attributes, so counts are exact. No API key, no login, no browser. Each row carries 13 fields, listed in full on this page.

What do I send it?

A semantic input rather than a URL list. One run returns up to 250 posts.

How much does the Reddit posts API cost?

$0.0005 per delivered post. A run that delivers nothing is not billed, and the