Documentation Index
Fetch the complete documentation index at: https://info.bundle.social/llms.txt
Use this file to discover all available pages before exploring further.
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.
| 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 it. |
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
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.
| 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.
Raw Analytics
Reddit profile raw analytics are limited to karma fields.
{
"total_karma": 18420,
"comment_karma": 6400,
"awarder_karma": 120
}
{
"id": "abc123",
"subreddit": "productivity",
"title": "What changed the most in your planning workflow?",
"ups": 420,
"downs": 12,
"num_comments": 88,
"num_crossposts": 4,
"view_count": 12400,
"permalink": "/r/productivity/comments/abc123/example/"
}
