---
title: "Reddit API"
description: "Use Ayrshare's Reddit API to publish text, link, and image posts, schedule them, and get analytics for your users, without waiting on Reddit's access review."
canonical: https://www.ayrshare.com/reddit-api/
lastModified: 2026-11-17
pageType: landing
---

# Reddit API

> Use Ayrshare's Reddit API to publish text, link, and image posts, schedule them, and get analytics for your users, without waiting on Reddit's access review.

## Reddit API for Posting, Scheduling, and Analytics

Ayrshare's Reddit API lets developers publish text, link, and image posts to subreddits from a linked Reddit account via a single REST endpoint. It supports scheduled posts, flair, subreddit checks, comments, history, and analytics across 14+ social networks through one integration.

Your users link their own Reddit accounts through an OAuth flow inside your product. You pass a title and a subreddit, and Ayrshare submits the post as that user, without your own Reddit API access request.

[Read the Reddit Docs](/docs/apis/post/social-networks/reddit)
[Get Your API Key](/pricing/)

- **300** — characters per Reddit title
- **5,000** — characters per text post
- **30M+** — API calls handled daily
- **99.99%** — API uptime

## What Do You Need to Use the Reddit API?

Going direct means registering a Reddit app to get an OAuth client ID and secret, then running Reddit's OAuth flow for every user who posts. New apps need Reddit's approval under its Responsible Builder Policy, and Reddit asks developers to check whether its Developer Platform (Devvit) covers the use case first. Then every subreddit adds its own rules on top of Reddit's.

**What's changing:** Reddit is limiting its public Data API to registered apps. New public access requests are closing, and apps that haven't registered lose access in stages. Reddit points developers toward its Developer Platform or a direct agreement instead. These changes apply to apps that call Reddit themselves.

With Ayrshare, you skip the access request: your users link their Reddit accounts to Ayrshare and post through Ayrshare's integration, so your product doesn't file its own request.

- **Access**: A registered Reddit app and an approved access request. Approval isn't guaranteed, and some use cases aren't allowed at all.
- **Cost**: Free for small, non-commercial use within the rate limit. Commercial use needs an agreement with Reddit and a custom quote, since Reddit publishes no standard rate card.
- **Account types**: Reddit user accounts. Posts go to a subreddit as that user, subject to the subreddit's rules.
- **Key limits**: 100 queries per minute per OAuth client ID, averaged over 10 minutes and shared by every user of the app.

## Post and Schedule to Reddit in Your Language

Each sample publishes a text post now, then schedules an image post for later. Reddit needs a title and a subreddit on every post, so both go in redditOptions. Same endpoint, same JSON, in Node.js, Python, PHP, Java, Go, Ruby, C#, or plain cURL. Add a Profile-Key header to post for one of your users.

[Full Post API Reference](/docs/apis/post/overview)

- **cURL**
- **Node.js**
- **Python**
- **PHP**
- **Java**
- **Go**
- **Ruby**
- **C#**

## Reddit API Limits: Post Types, Media, and Characters

Reddit's rules in one place, with each subreddit's own rules on top. The full list lives in the [Reddit media guidelines](/docs/media-guidelines/reddit) and the [Reddit publishing options](/docs/apis/post/social-networks/reddit).

- **3 post types (Post types)**: Text posts, link posts, and image posts. Reddit's API doesn't allow text and an image in the same post, and link posts carry no body text, so pick one type per request.
- **1 subreddit per post (Accounts and subreddits)**: A linked Reddit user account posts to the subreddit you name in redditOptions. Every post needs a title and a subreddit name without the r/ prefix. Use r/test while you build.
- **10 MB per image (Images)**: JPG, PNG, GIF, or WEBP. Send the image in mediaUrls or as the link. The post text is ignored on image posts but still required.
- **Link posts only (Video)**: Reddit doesn't support video posting through its API, so share video as a link post instead.
- **300 characters per title (Characters)**: Text posts up to 5,000 characters and comments up to 10,000. Text posts take Reddit-flavored Markdown, with u/username and r/subreddit mentions.
- **flairId per post (Flair)**: Some subreddits require flair. Fetch the list with GET /post/redditFlair/:subreddit, then pass a flairId, plus flairText when the flair allows custom text.
- **Varies by subreddit (Subreddit rules)**: Subreddits set karma thresholds, account age or membership periods, posting frequency caps, image bans, title word bans, and self-promotion rules. Breaking them can get the account banned by the subreddit or by Reddit.
- **40 posts per account per day (Scheduling and limits)**: Pass a scheduleDate in ISO 8601 UTC to publish later. Ayrshare recommends no more than 40 Reddit posts per account per day, doesn't check Reddit posts for duplicates, and allows 300 API calls per 5 minutes per profile.

## What Else Can You Do With the Reddit API?

- **Share a URL as a link post**: Put the URL in redditOptions.link. Reddit link posts can't carry a body, so the post field is required but not published.
- **Publish a single image**: Send one JPG, PNG, GIF, or WEBP up to 10 MB in mediaUrls. The API publishes the image alone, and a video sent to Reddit returns an error.
- **Look up flair, then post with it**: List the flairs a subreddit defines, then post with the flairId you want. flairText only applies when the flair's textEditable field is true.
- **Confirm a subreddit exists before posting**: A typo in the subreddit name fails the post, so check the name your user typed and branch on the exists flag in the response.
- **Format with Reddit-flavored Markdown**: Reddit text posts use Reddit-flavored Markdown, not the unicode rich text other networks take. Mention users as u/username and subreddits as r/subreddit.

## Why Use Ayrshare Instead of the Reddit API Directly?

Ayrshare runs the account linking and the submission flow, which changes shape by post type on Reddit: text and images can't share a post, link posts drop the body, and video isn't available at all. Your product sends one request with a title and a subreddit and gets back the Reddit post ID and URL.

The common posting errors come back clearly. A subreddit that has banned the account returns error code 442, and a title with a word the subreddit disallows returns code 443. Neither succeeds on retry as-is, so your scheduler stops instead of looping.

To see Reddit next to every other network on the same /post call, read about Ayrshare's [social media publishing API](/social-media-publishing-api/).

[See the Reddit Publishing Options](/docs/apis/post/social-networks/reddit)

- **One simple endpoint**: Send one POST request with the post, a title, a subreddit, and the user's Profile-Key. Flair lookup and subreddit checks are separate calls you make first.
- **We deal with Reddit**: Account linking, token refresh, and the right submission for text, link, or image posts, without your own Reddit access request.
- **Your data comes back**: Get the Reddit post ID and URL right away. The same Ayrshare id works for analytics, comments, and deletion.

## Beyond Posting: The Rest of the Reddit Lifecycle

Reddit covers posting, comments, history, and analytics through the same account connection. Everything below runs on the integration you already have.

Remove a scheduled Reddit post before it goes out, or a published one afterwards, with the Ayrshare post ID ([delete post docs](/docs/apis/post/delete-post)). See every network you can reach with the same integration on the [supported networks page](/supported-networks/).

- **Analytics**: Post analytics return upvotes, upvote ratio, subreddit, title, and permalink. Account analytics return link karma, comment karma, total karma, and account status.
  - [Analytics API](/social-media-analytics-api/)
- **Comments**: Add a comment to a post, read its comments with upvotes and author, and delete comments sent through Ayrshare.
  - [Engagement API](/social-media-engagement-api/)
- **History**: Pull a user's past Reddit posts sent through Ayrshare, filtered by date, in the same shape as every other network.
  - [History API](/history-api/)
- **Pre-publish checks**: Confirm a subreddit exists and fetch its flair list before you submit, so a bad name or missing flair never reaches Reddit.
  - [Check subreddit docs](/docs/apis/validate/check-subreddit)
- **Not available on Reddit**: Video posting, direct messages, reviews, boosted ads, and replies to existing Reddit comments.

## FAQs About the Reddit API

### Can I post to Reddit through an API?

Yes, you can post to Reddit through an API. Ayrshare's Reddit API lets developers publish text, link, and image posts to subreddits from a linked Reddit account via a single REST endpoint. It supports scheduled posts, flair, subreddit checks, comments, history, and analytics across 14+ social networks through one integration. Start with the [Reddit publishing options](/docs/apis/post/social-networks/reddit).
### Is the Reddit API free?

The Reddit API is free for small, non-commercial use within 100 queries per minute per OAuth client ID. Commercial use needs an agreement with Reddit and a custom quote, and new apps need Reddit's approval before they get access. Ayrshare's plans include Reddit posting for your users without your own access request. [Compare Ayrshare plans](/pricing/).
### How do I get a Reddit API key now?

To get a Reddit API key now, register an app with Reddit for a client ID and secret, then request approval under Reddit's Responsible Builder Policy, since Reddit reviews every new app and is closing new public access requests. With Ayrshare, you use one Ayrshare key instead, and the [Post API reference](/docs/apis/post/overview) shows the request you need.
### How do I post to a subreddit with the Reddit API?

To post to a subreddit with the Reddit API through Ayrshare, send a post to /post with platforms set to reddit and a title and subreddit in redditOptions. Add a flairId if the subreddit requires flair, and check its rules on karma, account age, and self-promotion first. Test in r/test, then see the [Reddit media guidelines](/docs/media-guidelines/reddit) for image rules.
### How does Reddit API authentication work?

Reddit API authentication works through OAuth 2.0: your registered app sends the user to Reddit to approve access, then exchanges the returned code for an access token and refreshes it as it expires. Every call carries that token. With Ayrshare, your users approve one linking screen and you call Ayrshare with your API key. See [how Ayrshare links your users' accounts](/business-plan-for-multiple-users/).
### Is the Reddit API shutting down?

The Reddit API is shutting down for public access. Reddit is removing public Data API access for unregistered apps in stages and pointing developers to its Developer Platform or a direct agreement. Apps that call Reddit themselves need a plan for that. Follow the [Reddit publishing options](/docs/apis/post/social-networks/reddit) for how Ayrshare's Reddit support works.

## Your Users Are on Reddit. Your Product Can Be Too.

Get an API key, publish your first post to r/test, and turn on the other networks with the same call when you need them.

[Get Your API Key](/pricing/)
[Read the Reddit Docs](/docs/apis/post/social-networks/reddit)
