Skip to main content
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 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

ConstraintValue
Single post0-1 file (image or video)
Video max size1 GB
Video aspect ratio9:16 to 16:9
Video duration4s - 15 min
Image max size20 MB
Gallery0-10 images (if subreddit allows)
Gallery image max size20 MB each
See Platform Limits for more details.

Analytics

For general analytics concepts (refresh rates, data retention, what “Returns 0” means), see the Analytics Overview.

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.
MetricDescriptionNote
impressions-Returns 0 (not available)
impressionsUnique-Returns 0 (not available)
viewsView countMay not be available for all posts
viewsUnique-Returns 0 (not available)
likesUpvotes
dislikesDownvotes
commentsComments
sharesCrossposts
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.