Reddit Poster

Reddit Automation - Post text, links, images, and comments to any subreddit. Browser automation for reliable posting without API rate limits. Perfect for community engagement, content marketing, and brand building. Supports text posts, link shares, image uploads, and comment replies.

BYOK (Bring Your Own Key) -- you provide your own API credentials.

---

Before You Start

This actor requires your own API credentials to fetch real data.

Where to get your key: Reddit password

You can test with Demo Mode first (free, no key needed) to see the output format before committing.

---

Quick Start

Test with Demo Mode (free, no API key needed)

{
  "demoMode": true,
  "linkUrl": "https://example.com",
  "imageUrl": "https://example.com",
  "replyToUrl": "https://example.com"
}

Run with real data

{
  "demoMode": false,
  "password": "YOUR_API_KEY_HERE",
  "cookies": "YOUR_API_KEY_HERE",
  "postType": "text",
  "linkUrl": "https://example.com",
  "imageUrl": "https://example.com",
  "replyToUrl": "https://example.com",
  "nsfw": false,
  "spoiler": false,
  "timeout": 120,
  "utmTracking": {
    "enabled": true
  },
  "cookieKvStoreName": "cookie-sessions"
}

---

Input Parameters

Parameter	Type	Default	Required	Description
username	string	-	No	Reddit username
password	string	-	Yes*	Reddit password
cookies	string	-	Yes*	Exported cookies from logged-in session (recommended for accounts with 2FA)
subreddit	string	-	No	Subreddit to post to (e.g., 'localSEO' or 'r/localSEO')
postType	string	"text"	No	Type of post to create
title	string	-	No	Title for your post (required for text/link/image posts)
content	string	-	No	Text content for your post or comment
linkUrl	string	-	No	URL for link posts
imageUrl	string	-	No	URL of image to post (Note: Reddit may require file upload)
replyToUrl	string	-	No	URL of post/comment to reply to (required for comment type)
flair	string	-	No	Post flair to apply (must match available flair in subreddit)
nsfw	boolean	false	No	Mark post as Not Safe For Work
spoiler	boolean	false	No	Mark post as containing spoilers
timeout	integer	120	No	Maximum time to wait for the operation to complete
demoMode	boolean	true	No	Run in demo mode without real credentials. Returns mock success response for testing.
webhookUrl	string	-	No	URL to receive a POST request when the actor run finishes. Useful for integrations with Zapier, Make, n8n, or custom automation workflows.
indexNowKey	string	-	No	Optional IndexNow API key for instant search engine indexing of posted content. Get your key at https://www.bing.com/indexnow
utmTracking	object	{"enabled":true}	No	Enable UTM tracking parameters on link post URLs for analytics. Default: { enabled: true } - will auto-add utm_source=reddit, utm_medium=social, utm_campaign=reddit_post_YYYYMMDD
cookieStorageKey	string	-	No	Key in the KV store to load cookies from (created by Cookie Manager actor). If provided and no manual cookies are set, cookies will be loaded automatically from the KV store.
cookieKvStoreName	string	"cookie-sessions"	No	Name of the Apify Key-Value store holding cookie sessions. Default: 'cookie-sessions'

*Required when Demo Mode is off.

---

Pricing

This actor uses pay-per-event billing:

Event	Description	Price
Post Created	Each Reddit post or comment created	$0.05

Demo mode is free -- no charges for sample data.

---

Troubleshooting

"API key is required"

You have Demo Mode turned off but didn't provide an API key. Either:

• Turn Demo Mode on to test with sample data
• Add your API key in the input

"API error 403" or "Unauthorized"

Your API key is invalid, expired, or doesn't have access to this specific API endpoint. Double-check your key and account permissions.

"API error 429" or "Rate limit"

Too many requests. Wait a minute and try again, or reduce the number of items per run.

No results or empty dataset

Check the run log for error messages. Common causes:

• Invalid input format (check the examples above)
• API key without proper permissions
• The target data doesn't exist or is too small to track

How do I test without an API key?

Enable Demo Mode in the input. This returns realistic sample data so you can verify the output format works for your workflow.

---

Built by John Rippy | Actor Arsenal