Reddit API Python Client

Extract Reddit data with our Reddit API Python client. Get programmatic access to user details, timestamps, vote counts, subreddit information, posts and comments data, and more using simple Python code. Start free, no credit card required.

Try Reddit API Python Client

Trusted by industry leaders all over the world

Integrate our Reddit API

The Apify API client for Python is the official library that allows you to use Reddit API in Python, providing convenience functions and automatic retries on errors. Get started with simple pip installation and robust error handling built-in.

Python

JavaScript

HTTP

MCP

1from apify_client import ApifyClient
2
3# Initialize the ApifyClient with your Apify API token
4# Replace '<YOUR_API_TOKEN>' with your token.
5client = ApifyClient("<YOUR_API_TOKEN>")
6
7# Prepare the Actor input
8run_input = {
9    "startUrls": [{ "url": "https://www.reddit.com/r/pasta/comments/vwi6jx/pasta_peperoni_and_ricotta_cheese_how_to_make/" }],
10    "sort": "new",
11    "maxItems": 10,
12    "maxPostCount": 10,
13    "maxComments": 10,
14    "maxCommunitiesCount": 2,
15    "maxUserCount": 2,
16    "scrollTimeout": 40,
17    "proxy": {
18        "useApifyProxy": True,
19        "apifyProxyGroups": ["RESIDENTIAL"],
20    },
21}
22
23# Run the Actor and wait for it to finish
24run = client.actor("trudax/reddit-scraper").call(run_input=run_input)
25
26# Fetch and print Actor results from the run's dataset (if there are any)
27print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
28for item in client.dataset(run["defaultDatasetId"]).iterate_items():
29    print(item)
30
31# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

Reddit API

Reddit API in JavaScript

Reddit MCP server

Reddit API in CLI

Get data with Reddit API Python client

Use our Python API client to extract Reddit data by providing subreddit URLs, user profiles, or search terms. The API returns structured data, including posts, comments, user details, vote counts, timestamps, media elements, and community information.

Input

{
 "sort": "new",
 "time": "all",
 "type": "community",
 "proxy": {
  "useApifyProxy": true
 },
 "maxItems": 10,
 "searches": [
  "parrots"
 ],
 "maxComments": 10,
 "maxPostCount": 10,
 "maxUserCount": 10,
 "scrollTimeout": 40,
 "maxCommunitiesCount": 10,
 "maxLeaderBoardItems": 10
}

Output

{
 "_fromStrapi": true,
 "id": "t3_144w7sn",
 "url": "<https://www.reddit.com/r/HonkaiStarRail/comments/144w7sn/my_luckiest_10x_pull_yet/>",
 "body": "URL: <https://i.redd.it/yod3okjkgx4b1.jpg\\nThumbnail:> <https://b.thumbs.redditmedia.com/lm9KxS4laQWgx4uOoioM3N7-tBK3GLPrxb9da2hGtjs.jpg\\nImages:\\n\\thttps://preview.redd.it/yod3okjkgx4b1.jpg?auto=webp&amp;v=enabled&amp;s=be5faf0250e19138b82c7bbe5e7406fa46da4e73\\n>",
 "html": null,
 "isAd": false,
 "title": "My Luckiest 10x Pull Yet",
 "over18": false,
 "isVideo": false,
 "upVotes": 1,
 "dataType": "post",
 "parsedId": "144w7sn",
 "username": "YourKingLives",
 "createdAt": "2023-06-09T05:23:15.000Z",
 "scrapedAt": "2023-06-09T05:23:28.409Z",
 "communityName": "r/HonkaiStarRail",
 "numberOfComments": 0,
 "parsedCommunityName": "HonkaiStarRail"
}

How to use Reddit API

Sign up for Apify account01

Creating an account is quick and free — no credit card required. Your account gives you access to more than 5,000 scrapers and APIs.

Get started for free

Install Apify Python client02

Install the Apify Python client using pip: pip install apify-client. This package provides a simple interface to interact with Reddit API from your Python applications.

Get your Apify API token03

Go to settings in the Apify console and navigate to the “API & Integrations” tab. There, create a new token and save it for later.

Integrate Reddit API04

Navigate to the Reddit API page and click on the API dropdown menu in the top right corner. In the dropdown menu, you can see API clients, API endpoints, and more. Use the provided Python code examples to integrate Reddit API into your Python application.

Open Reddit Python API

Get your Reddit data via API05

The Reddit API returns structured JSON data that works perfectly with pandas, NumPy, and other Python data analysis libraries.

Why use Apify?

Never get blocked

Every plan (free included) comes with Apify Proxy, which is great for avoiding blocking and giving you access to geo-specific content.

Customers love us

We truly care about the satisfaction of our users and thanks to that we're one of the best-rated data extraction platforms on both G2 and Capterra.

Monitor your runs

With our latest monitoring features, you always have immediate access to valuable insights on the status of your web scraping tasks.

Export to various formats

Your datasets can be exported to any format that suits your data workflow, including Excel, CSV, JSON, XML, HTML table, JSONL, and RSS.

Integrate Apify to your workflow

You can integrate your Apify runs with platforms such as Zapier, Make, Keboola, Google Drive, or GitHub. Connect with practically any cloud service or web app.

Large developer community

Apify is built by developers, so you'll be in good hands if you have any technical questions. Our Discord server is always here to help!

Python-ready Reddit data extraction

Connect to hundreds of apps right away using ready-made integrations, or set up your own with webhooks and our API.

Frequently asked questions

Reddit does have an official Python API client (PRAW - Python Reddit API Wrapper), but it requires authentication, has usage limitations, and Reddit announced it will become a paid service. Our unofficial Reddit Scraper offers advantages like no authentication required, no registration for tokens, and unrestricted access to publicly available Reddit data without the limitations of the official Python API client.

Yes! You can try our Reddit Python API client for free with Apify's Free plan, which includes $5 in monthly credits. This will give you approximately 1,000 results, perfect for testing the Python API client's capabilities before upgrading to a paid plan.

You can extract comprehensive Reddit data through the Python API client including posts with titles and text, comments with timestamps and points, user details with karma scores, subreddit information with member counts, vote counts, media elements, post and comment URLs, usernames, and community categories. The Python API client supports sorting by Relevance, Hot, Top, and New.

Yes, scraping publicly available Reddit data using a Python API client is generally legal, but it's important to comply with Reddit's terms of service and use the Python client responsibly. Avoid excessive API requests and ensure scraped data is used in compliance with applicable laws and regulations. Python API clients only access publicly available information.

Getting started with our Reddit Python API is easy — simply create a free Apify account, get your API token, and start using the Reddit API in Python, JavaScript, CLI, cURL, OpenAPI, or MCP.