# Reddit Listings API

**Canonical:** https://apis.io/apis/reddit/reddit-listings-api/  
**Provider:** Reddit — https://apis.io/providers/reddit/  
**Base URL:** https://oauth.reddit.com  
**Documentation:** https://www.reddit.com/dev/api

Reddit Listings API is one of 21 APIs that [Reddit](https://apis.io/providers/reddit/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Listings. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and authentication docs.

Endpoints for retrieving sorted listings of content from subreddits, including hot, new, rising, top, and controversial posts.

## Machine-readable artifacts (6)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/reddit/refs/heads/main/openapi/reddit-listings-api-openapi.yml
- **Documentation** — https://www.reddit.com/dev/api
- **Authentication** — https://github.com/reddit-archive/reddit/wiki/OAuth2
- **TermsOfService** — https://www.redditinc.com/policies/data-api-terms
- **GraphQL** — https://raw.githubusercontent.com/api-evangelist/reddit/refs/heads/main/graphql/reddit-graphql.md
- **Documentation** — https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data

## Other Reddit APIs (12)

- [Reddit Ads API](https://apis.io/apis/reddit/ads-api/)
- [Reddit OAuth 2.0 Authorization](https://apis.io/apis/reddit/oauth/)
- [Reddit Account API](https://apis.io/apis/reddit/reddit-account-api/)
- [Reddit Accounts API](https://apis.io/apis/reddit/reddit-accounts-api/)
- [Reddit Ad Groups API](https://apis.io/apis/reddit/reddit-ad-groups-api/)
- [Reddit Campaigns API](https://apis.io/apis/reddit/reddit-campaigns-api/)
- [Reddit Conversions API](https://apis.io/apis/reddit/reddit-conversions-api/)
- [Reddit Custom Audiences API](https://apis.io/apis/reddit/reddit-custom-audiences-api/)
- [Reddit Flair API](https://apis.io/apis/reddit/reddit-flair-api/)
- [Reddit Funding API](https://apis.io/apis/reddit/reddit-funding-api/)
- [Reddit Links & Comments API](https://apis.io/apis/reddit/reddit-links-comments-api/)
- [Reddit Messages API](https://apis.io/apis/reddit/reddit-messages-api/)

## Tags

Listings

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/reddit/reddit-listings-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/reddit/.