---
id: prawcore
version: "4.0.0"
license: Copyright (c) 2016, Bryce Boe All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1.… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# prawcore — Low-level communication layer for PRAW 4+.

License: permissive · Maintenance: active · Downloads: 1.7M/mo

## 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 above — 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

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

- License: Copyright (c) 2016, Bryce Boe All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1.… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 1.7M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

reddit api client library, reddit authentication, low-level reddit communication, reddit http layer, praw foundation, reddit api wrapper, reddit oauth, reddit-api, http-client, oauth

[View on SkillFed](https://skillfed.io/packages/prawcore) · [View on PyPI](https://pypi.org/project/prawcore/)