Reddit

Reddit is a collection of communities, each with its own rules. The API is functional but stingy with data — especially analytics.

Supported Content Types

Text Posts: title + text. Title is required.
Link Posts: title + URL.
Image Posts: 1 image, or a gallery (up to 10 images if the subreddit allows).
Video Posts: 1 video.

Quirks & Gotchas

Subreddit Rules are King

Each subreddit has its own rules about what's allowed:

Some subreddits don't allow media at all.
Some allow images but not galleries.
Some require flairs.
We validate against subreddit settings before posting. If it's not allowed, you get a clear error.

Engagement Terminology

Likes = Upvotes
Dislikes = Downvotes
Shares = Crossposts

Reddit does not track "Impressions" or "Reach" the way marketers want. If that's a dealbreaker, you're on the wrong platform.

Media Limits

Constraint	Value
Single post	0–1 file (image or video)
Video max size	1 GB
Video aspect ratio	9:16 to 16:9
Video duration	4s – 15 min
Image max size	20 MB
Gallery	0–10 images (if subreddit allows)
Gallery image max size	20 MB each

Text & Field Limits

Field	Limit
`text` (title)	Max 300 characters
`description`	Max 30,000 characters
`link`	Max 2,048 characters

Post Options

Send Reddit-specific options inside data.REDDIT.

Field	Type	Description
`sr`	`string`	Required. Subreddit name such as `r/productivity` or profile target such as `u/username`.
`text`	`string`	Required. Reddit post title. Max 300 characters.
`description`	`string`	Body text for text posts. Max 30,000 characters.
`uploadIds`	`string[]`	Media attachments. One image/video for media posts, or up to 10 images for galleries if the subreddit allows.
`link`	`string`	URL for link posts. Max 2,048 characters.
`nsfw`	`boolean`	Marks the post as NSFW. Default: `false`.
`flairId`	`string`	Flair ID. Required when the subreddit requires a flair.

{
  "teamId": "team_123",
  "title": "Reddit discussion",
  "status": "SCHEDULED",
  "postDate": "2026-06-01T15:00:00.000Z",
  "socialAccountTypes": ["REDDIT"],
  "data": {
    "REDDIT": {
      "sr": "r/productivity",
      "text": "What changed the most in your planning workflow?",
      "description": "We are collecting practical examples from teams.",
      "nsfw": false,
      "flairId": "flair_123"
    }
  }
}

Analytics

Profile Analytics

Status: Not available.

Reddit does not provide profile-level analytics through their API. Everything returns 0. All of it. Every single metric. Don't ask.

Post Analytics

Period: Lifetime.

Metric	Description	Note
`impressions`	—	Returns `0` (not available)
`impressionsUnique`	—	Returns `0` (not available)
`views`	View count	May not be available for all posts
`viewsUnique`	—	Returns `0` (not available)
`likes`	Upvotes
`dislikes`	Downvotes
`comments`	Comments
`shares`	Crossposts
`saves`	—	Returns `0` (not available)

Quirks

Reddit has the most limited analytics of any major platform we support.
No profile-level analytics whatsoever.
View counts exist for some posts but are not guaranteed.
No impressions or reach metrics. Reddit's API simply doesn't provide them.
Upvotes/downvotes are the primary engagement signals.

On this page