Skip to main content
Reads a Reddit search page with a q query, on reddit.com/search or inside a subreddit, and returns a list of posts as JSON.

Make a request

Send the page’s URL to scrape with a json format that names the parser. This parser works without an API key when you send no options, up to 10 calls a minute and 50 calls a day per IP address. See Rate limits. To lift the limits, get an API key in the Quickstart.

Read the response

The parser’s data is in data.json. Its fields include results, cursor, page and total. This real response is cut to the first items.

Options

Send options in the options object of the json format. It also takes subreddit.

Price

$1 per 1,000 calls. Works without an API key, within the free limits. See Pricing.

Limits and errors

  • The URL must be a Reddit search page with a q query, on reddit.com/search or inside a subreddit. Add type=sr to the page for communities or type=user for people. Any other URL fails with invalidRequest.
  • To read the next page, send the cursor from the response as the cursor option. Paging needs an API key.
  • The answer comes back in data.json. If the page cannot be read, the call fails with an error code from Errors.