Reddit Manage Comments V2

Three V2 management actions for Reddit comments — pull analytics, fetch parent-post / crosspost context, or run state controls (save, unsave, follow, unfollow, delete, edit).

1. Comment Insights — score, view counts, share counts, geography, engagement metrics (bearer required)
2. Linked Comment Info — parent-post context (title, subreddit, removal status) plus the comment's own richtext (anonymous, no account needed)
3. Comment State Controls — save / unsave / follow / unfollow / delete / edit one of your own comments (bearer required)

Pick an action, fill the matching section, hit Start. Linked Comment Info ignores credentials entirely.

---

What this actor does

Pick an action from the dropdown, fill the matching section, supply credentials (only for bearer-required actions), run.

You can:

• Comment Insights — pull a single comment's analytics (score / impressions / shares / geography). (bearer required)
• Linked Comment Info — fetch the parent post's context for a comment (post title, subreddit, author, removal status, NSFW / spoiler / locked flags) plus the comment's own structured richtext content. Useful for crosspost-as-comment workflows. (anonymous)
• Comment State Controls — apply one of 6 state actions to one of your own comments: save, unsave, follow (reply notifications), unfollow, delete, edit (rewrite the body). (bearer required)

Heads-up: this actor only handles comment management. For writing comments (top-level + reply), see Reddit Commenting V2. For voting on comments, see Reddit Voting V2.

---

The 3 actions

The Comment field accepts any of: full URL (https://reddit.com/r/sub/comments/.../comment/ogv9p8c/), stripped ID (ogv9p8c), or t1_ fullname (t1_ogv9p8c).

1. Comment Insights (bearer required)

Pull analytics for a single comment.

Field	Required	Notes
Comment	yes	URL / ID / fullname of the comment to inspect

Returns: comment score, view count, share count, geography breakdown (where viewers came from), engagement metrics, plus the comment's own metadata (author, body, parent post, subreddit, created timestamp).

Reddit only exposes detailed analytics on comments your account can see — works on any visible comment, not just your own.

Example

Input

{
  "operation": "insights",
  "insights_comment": "oix51jd",
  "credentialSource": "vault",
  "accountName": "motor_tip8865"
}

Output (one dataset record; analytics nested under data.commentById)

{
  "success": true,
  "operation": "insights",
  "comment_id": "oix51jd",
  "data": {
    "commentById": {
      "id": "t1_oix51jd",
      "score": 1,
      "upvoteRatio": 100,
      "awardings": [],
      "postInfo": {
        "id": "t3_1syw2sd",
        "title": "test post",
        "subreddit": { "prefixedName": "r/RedCrawlerAPI" }
      },
      "commentStats": {
        "engagementLevel": "NORMAL",
        "viewCountTotals": { "totalCount": 21 },
        "viewsByGeo": {
          "data": [
            { "countryCode": "US", "percent": 0.86 },
            { "countryCode": "CA", "percent": 0.14 }
          ]
        },
        "shareCountTotals": { "totalCount": 0 }
      },
      "authorInfo": {
        "name": "Motor_Tip8865",
        "icon": { "url": "https://www.redditstatic.com/avatars/defaults/v2/avatar_default_6.png" }
      },
      "content": { "preview": "test comment", "richtextMedia": [] },
      "children": {
        "pageInfo": { "commentCount": 1 },
        "trees": []
      }
    }
  },
  "account_name": "motor_tip8865",
  "error": null,
  "bearer_expires_at": "2026-05-14T10:20:54Z",
  "rate_limit": 100,
  "rate_used": 1,
  "rate_remaining": 99,
  "rate_reset_in_seconds": 599
}

2. Linked Comment Info (anonymous)

Fetch the parent post's context for a comment, plus the comment's own structured richtext content. Useful when you have a comment ID and want to know what post it's on without a separate scrape call.

Field	Required	Notes
Comment	yes	URL / ID / fullname of the comment

Returns: parent post (title, author, subreddit, NSFW / spoiler / locked / archived / removed flags), the comment's own richtext content as a structured document, plus the comment's score / created / author.

Use it when: building "this comment is from r/X about Y" preview UIs, hydrating a list of comment IDs with their post context, classifying comments by parent-post topic.

Anonymous — no Reddit account, no Token V2, no proxy required. The credentials section at the bottom is ignored on this action.

Example

Input (anonymous — no credentials)

{
  "operation": "linked_info",
  "linked_info_comment": "oix51jd"
}

Output (parent post context + the comment's richtext)

{
  "success": true,
  "operation": "linked_info",
  "comment_id": "oix51jd",
  "data": {
    "success": true,
    "linked_comment": {
      "commentById": {
        "id": "t1_oix51jd",
        "score": 1,
        "isRemoved": false,
        "postInfo": {
          "id": "t3_1syw2sd",
          "createdAt": "2026-04-29T11:30:10.348000+0000",
          "title": "test post",
          "removedByCategory": null,
          "subreddit": { "type": "PUBLIC", "prefixedName": "r/RedCrawlerAPI" }
        },
        "content": {
          "preview": "test comment",
          "richtext": "{\"document\":[{\"c\":[{\"e\":\"text\",\"t\":\"test comment\"}],\"e\":\"par\"}]}",
          "richtextMedia": []
        },
        "authorInfo": {
          "id": "t2_29onm7dc32",
          "displayName": "Motor_Tip8865",
          "icon": { "url": "https://www.redditstatic.com/avatars/defaults/v2/avatar_default_6.png" }
        }
      }
    }
  },
  "error": null
}

3. Comment State Controls (bearer required)

Apply one of 6 state actions to a comment.

Field	Required	Notes
State action	yes	One of: save, unsave, follow, unfollow, delete, edit
Comment	yes	URL / ID / fullname of the comment to act on
New body text	only for edit	Reddit markdown — **bold**, *italic*, > quote, [link](url), - bullet. Up to 10,000 characters.

Action behavior:

• save / unsave — Reddit's "save for later" on any visible comment (yours or someone else's).
• follow / unfollow — toggle reply notifications for any comment thread you're tracking.
• delete — permanently delete your own comment. Reddit replaces the body with [deleted].
• edit — rewrite the markdown body of your own comment. Reddit shows (edited) after a successful edit.

Save / unsave / follow / unfollow work on any comment. Delete and edit only work on comments your account authored.

Example (save action shown — output shape is identical for unsave / follow / unfollow / delete; for edit, the input includes state_content and the echoed content appears in the output record)

Input

{
  "operation": "state",
  "state_action": "save",
  "state_comment": "oix51jd",
  "credentialSource": "vault",
  "accountName": "motor_tip8865"
}

Output (one dataset record)

{
  "success": true,
  "operation": "state",
  "action": "save",
  "comment_id": "oix51jd",
  "account_name": "motor_tip8865",
  "error": null,
  "bearer_expires_at": "2026-05-14T10:20:54Z",
  "rate_limit": 100,
  "rate_used": 3,
  "rate_remaining": 97,
  "rate_reset_in_seconds": 597
}

---

Credentials

Two of the three actions (Comment Insights, Comment State Controls) need a Reddit Token V2 cookie + the proxy that minted it. Linked Comment Info ignores credentials entirely — leave the section blank for that one.

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.

Credential source

• Use saved account (vault) — pull Token V2 + proxy from the Reddit Vault by name. Only the Saved account name field below matters.
• Paste Token V2 + proxy — fill the Token V2 + proxy fields directly. The saved-account-name field is ignored.

Saved account name (vault path)

The label you used when running Reddit Vault → STORE. Lowercase, 1–32 chars, letters/digits/-/_.

Token V2 (manual path)

Your token_v2 cookie value (eyJ…). Encrypted by Apify at rest (isSecret: true). Lifetime: ~24 h.

Proxy (manual path)

ip:port:user:pass. Must be the IP that minted the Token V2 — Reddit IP-binds these cookies.

---

Output

Every run pushes exactly one record to the run's default dataset. The shape is shared across actions, with action-specific fields filled where relevant. Per-action captured examples live under each section above — this section is the column reference.

Column	Meaning
success	true if the action landed on Reddit, false otherwise
operation	Which action ran (insights / linked_info / state)
action	(state only) save / unsave / follow / unfollow / delete / edit
comment_id	The comment ID / fullname you submitted (echoed back)
data	Action payload — analytics tree for insights, parent-post + richtext for linked_info
content	(edit only) The new markdown body that was applied
account_name	(bearer endpoints, vault only) The saved account name used
error	null on success; human-readable string on failure
error_kind	(failures) bearer_expired, rate_limited, permission_denied, USER_REQUIRED, THREAD_LOCKED, etc.
bearer_expires_at / bearer_expired_at	(bearer endpoints) Token V2 lifecycle info
rate_limit / rate_used / rate_remaining / rate_reset_in_seconds	(bearer endpoints) Reddit's rate-limit headers — surfaces how close you are to a 429. Linked Comment Info is anonymous and skips these.

Failure record (example)

{
  "success": false,
  "operation": "state",
  "action": "delete",
  "comment_id": "t1_ogv9p8c",
  "account_name": "motor_tip8865",
  "error": "You can't delete a comment you don't own.",
  "error_kind": "USER_REQUIRED"
}

---

Common edge cases

Edge case	Cause	How it surfaces
Token V2 expired	Cookie older than ~24 h	Row with success:false, error:"bearer_expired" and bearer_expired_at. Re-paste — or use the vault for auto-refresh.
Wrong proxy for the bearer	Token V2 minted on a different IP	Row with success:false, error:"…IP mismatch / forbidden…". Pass the matching proxy or use the vault (stores them as a pair).
USER_REQUIRED / permission denied	Delete / edit needs you to own the comment, and this account doesn't	Row with success:false, error_kind:"USER_REQUIRED". Use the right account.
THREAD_LOCKED	Comment thread is locked — edits / deletes / follows can fail	Row with success:false, error_kind:"THREAD_LOCKED". Wait for the mods to unlock it.
Comment not found	Deleted, removed, or never existed	Row with success:false, error:"Comment not found". Reddit returns the same shape for deleted vs nonexistent.
Insights on a comment you didn't author	Works on any visible comment	Reddit shows the analytics to any logged-in viewer with rights to see the comment.
Linked Info on a removed comment	Comment was removed by mods or the author	Still returns parent-post context; the comment's own body comes back redacted. removed / locked flags will be set.
Rate limited	Per-account write throttle hit	Row with success:false, error:"rate_limited" + rate_reset_in_seconds. Wait and retry — the rate_remaining field shows how many calls are left in the window.
Follow / unfollow vs save / unsave	They are independent toggles	"follow" toggles reply notifications for that thread; "save" puts the comment in your saved-items list. Toggle them separately.
Anonymous action ignores credentials	Linked Comment Info is unauthenticated	Any vault name / Token V2 / proxy you pass is ignored for that action.
Empty Comment field	Required field missing	Run FAILED immediately, no row pushed, no charge.

---

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. Some or zero records pushed.	Open the dataset to view results.
	"The Actor process failed…"	Validation error or upstream Reddit fault.	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 its timeout.	Re-run; consider narrowing inputs.
	"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)

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 Reddit Session for refresh.	Run SUCCEEDED, failure row, no Reddit call made.
Bearer minted on a different IP	Saved Token V2's IP doesn't match the saved proxy.	Run SUCCEEDED, failure row.
DELETED_COMMENT	Target comment was deleted by its author.	Run SUCCEEDED, failure row with error_kind.
SUBREDDIT_NOTALLOWED	Account is banned, muted, or restricted in the subreddit.	Run SUCCEEDED, failure row.
Validation error: missing required field	Required input not provided.	Run FAILED immediately, no charge.

---

Need a different shape of data?

• Reddit Vault — save Reddit accounts once, call them by name from this actor (free)
• Reddit Commenting V2 — write top-level comments + replies (with optional inline image / GIF)
• Reddit Voting V2 — upvote / downvote / clear vote on any post or comment
• Reddit Posting V2 — create text / link / image / gallery / video / GIF / crosspost / poll posts
• Reddit Posts & Feeds V2 — home feed + post state controls
• Reddit Bulk Scrape V2 — bulk lookups by ID (up to 1500 per run)

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

---

Why this actor is fast

• Speed — 1–3 seconds per call. Pure HTTP to Reddit's API. 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. Built for reliability behind the scenes — just paste your inputs and run.

---

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 action — insights, linked_info, state — is one row, one charge.

---

Support and feedback

Found a bug, want a feature, 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 Manage Comments V2 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.