Reddit Voting V1

Two self-contained voting actions — vote on a post or vote on a comment. Each action lets you cast an upvote, downvote, or clear your existing vote. One run = one vote = one dataset record.

Bring a Reddit Token V2 + matching proxy, or reuse a saved account from the Reddit Vault. Pick the action, paste the target, choose the direction, hit Start.

---

What you can do

The Post field accepts: full URL (https://reddit.com/r/sub/comments/1sys4r2/...), stripped ID (1sys4r2), or t3_ fullname (t3_1sys4r2). The Comment field accepts: full URL, stripped ID (ogv9p8c), or t1_ fullname (t1_ogv9p8c).

Direction values: up (upvote), down (downvote), or clear (remove your existing vote).

Both actions (Reddit account required)

1. Vote Post — upvote / downvote / clear vote on a post

Casts your account's vote on a Reddit post.

Input: post target (URL / ID / fullname) + direction (up / down / clear).

Returns: echoed action + post + direction + account name + error info (null on success) + bearer expiry + live per-account rate-limit counters.

Use it when: automating engagement on launch posts, clearing stale votes during an account audit, programmatic supporting / suppressing of specific topics within your network.

Example

Input

{
  "operation": "votepost",
  "votepost_post": "https://www.reddit.com/r/Wordpress/comments/1s4a4j6/",
  "votepost_direction": "up",
  "credentialSource": "vault",
  "accountName": "motor_tip8865"
}

Output (one dataset record)

{
  "success": true,
  "operation": "votepost",
  "post": "https://www.reddit.com/r/Wordpress/comments/1s4a4j6/",
  "direction": "up",
  "account_name": "motor_tip8865",
  "error": null,
  "bearer_expires_at": "2026-05-15T11:42:18+00:00",
  "rate_limit": 100,
  "rate_used": 1,
  "rate_remaining": 99,
  "rate_reset_in_seconds": 599
}

2. Vote Comment — upvote / downvote / clear vote on a comment

Casts your account's vote on a Reddit comment.

Input: comment target (URL / ID / fullname) + direction (up / down / clear).

Returns: echoed action + comment + direction + account name + error info + bearer expiry + rate-limit counters.

Use it when: boosting useful answers in support threads, clearing accidental downvotes, automated reactions to keyword matches.

Example

Input

{
  "operation": "votecomment",
  "votecomment_comment": "t1_n0c3kh8",
  "votecomment_direction": "up",
  "credentialSource": "vault",
  "accountName": "motor_tip8865"
}

Output (one dataset record)

{
  "success": true,
  "operation": "votecomment",
  "comment": "t1_n0c3kh8",
  "direction": "up",
  "account_name": "motor_tip8865",
  "error": null,
  "bearer_expires_at": "2026-05-15T11:42:18+00:00",
  "rate_limit": 100,
  "rate_used": 1,
  "rate_remaining": 99,
  "rate_reset_in_seconds": 599
}

---

Credentials

Both actions need a signed-in Reddit account. Save it once in Reddit Vault and reuse the name forever, or paste a Token V2 + matching proxy inline for one-off runs.

Credential lifetimes

Credential	Lifetime	When to refresh
Token V2 (token_v2 cookie)	~24 hours	Daily — or save a Reddit Session in the vault and let it auto-refresh
Reddit Session (reddit_session cookie)	~180 days	Roughly twice a year, or when a run reports unauthorized

How to extract these from your browser: open Reddit in Chrome / Brave / Edge / Firefox, then DevTools → Application → Cookies → https://www.reddit.com. Filter by token_v2 or reddit_session and copy the Value column.

Option A — Use saved account (vault) (recommended)

1. Run the Reddit Vault actor once with mode STORE, an account name (e.g. motor_tip8865), your Token V2 (or Reddit Session for auto-refresh), and the matching proxy.
2. In this actor, set Credential source = Use saved account (vault) and Saved account name = motor_tip8865.
3. Token V2 + proxy are pulled from the vault on every run. If you saved a Reddit Session, the Token V2 auto-refreshes whenever it expires.

Option B — Paste Token V2 + proxy inline

1. Set Credential source = Paste Token V2 + proxy.
2. Paste the eyJ… Token V2 cookie value (encrypted by Apify at rest).
3. Paste the Proxy as ip:port:user:pass — must be the same IP that minted the Token V2 (Reddit IP-binds these cookies).

---

How to run

1. Action → Vote Post or Vote Comment.
2. Fill the matching section (only the chosen action's section matters — the other is ignored).
3. Pick a Direction (up / down / clear).
4. Pick a Credential source and fill the matching vault or manual fields.
5. Hit Start. One run = one vote = one row in the dataset.

---

Output

Every run pushes exactly one record to the run's default dataset. Success and failure both produce a row — the success field distinguishes them.

Front-loaded column	Meaning
success	true if Reddit accepted the vote, false otherwise
operation	votepost or votecomment
post / comment	The target you supplied (URL, ID, or fullname — passed through)
direction	Echoed back (up / down / clear)
account_name	Vault account name (or "manual" for inline credentials)
error	Human-readable message on failure, null on success
error_kind	Short error code (UNAUTHORIZED, RATELIMIT, THREAD_LOCKED, THREAD_ARCHIVED, BANNED, NOT_FOUND, …), null on success
bearer_expires_at	When the saved Token V2 expires (helps you spot upcoming refresh)
rate_limit / rate_used / rate_remaining / rate_reset_in_seconds	Live per-account rate-limit counters from Reddit

---

Common edge cases

Edge case	Cause	How it surfaces
Bearer expired	Saved Token V2 past ~24 h, no vault session for auto-refresh	Row with success: false, error_kind: UNAUTHORIZED. Re-save the account in Reddit Vault with a Reddit Session for auto-refresh.
Bearer minted on a different IP	Token V2 minted on a different proxy than the one paired with it	Row with success: false, error_kind: UNAUTHORIZED. Re-mint the Token V2 on the proxy you'll use, save them as a pair.
Thread archived	Post older than 6 months — Reddit no longer accepts votes	Row with success: false, error_kind: THREAD_ARCHIVED. Pick a non-archived target.
Thread locked	Mod has locked the thread	Row with success: false, error_kind: THREAD_LOCKED. Pick a different target.
Banned from subreddit	Your account is banned from the subreddit	Row with success: false, error_kind: BANNED. Use a different account or get unbanned.
Reddit rate-limit hit	Per-account write throttle reached	Row with success: false, error_kind: RATELIMIT. Wait — rate_remaining tells you how many calls are left in the current window.
Vote on deleted post / comment	Target was deleted or never existed	Row with success: false, error_kind: NOT_FOUND.
Vote silently dropped (vote-suppression)	Reddit accepts the call but doesn't count the vote (anti-manipulation on new / low-karma / datacenter-IP accounts)	Row with success: true — Reddit doesn't tell you the vote was silently nulled. Warm the account up and use residential / mobile proxies before automating.
Missing required input	Forgot to paste the post / comment URL	Run FAILED immediately, no row pushed, no charge.

---

Why this actor is fast

• Speed — under 2 seconds per vote, end-to-end. Pure HTTP to Reddit. No browser to boot, no Playwright / Selenium / Puppeteer overhead. Competing browser-based actors typically take 15–60 seconds per call.
• Reliability — zero browser flakiness. No headless-Chromium crashes. No JS-render timeouts. No captcha pages.
• Footprint — under 100 MB RAM per run. Most browser-based actors need 1–4 GB.

---

Status & error reference

Run status (Apify-side, shown on the run page)

Status	Apify message	Meaning	What to do
	"Actor succeeded with N results in the dataset"	Run finished, one record pushed.	Open the dataset to view the result.
	"The Actor process failed…"	Validation error or missing required input.	Check the run log. You are NOT charged for failed runs.
	"The Actor timed out. You can resurrect it with a longer timeout to continue where you left off."	Run exceeded timeout (rare — votes are fast).	Re-run; check proxy is reachable.
	"The Actor process was aborted. You can resurrect it to continue where you left off."	You stopped the run manually.	No charge for unpushed results.

Common in-run conditions (visible in run log and output record)

Condition	Cause	Result
RATELIMIT from Reddit	Per-account write throttle hit.	Run SUCCEEDED, failure row with error_kind: RATELIMIT.
Bearer expired / invalid	Saved Token V2 past ~24 h, no vault session for auto-refresh.	Run SUCCEEDED, failure row with error_kind: UNAUTHORIZED.
Thread locked / archived	Post / comment no longer accepting votes.	Run SUCCEEDED, failure row with error_kind: THREAD_LOCKED or THREAD_ARCHIVED.
Subreddit ban	Account doesn't have access to the community.	Run SUCCEEDED, failure row with error_kind: BANNED.
Validation error: missing target / direction	Required input not provided.	Run FAILED immediately, no charge.

---

Pricing

Pay-per-result. You're only charged for records actually pushed to the dataset — failed runs, validation errors, and credential errors that never reach Reddit cost nothing.

Event	Trigger	Price (per 1,000)
result	Each row pushed to the dataset (success or failure)	$1.99

Every vote — post or comment, up / down / clear — is one row, one charge.

---

Need a different shape of data?

• Reddit Vault — save Reddit accounts once, call them by name from this actor (free)
• Reddit Voting V2 — newer version with richer success record
• Reddit Commenting V2 — write a top-level comment or reply
• Reddit Manage Comments V2 — Comment Insights, Linked Comment Info, save / unsave / follow / unfollow / delete / edit
• Reddit Posting V2 — create text / link / image / gallery / video / GIF / crosspost / poll posts
• Reddit Post Manager V1 — edit / delete / save / flair / lock / NSFW / spoiler / hide / report your posts
• Reddit Posts & Feeds V2 — home feed + post state controls
• Reddit Users V1 — profile, lookup, follow, block, friend

All of them accept the same accountName field, so saving credentials in Reddit Vault unlocks them all.

---

Support and feedback

Found a bug, want a feature, or hit a Reddit error code we don't translate clearly? Open an issue via the actor's Apify Console feedback link, or reach out at the RedCrawler support channel.

---

Reddit Voting V1 is part of the RedCrawler family of Reddit actors. RedCrawler is independent — not affiliated with, endorsed by, or sponsored by Reddit, Inc. Use it within Reddit's API terms.