API Reference

Reddit API

Reddit's API has strict per-subreddit rules, aggressive rate limits, and OAuth with rotating tokens. Zernio handles all of that so you can post text, links, and images with one call.

Get API Key Full Documentation

Quick Start

1.
Get API Key
Sign up for free and get your API key in seconds.
2.
Connect Account
Use our OAuth flow to connect Reddit accounts.
3.
Start Posting
Make API calls to post content to Reddit.

Post to Reddit

JavaScript

const response = await fetch('https://zernio.com/api/v1/posts', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    content: 'I built an API that posts to 14 platforms with one call. AMA!',
    title: 'I built an API that posts to 14 platforms with one call. AMA!',
    platforms: [{
      platform: 'reddit',
      accountId: 'acc_abc123'
    }],
    publishNow: true
  })
});

const post = await response.json();
console.log(post.post._id); // '65f1c0a9e2b5af0012ab34cd'

Reddit Endpoints

POST/v1/posts

Create or schedule a Reddit post (text, link, or image)

GET/v1/posts/{id}

Get status and details of a Reddit post

DELETE/v1/posts/{id}

Cancel a scheduled Reddit post

GET/v1/profiles

List all connected Reddit accounts

View full API reference →

Media Requirements

Type	Format	Max Size	Notes
Text Post	Markdown	40,000 chars	Self post with body text
Link Post	URL	N/A	External link submission
Image	JPEG, PNG, GIF	20 MB	Gallery up to 20 images
Video	MP4	1 GB	Up to 15 min duration

Zernio automatically transcodes and optimizes media for Reddit's requirements.

API Limits

Reddit has strict rate limits and spam detection. Zernio handles rate limiting and ensures posts comply with Reddit's guidelines.

Zernio handles all rate limiting automatically. We queue and retry requests as needed.

Features

✓Post text, links, images, and videos
✓Schedule posts for optimal times
✓Subreddit targeting
✓Flair support
✓Multi-account management
✓Webhook notifications for post status
✓NSFW and spoiler tags

Response Example

Response

JSON

{
  "post": {
    "_id": "65f1c0a9e2b5af0012ab34cd",
    "status": "published",
    "title": "I built an API that posts to 14 platforms with one call. AMA!",
    "content": "I built an API that posts to 14 platforms...",
    "platforms": [{
      "platform": "reddit",
      "accountId": { "_id": "acc_abc123", "username": "u/yourhandle" },
      "status": "published",
      "platformPostId": "abc123xyz",
      "platformPostUrl": "https://reddit.com/r/programming/comments/abc123xyz"
    }],
    "publishedAt": "2025-01-10T10:30:00Z"
  },
  "message": "Post published successfully"
}

Start building with Reddit API

Free tier available · No credit card required · 99.97% uptime

Get Free API Key Read Documentation →