Homepage of the internet.
About Reddit
Reddit provides a REST API covering account management, links and comments, private messages, moderation, subreddits, users, live threads, modmail, wiki pages, widgets, flair, and search. Endpoints are organized by section and by OAuth scope, and most listing endpoints (such as post and comment feeds) share a common pagination protocol using after/before, limit, count, and show parameters rather than page numbers.
Authentication for API requests uses OAuth; a legacy CSRF-prevention mechanism called a modhash is also documented, obtainable via /api/v1/me or listing endpoint responses, and is not required when using OAuth. The documentation is auto-generated and references a separate set of API access rules that users are expected to follow.
This API is intended for developers building applications or integrations that read or write Reddit data, including posts, comments, subreddit information, user profiles, moderation actions, and messaging.
Key features
- Comprehensive REST API covering posts, comments, votes, and messages
- Subreddit management endpoints for flair, wiki, widgets, and emoji
- Moderation tools including modqueue, reports, ban, and mod notes
- Live thread creation and management endpoints
- OAuth-based authentication with scoped permissions
- Listing pagination via after/before and count parameters for browsing large result sets
Frequently asked questions
What authentication does the Reddit API use?
The API supports OAuth, and modhashes (CSRF tokens) are not required when authenticated with OAuth.
How does pagination work in the Reddit API?
Listings use after/before and count parameters instead of page numbers, since listing content changes frequently.
Who is this API for?
It's for developers building applications that interact with Reddit's posts, comments, subreddits, moderation tools, and live threads.
What functionality is available for moderators?
The API includes moderation endpoints for viewing the modqueue, reports, and spam, as well as approving, removing, and distinguishing content.
Show your product to thousands of developers
· 100k monthly pageviews
· 7k newsletter subscribers
