# Reddit Posts API

**Canonical:** https://apis.io/apis/reddit/reddit-posts-api/  
**Provider:** Reddit — https://apis.io/providers/reddit/  
**Base URL:** https://ads-api.reddit.com/api/v3  
**Documentation:** https://github.com/reddit-archive/reddit/wiki/OAuth2

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

Information about posts. > **Note:** This is a legacy API. Use [Structured Posts API](/docs/v3/api/structured-posts) instead.

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| GET | `/posts/{post_id}` | Get Post |
| PATCH | `/posts/{post_id}` | Update Post |
| GET | `/posts/{post_id}/creative_assets` | List Post Creative Assets |
| GET | `/profiles/{profile_id}/posts` | List Posts |
| POST | `/profiles/{profile_id}/posts` | Create Post |

## Machine-readable artifacts (6)

- **OpenAPI** — https://artifacts.apis.io/reddit/openapi/reddit-posts-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
- **Documentation** — https://support.reddithelp.com/hc/en-us/articles/14945211791892-Developer-Platform-Accessing-Reddit-Data
- **JSONSchema** — https://artifacts.apis.io/reddit/json-schema/reddit-oembed-response-schema.json

## Other Reddit APIs (12)

- [Reddit OAuth 2.0 Authorization](https://apis.io/apis/reddit/oauth/)
- [Reddit Account API](https://apis.io/apis/reddit/reddit-account-api/)
- [Reddit Flair API](https://apis.io/apis/reddit/reddit-flair-api/)
- [Reddit Links & Comments API](https://apis.io/apis/reddit/reddit-links-comments-api/)
- [Reddit Listings API](https://apis.io/apis/reddit/reddit-listings-api/)
- [Reddit Messages API](https://apis.io/apis/reddit/reddit-messages-api/)
- [Reddit Moderation API](https://apis.io/apis/reddit/reddit-moderation-api/)
- [Reddit Search API](https://apis.io/apis/reddit/reddit-search-api/)
- [Reddit Subreddits API](https://apis.io/apis/reddit/reddit-subreddits-api/)
- [Reddit Users API](https://apis.io/apis/reddit/reddit-users-api/)
- [Reddit Wiki API](https://apis.io/apis/reddit/reddit-wiki-api/)
- [Reddit Ads API](https://apis.io/apis/reddit/reddit-ads-api/)

## Tags

Posts

---

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