# Reddit Commenting V1 — Create, Reply, Edit (`red_crawler/reddit-commenting-v1`) Actor
Write Reddit comments in one click — create a top-level comment on a post, reply to an existing comment, or edit your own comment's body. Bring your Reddit Token V2 (token\_v2 cookie) + matching proxy, or pick a saved account from the Reddit Vault.
- **URL**: https://apify.com/red\_crawler/reddit-commenting-v1.md
- **Developed by:** [Red Crawler](https://apify.com/red_crawler) (community)
- **Categories:** Lead generation, Social media, SEO tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet
## Pricing
$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 Commenting V1
   
Three self-contained commenting actions — **write a top-level comment on a post**, **reply to an existing comment**, or **edit your own comment's body**. One run = one action = 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, write the body, 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 **Parent comment** / **Comment** fields accept: full URL, stripped ID (`ogv9p8c`), or `t1_` fullname (`t1_ogv9p8c`).
Reddit markdown is supported in every `text` field — `**bold**`, `*italic*`, `> quote`, `[link](url)`, `- bullet`, fenced code, tables.
#### All actions (Reddit account required)
##### 1. Create Comment — write a top-level comment on a post
Adds a new top-level comment to a Reddit post.
**Input:** post target (URL / ID / fullname) + comment body (markdown, up to 10,000 chars).
**Returns:** echoed action + post + truncated text + account name + error info (null on success) + bearer expiry + live per-account rate-limit counters.
**Use it when:** publishing articles / blog posts to relevant subreddits, programmatic engagement on your own posts, scheduled community announcements, AMA seed comments, customer-support replies in product subreddits, marketing automation.
**Example**
**Input**
```json
{
"operation": "create",
"create_post": "https://www.reddit.com/r/Wordpress/comments/1s4a4j6/",
"create_text": "Great rundown — I went through the same migration last month and would add: **back up your `wp_options` table before swapping URLs**. Saved me twice.",
"credentialSource": "vault",
"accountName": "motor_tip8865"
}
````
**Output** *(one dataset record)*
```json
{
"success": true,
"operation": "create",
"post": "https://www.reddit.com/r/Wordpress/comments/1s4a4j6/",
"text": "Great rundown — I went through the same migration last month and would add: **back up your `wp_options` table before swapping URLs**. Saved me twice.",
"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. Reply to Comment — reply to an existing comment
Adds a reply under an existing comment in any post's comment tree.
**Input:** parent comment target (URL / ID / fullname) + reply body (markdown, up to 10,000 chars).
**Returns:** echoed action + parent comment + truncated text + account name + error info + bearer expiry + rate-limit counters.
**Use it when:** automated thread engagement, customer-support replies under FAQs, scheduled follow-ups, AMA participant replies, community-management bots.
**Example**
**Input**
```json
{
"operation": "reply",
"reply_comment": "t1_n0c3kh8",
"reply_text": "Agreed — and if you're on multisite, **don't forget the per-site `home`/`siteurl` overrides** in `wp_X_options` for each subsite.",
"credentialSource": "vault",
"accountName": "motor_tip8865"
}
```
**Output** *(one dataset record)*
```json
{
"success": true,
"operation": "reply",
"comment": "t1_n0c3kh8",
"text": "Agreed — and if you're on multisite, **don't forget the per-site `home`/`siteurl` overrides** in `wp_X_options` for each subsite.",
"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
}
```
##### 3. Edit Comment — replace your own comment's body
Replaces the body text of one of your own comments. Only works on comments your account authored.
**Input:** comment target (URL / ID / fullname) + replacement body (markdown, up to 10,000 chars).
**Returns:** echoed action + comment + truncated text + account name + error info + bearer expiry + rate-limit counters.
**Use it when:** correcting typos at scale, prepending an `EDIT:` block with new info, updating answers in long-running threads, AMA host follow-ups.
**Example**
**Input**
```json
{
"operation": "edit",
"edit_comment": "t1_n0c3kh8",
"edit_text": "**EDIT 2026-05-14:** the WP 6.6 release fixed this — ignore my original advice.\n\nOriginal: back up your `wp_options` table before swapping URLs.",
"credentialSource": "vault",
"accountName": "motor_tip8865"
}
```
**Output** *(one dataset record)*
```json
{
"success": true,
"operation": "edit",
"comment": "t1_n0c3kh8",
"text": "**EDIT 2026-05-14:** the WP 6.6 release fixed this — ignore my original advice.",
"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
All 3 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](https://apify.com/red_crawler/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** → `Create Comment`, `Reply to Comment`, or `Edit Comment`.
2. Fill the matching section (only the chosen action's section matters — the others are ignored).
3. Pick a **Credential source** and fill the matching vault or manual fields.
4. Hit **Start**. One run = one comment action = 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 action, `false` otherwise |
| `operation` | `create`, `reply`, or `edit` |
| `comment` | The comment target you supplied (reply / edit actions) |
| `post` | The post target you supplied (create action) |
| `text` | First 200 characters of the body you sent (echoed for traceability) |
| `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`, `BANNED`, `SHADOWBAN`, `NOT_OWNER`, …), `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 |
> Need the new comment's ID / permalink in the output? Use **[Reddit Commenting V2](https://apify.com/red_crawler/reddit-commenting-v2)** — same actions, richer success record (`comment_id`, `permalink`, parent fullname), plus optional inline images and GIFs.
***
### 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 locked | Mod has locked the post / comment — no new replies accepted | Row with `success: false`, `error_kind: THREAD_LOCKED`. Pick a different target. |
| Thread archived | Posts older than 6 months — Reddit no longer accepts comments | Row with `success: false`, `error_kind: THREAD_ARCHIVED`. Pick a non-archived 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. |
| Subreddit private / quarantined | Your account doesn't have access (or hasn't accepted the quarantine prompt) | Row with `success: false`, `error_kind: FORBIDDEN` or `QUARANTINED`. |
| 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. |
| Comment shadowbanned | Reddit accepts the comment silently but doesn't show it to other users (anti-spam shadowing on new / low-karma accounts) | Row with `success: true` — comment is in the dataset but may not appear publicly. Warm the account up before automating. |
| Not your comment (edit) | The comment belongs to a different account | Row with `success: false`, `error_kind: NOT_OWNER`. |
| Empty body | Forgot to paste comment / reply text | Run `FAILED` immediately, no row pushed, no charge. |
| Missing required input | Forgot to paste the post / comment URL | Run `FAILED` immediately, no row pushed, no charge. |
***
### Why this actor is fast
- **Speed — 1–3 seconds per action, 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. Built for reliability behind the scenes — just paste your inputs and run.
***
### 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 — comments 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 new replies. | Run `SUCCEEDED`, failure row with `error_kind: THREAD_LOCKED` or `THREAD_ARCHIVED`. |
| Subreddit ban / quarantine | Account doesn't have write access to the community. | Run `SUCCEEDED`, failure row with `error_kind: BANNED` or `QUARANTINED`. |
| `NOT_OWNER` (edit) | The comment isn't yours. | Run `SUCCEEDED`, failure row with `error_kind: NOT_OWNER`. |
| Validation error: missing target / body | 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 comment — create, reply, or edit — is one row, one 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)** — newer version: returns `comment_id` + `permalink` on success, supports inline images / GIFs
- **[Reddit Manage Comments V2](https://apify.com/red_crawler/reddit-manage-comments-v2)** — Comment Insights, Linked Comment Info, save / unsave / follow / unfollow / delete / edit
- **[Reddit Voting V2](https://apify.com/red_crawler/reddit-voting-v2)** — upvote / downvote / clear your vote on posts and comments
- **[Reddit Posting V2](https://apify.com/red_crawler/reddit-posting-v2)** — create text / link / image / gallery / video / GIF / crosspost / poll posts
- **[Reddit Post Manager V1](https://apify.com/red_crawler/reddit-manage-posts-v1)** — edit / delete / save / flair / lock / NSFW / spoiler / hide / report your posts
- **[Reddit Posts & Feeds V2](https://apify.com/red_crawler/reddit-posts-feeds-v2)** — home feed + post state controls
- **[Reddit Subreddits](https://apify.com/red_crawler/reddit-subreddits)** — info, browse, join / leave, create
- **[Reddit Users V1](https://apify.com/red_crawler/reddit-users)** — 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 Commenting 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.*
# 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. The 'Reddit credentials' section at the bottom is shared.
## `create_post` (type: `string`):
Post to comment on — paste the URL, the stripped ID, or the t3\_-prefixed fullname.
## `create_text` (type: `string`):
Comment body — Reddit markdown supported (`**bold**`, `*italic*`, `> quote`, `[link](url)`, `- bullet`).
## `reply_comment` (type: `string`):
Comment to reply to — paste the URL, the stripped ID, or the t1\_-prefixed fullname.
## `reply_text` (type: `string`):
Reply body — Reddit markdown supported (`**bold**`, `*italic*`, `> quote`, `[link](url)`, `- bullet`).
## `edit_comment` (type: `string`):
Your comment — paste the URL, the stripped ID, or the t1\_-prefixed fullname. You can only edit comments your account authored.
## `edit_text` (type: `string`):
Replacement comment body — Reddit markdown supported (`**bold**`, `*italic*`, `> quote`, `[link](url)`, `- bullet`).
## `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.
## `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": "create",
"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-commenting-v1").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-commenting-v1").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-commenting-v1 --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=red_crawler/reddit-commenting-v1",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Reddit Commenting V1 — Create, Reply, Edit",
"description": "Write Reddit comments in one click — create a top-level comment on a post, reply to an existing comment, or edit your own comment's body. Bring your Reddit Token V2 (token_v2 cookie) + matching proxy, or pick a saved account from the Reddit Vault.",
"version": "0.5",
"x-build-id": "Vkhgi8mLJH40Tb1wM"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/red_crawler~reddit-commenting-v1/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-red_crawler-reddit-commenting-v1",
"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-commenting-v1/runs": {
"post": {
"operationId": "runs-sync-red_crawler-reddit-commenting-v1",
"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-commenting-v1/run-sync": {
"post": {
"operationId": "run-sync-red_crawler-reddit-commenting-v1",
"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",
"credentialSource"
],
"properties": {
"operation": {
"title": "Action",
"enum": [
"create",
"reply",
"edit"
],
"type": "string",
"description": "Pick the action to perform. Each action has its own dedicated section below — only fill the one matching your choice. The 'Reddit credentials' section at the bottom is shared.",
"default": "create"
},
"create_post": {
"title": "Post",
"type": "string",
"description": "Post to comment on — paste the URL, the stripped ID, or the t3_-prefixed fullname."
},
"create_text": {
"title": "Comment text",
"maxLength": 10000,
"type": "string",
"description": "Comment body — Reddit markdown supported (`**bold**`, `*italic*`, `> quote`, `[link](url)`, `- bullet`)."
},
"reply_comment": {
"title": "Parent comment",
"type": "string",
"description": "Comment to reply to — paste the URL, the stripped ID, or the t1_-prefixed fullname."
},
"reply_text": {
"title": "Reply text",
"maxLength": 10000,
"type": "string",
"description": "Reply body — Reddit markdown supported (`**bold**`, `*italic*`, `> quote`, `[link](url)`, `- bullet`)."
},
"edit_comment": {
"title": "Comment",
"type": "string",
"description": "Your comment — paste the URL, the stripped ID, or the t1_-prefixed fullname. You can only edit comments your account authored."
},
"edit_text": {
"title": "New body text",
"maxLength": 10000,
"type": "string",
"description": "Replacement comment body — Reddit markdown supported (`**bold**`, `*italic*`, `> quote`, `[link](url)`, `- bullet`)."
},
"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.",
"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
}
}
}
}
}
}
}
}
}
}
```