---
title: "Reddit API: turn Reddit into structured data | Scrape.ly"
description: "Extract public Reddit posts and comment threads from searches, subreddits, user profiles, and post URLs: text, scores, timestamps, and media."
url: https://scrape.ly/api/reddit-api
markdown: https://scrape.ly/api/reddit-api.md
---

G2

4.7/5

[Excellent](https://www.trustpilot.com/review/scrape.ly)

[Trustpilot](https://www.trustpilot.com/review/scrape.ly)

# Turn Reddit into structured data

Extract public Reddit posts and comment threads from searches, subreddits, user profiles, and post URLs: text, scores, timestamps, and media.

[Try Reddit API](https://scrape.ly/store/echofield/reddit-scraper.md)

01 Integration

## Integrate Reddit API your way

Connect to Scrape.ly using Python, JavaScript, HTTP, cURL, OpenAPI, or MCP and start extracting Reddit data in minutes.

from scrapely_client import ScrapelyClient

client = ScrapelyClient ( 'YOUR_TOKEN' , api_url = 'https\://api.scrape.ly' )

run = client. actor ( 'echofield/reddit-scraper' ) . call (

run_input = {

'subredditName' : 'python' ,

'maxPosts' : 10 ,

'maxComments' : 20 ,

}

)

for item in client. dataset ( run.default_dataset_id ) . iterate_items () :

print ( item )

02 Input & Output

## Send a subreddit or search, get posts and comment threads

Pass search queries, subreddits, user profiles, and post URLs into Scrape.ly. Get structured outputs with post titles and text, scores, comment counts and threads, timestamps, and authors and subreddits, and more.

Input

1 2 3 4 5

```
{
 "subredditName":"python",
 "maxPosts":10,
 "maxComments":20
}
```

Output

1 2 3 4 5 6 7 8 9 10

```
{
 "kind":"post",
 "title":"What Python library saved you the most time this year?",
 "author":"data_wrangler42",
 "subreddit":"python",
 "score":1842,
 "num_comments":613,
 "created_utc":"2026-10-17T12:03:44Z",
 "url":"https://www.reddit.com/r/Python/comments/1g5abc1/"
}
```

03 How it works

## Start extracting Reddit data in four simple steps

Scrape.ly keeps the setup simple so you can move from signup to live Reddit data without wasting time on scraping infrastructure.

[Get started for free](https://my.scrape.ly/register)

Step 1

### Create your Scrape.ly account

Create your account and get access to ready-made APIs, scrapers, and automation tools.

Step 2

### Get your Scrape.ly API token

Copy your API token from the Scrape.ly dashboard and use it to authenticate your requests.

Step 3

### Connect Reddit API

Choose Python, JavaScript, HTTP, or MCP and connect Scrape.ly to your app or workflow.

Step 4

### Fetch Reddit data

Send your search queries, subreddits, user profiles, and post URLs, then receive clean structured data ready for analysis.

04 Why Scrape.ly

## Everything you need to extract data reliably

Scrape.ly gives you ready-made APIs, proxy support, monitoring, exports, integrations, and scalable infrastructure in one platform.

### Never Get Blocked

Use built-in proxy support to reduce blocks, rate limits, and failed requests.

### Export Any Format

Get results in JSON, CSV, Excel, XML, HTML table, RSS, or other workflow-friendly formats.

### Monitor Every Run

Track scraper status, performance, failures, retries, and outputs from one dashboard.

### Built-In Integrations

Connect with webhooks, APIs, automation tools, cloud apps, and internal systems.

### Scalable Infrastructure

Run small tests or high-volume extraction jobs without rebuilding your scraping stack.

### Developer-Friendly

Use clean APIs, SDKs, docs, examples, and structured outputs built for real workflows.

05 AI-Ready Data

## Feed Reddit data into your tools instantly

Connect Scrape.ly with your apps, dashboards, sheets, agents, and automation workflows to turn Reddit data into action.

[Browse integrations](https://scrape.ly/integrations.md) [API Reference](https://scrape.ly/docs/api-overview.md)

![AI-ready data workflow illustration](https://scrape.ly/assets/pages/api/ai-ready-data/ai-ready.svg)

06 Explore APIs

## More Reddit APIs on Scrape.ly

Browse ready-made Reddit scrapers and APIs available inside Scrape.ly and choose the one that fits your workflow.

![Reddit Scraper logo](https://scrape.ly/cdn-cgi/image/width=132,fit=scale-down,format=auto/https://api.scrape.ly/v2/actors/f09a36bf3b19486e8/picture.webp?v=0e722addc3c15c0cd13608266ae6fa3b)

### [Reddit Scraper](https://scrape.ly/store/echofield/reddit-scraper.md)

scrape.ly/store/echofield/reddit-scraper

---

[Echofield](https://scrape.ly/users/echofield.md "Developed by Echofield")

Social media Automation

---

635 monthly users

[Try for free](https://my.scrape.ly/store/echofield~reddit-scraper?intent=signup)

### Check other related APIs

[View all](https://scrape.ly/api.md)

[YouTube API](https://scrape.ly/api/youtube-api.md)

[Pinterest API](https://scrape.ly/api/pinterest-api.md)

[Instagram API](https://scrape.ly/api/instagram-api.md)

[TikTok API](https://scrape.ly/api/tiktok-api.md)

[Facebook API](https://scrape.ly/api/facebook-api.md)

[Facebook Marketplace API](https://scrape.ly/api/facebook-marketplace-api.md)

07 FAQ

## Common questions about Reddit API

Quick answers about using Scrape.ly's Reddit API, available data, setup, and legal usage.

Got more questions? [Reach out to us](mailto:hello@scrape.ly?subject=Reddit%20API%20question\&body=I%20have%20a%20question%20about%20the%20Reddit%20API.)

### How is this different from an official Reddit API?

---

Official APIs, where they exist, usually need approval, keys, or paid tiers and limit which public data you can pull. Scrape.ly's Reddit API collects the public data shown on Reddit and returns it as structured JSON, with no approval process.

### Can I try the Reddit API for free?

### What data can I get from the Reddit API?

### Is it legal to scrape Reddit data?

### How do I get started with the Reddit API?

G2

4.7/5

[Excellent](https://www.trustpilot.com/review/scrape.ly)

[Trustpilot](https://www.trustpilot.com/review/scrape.ly)

## The internet is full of data. Start owning yours.

Scrape.ly gives you the infrastructure, the tooling, and the team to extract, process, and operationalize web data at any scale. Setup takes minutes.

[Get Started Free](https://my.scrape.ly/register) [Chat with Support](mailto:hello@scrape.ly?subject=Question%20about%20Scrape.ly\&body=Hi%2C%20I%20have%20a%20question%20about%20Scrape.ly.)

No credit card. No setup calls.
