Skip to main content
POST /v1/data/reddit/posts/run Pricing: $0.005 per result ($5.00 per 1,000). Every run adds a flat $0.0005 fee, charged even when nothing is found.

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string
Reddit URL to scrape posts from. Accepts a subreddit (r/technology or the full URL), a single post link, a user profile (returns that user’s posts), or a listing feed. Leave it empty to search all of Reddit with Search Keyword.Format e.g. https://www.reddit.com/r/technology/.
string
Optional. A keyword to search Reddit posts for (e.g. ‘gpt5’). Use on its own, or add it alongside the URLs above; both run together.
integer
Number of posts to return. Use 0 for all.
string
default:"top"
Sort order for posts.Allowed values: top (Top), new (Newest), hot (Hot), relevance (Relevance), comments (Most comments).
string
default:"all"
Time window for posts. Only applies when Sort By is “Top” (Reddit ignores it for the other sorts). (Preset windows only; no custom date ranges.)Allowed values: all (All time), year (Past year), month (Past month), week (Past week), day (Past 24 hours), hour (Past hour).

Example

Response fields

Each row in data is one result, keyed by these fields.

Example response

Abridged: long text and lists are shortened.
For the comment thread use reddit/comments; for a user’s karma and bio use reddit/profiles.