# Reddit Manage Comments V2 — Insights, Linked Info, State (`red_crawler/reddit-manage-comments-v2`) Actor
Pull Reddit comment analytics, fetch parent-post context, or run state controls (save, follow, delete, edit) — three actions in one actor.
- **URL**: https://apify.com/red\_crawler/reddit-manage-comments-v2.md
- **Developed by:** [Red Crawler](https://apify.com/red_crawler) (community)
- **Categories:** Lead generation, SEO tools, Social media
- **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet
## Pricing
from $1.99 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## 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**
```json
{
"operation": "insights",
"insights_comment": "oix51jd",
"credentialSource": "vault",
"accountName": "motor_tip8865"
}
````
**Output** *(one dataset record; analytics nested under `data.commentById`)*
```json
{
"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)*
```json
{
"operation": "linked_info",
"linked_info_comment": "oix51jd"
}
```
**Output** *(parent post context + the comment's richtext)*
```json
{
"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**
```json
{
"operation": "state",
"state_action": "save",
"state_comment": "oix51jd",
"credentialSource": "vault",
"accountName": "motor_tip8865"
}
```
**Output** *(one dataset record)*
```json
{
"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](https://apify.com/red_crawler/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)
```json
{
"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](https://apify.com/red_crawler/reddit-vault)** — save Reddit accounts once, call them by name from this actor (free)
- **[Reddit Commenting V2](https://apify.com/red_crawler/reddit-commenting-v2)** — write top-level comments + replies (with optional inline image / GIF)
- **[Reddit Voting V2](https://apify.com/red_crawler/reddit-voting-v2)** — upvote / downvote / clear vote on any post or comment
- **[Reddit Posting V2](https://apify.com/red_crawler/reddit-posting-v2)** — create text / link / image / gallery / video / GIF / crosspost / poll posts
- **[Reddit Posts & Feeds V2](https://apify.com/red_crawler/reddit-posts-feeds-v2)** — home feed + post state controls
- **[Reddit Bulk Scrape V2](https://apify.com/red_crawler/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.*
# Actor input Schema
## `operation` (type: `string`):
Pick the action to perform. Each action has its own dedicated section below — only fill the one matching your choice.
## `insights_comment` (type: `string`):
Comment to fetch insights for — paste the URL, the stripped ID (`ogg304q`), or the `t1_`-prefixed fullname (`t1_ogg304q`).
## `linked_info_comment` (type: `string`):
Comment to fetch linked info for — paste the URL, the stripped ID, or the `t1_`-prefixed fullname.
## `state_action` (type: `string`):
Action to apply to the comment.
## `state_comment` (type: `string`):
Comment to act on — paste the URL, the stripped ID, or the `t1_`-prefixed fullname. Save / follow work on any comment; delete + edit only work on comments your account owns.
## `state_content` (type: `string`):
Replacement comment body — Reddit markdown supported (`**bold**`, `*italic*`, `> quote`, `[link](url)`, `- bullet`). Only used when 'State action' = 'Edit body'.
## `credentialSource` (type: `string`):
Pick which authentication path this run uses. **Use saved account (vault)** loads your stored Token V2 + proxy from the **reddit-vault** actor (auto-refreshed if you saved a Reddit Session) — only the 'Saved account name' field below is used; Token V2 + proxy are ignored. **Paste Token V2 + proxy** uses the values you paste below — the 'Saved account name' field is ignored. Skip this section entirely if you picked 'Linked Comment Info' (anonymous).
## `accountName` (type: `string`):
The name you used in the **reddit-vault** actor when you stored this account. Your Token V2 + proxy load automatically from the vault. Ignored when 'Credential source' = manual.
## `bearer` (type: `string`):
Your Reddit `token_v2` cookie value (`eyJ...`). Lifetime ~24 h. Encrypted at rest by Apify. Ignored when 'Credential source' = vault.
## `proxy` (type: `string`):
Proxy in `ip:port:user:pass` format. MUST be the same IP that originally minted the Token V2. Ignored when 'Credential source' = vault.
## Actor input object example
```json
{
"operation": "insights",
"state_action": "save",
"credentialSource": "vault"
}
```
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {};
// Run the Actor and wait for it to finish
const run = await client.actor("red_crawler/reddit-manage-comments-v2").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {}
# Run the Actor and wait for it to finish
run = client.actor("red_crawler/reddit-manage-comments-v2").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{}' |
apify call red_crawler/reddit-manage-comments-v2 --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=red_crawler/reddit-manage-comments-v2",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Reddit Manage Comments V2 — Insights, Linked Info, State",
"description": "Pull Reddit comment analytics, fetch parent-post context, or run state controls (save, follow, delete, edit) — three actions in one actor.",
"version": "0.7",
"x-build-id": "waIw1kcuxAFleemW1"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/red_crawler~reddit-manage-comments-v2/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-red_crawler-reddit-manage-comments-v2",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/red_crawler~reddit-manage-comments-v2/runs": {
"post": {
"operationId": "runs-sync-red_crawler-reddit-manage-comments-v2",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/red_crawler~reddit-manage-comments-v2/run-sync": {
"post": {
"operationId": "run-sync-red_crawler-reddit-manage-comments-v2",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"required": [
"operation"
],
"properties": {
"operation": {
"title": "Action",
"enum": [
"insights",
"linked_info",
"state"
],
"type": "string",
"description": "Pick the action to perform. Each action has its own dedicated section below — only fill the one matching your choice.",
"default": "insights"
},
"insights_comment": {
"title": "Comment",
"type": "string",
"description": "Comment to fetch insights for — paste the URL, the stripped ID (`ogg304q`), or the `t1_`-prefixed fullname (`t1_ogg304q`)."
},
"linked_info_comment": {
"title": "Comment",
"type": "string",
"description": "Comment to fetch linked info for — paste the URL, the stripped ID, or the `t1_`-prefixed fullname."
},
"state_action": {
"title": "State action",
"enum": [
"save",
"unsave",
"follow",
"unfollow",
"delete",
"edit"
],
"type": "string",
"description": "Action to apply to the comment.",
"default": "save"
},
"state_comment": {
"title": "Comment",
"type": "string",
"description": "Comment to act on — paste the URL, the stripped ID, or the `t1_`-prefixed fullname. Save / follow work on any comment; delete + edit only work on comments your account owns."
},
"state_content": {
"title": "New body text (only for 'Edit body')",
"maxLength": 10000,
"type": "string",
"description": "Replacement comment body — Reddit markdown supported (`**bold**`, `*italic*`, `> quote`, `[link](url)`, `- bullet`). Only used when 'State action' = 'Edit body'."
},
"credentialSource": {
"title": "Credential source",
"enum": [
"vault",
"manual"
],
"type": "string",
"description": "Pick which authentication path this run uses. **Use saved account (vault)** loads your stored Token V2 + proxy from the **reddit-vault** actor (auto-refreshed if you saved a Reddit Session) — only the 'Saved account name' field below is used; Token V2 + proxy are ignored. **Paste Token V2 + proxy** uses the values you paste below — the 'Saved account name' field is ignored. Skip this section entirely if you picked 'Linked Comment Info' (anonymous).",
"default": "vault"
},
"accountName": {
"title": "Saved account name (used when source = vault)",
"pattern": "^[A-Za-z0-9_-]{1,32}$",
"maxLength": 32,
"type": "string",
"description": "The name you used in the **reddit-vault** actor when you stored this account. Your Token V2 + proxy load automatically from the vault. Ignored when 'Credential source' = manual."
},
"bearer": {
"title": "Token V2 (used when source = manual)",
"type": "string",
"description": "Your Reddit `token_v2` cookie value (`eyJ...`). Lifetime ~24 h. Encrypted at rest by Apify. Ignored when 'Credential source' = vault."
},
"proxy": {
"title": "Proxy (used when source = manual)",
"type": "string",
"description": "Proxy in `ip:port:user:pass` format. MUST be the same IP that originally minted the Token V2. Ignored when 'Credential source' = vault."
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```