prawcore

What it is and what it does

prawcore is a low-level HTTP communication and authentication layer designed specifically for Reddit API interaction. It handles the mechanics of connecting to Reddit's API endpoints, managing OAuth authentication flows, and translating Python method calls into properly formatted HTTP requests and responses. The package abstracts away the details of HTTP session management, request signing, and credential handling so that higher-level libraries like PRAW can focus on domain logic.

You use prawcore when you need direct, granular control over Reddit API calls or when building tools that interact with Reddit at the protocol level. It provides authenticators for different credential types (script apps, read-only access, etc.) and a session context manager for making authenticated requests. The package follows semantic versioning and is designed to be a stable foundation for other Reddit client libraries.

Use it for:

• Build custom Reddit API clients or bots that need finer control than PRAW provides
• Implement read-only Reddit data scrapers with proper authentication and session management
• Create server-side applications that need to fetch Reddit user data or subreddit information
• Develop tools that interact with Reddit's OAuth flow for user authentication
• Integrate Reddit API calls into larger data pipelines or monitoring systems

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

prawcore provides low-level HTTP communication and authentication handling for Reddit API access, serving as the foundation layer for PRAW 4+.

Yes. prawcore is actively maintained, has low install friction, carries a permissive BSD license, and is the official low-level layer for PRAW 4+. Install it if you need direct Reddit API access or are building on top of PRAW. No known security vulnerabilities.

Install

prawcore on PyPI

pip install prawcore

uv add prawcore

poetry add prawcore

Installing prawcore

Before you install

Low friction install with a single dependency (requests). Actively maintained with a release 62 days ago and recent commits; supports modern Python versions 3.10 through 3.14.

License in practice

BSD license (permissive) allows commercial and private use with minimal restrictions; you must retain copyright notice and disclaimer in distributions.

Quickstart

pip install prawcore

import os
import prawcore

authenticator = prawcore.TrustedAuthenticator(
    client_id=os.environ["PRAWCORE_CLIENT_ID"],
    client_secret=os.environ["PRAWCORE_CLIENT_SECRET"],
    requestor=prawcore.Requestor(user_agent="YOUR_VALID_USER_AGENT"),
)
authorizer = prawcore.ReadOnlyAuthorizer(authenticator=authenticator)
authorizer.refresh()

with prawcore.session(authorizer=authorizer) as session:
    session.request(method="GET", path="/api/v1/user/example/trophies")

Requires environment variables PRAWCORE_CLIENT_ID and PRAWCORE_CLIENT_SECRET to be set with valid Reddit application credentials.

Verify before relying

• Rate limiting and retry behavior for Reddit API throttling
• Error handling and exception types for common API failures
• Support for different Reddit authentication flows beyond TrustedAuthenticator

Package facts

Evidence: prawcore-4.0.0-py3-none-any.whl

Keywords: api, praw, reddit

Tags

More WWW/HTTP packages