# Reddit Post Manager V1 — Edit,Delete,Save,Flair,Lock,NSFW (`red_crawler/reddit-manage-posts-v1`) Actor Manage your own Reddit posts in one click — report, lock comments, mark NSFW or spoiler, hide, save, edit body text, set or clear flair, toggle reply notifications, or delete. 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-manage-posts-v1.md - **Developed by:** [Red Crawler](https://apify.com/red_crawler) (community) - **Categories:** SEO tools, Social media, Integrations - **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 Post Manager V1 ![Endpoints](https://img.shields.io/badge/actions-10-blue) ![Auth](https://img.shields.io/badge/Reddit_account-required-orange) ![Proxy](https://img.shields.io/badge/proxy-required-orange) ![Pricing](https://img.shields.io/badge/pricing-pay_per_result-orange) Manage your own Reddit posts in one click — **10 self-contained actions**: edit body text, delete, save / unsave, set / clear flair, lock / unlock comments, mark / unmark NSFW, mark / unmark spoiler, hide / unhide, report, and toggle reply notifications. 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 post, hit Start. --- ### What you can do The **Post** field on every action accepts: full URL (`https://www.reddit.com/r/sub/comments/1sys4r2/...`), stripped ID (`1sys4r2`), or `t3_` fullname (`t3_1sys4r2`). You can only manage posts your account is allowed to manage: - **Edit / delete / save / hide / send-replies** — your own posts. - **Lock / NSFW / spoiler / flair** — your own posts in some communities, OR any post in a subreddit where your account is a moderator. - **Report** — any visible post. All 10 actions (Reddit account required): ##### 1. Edit post body — replace your self-post's text Replaces the body markdown of your text post. Only self-posts (text posts) can be edited — link / image / video / gallery / poll posts cannot. **Input:** post target (URL / ID / fullname) + new body text (markdown, up to 40,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:** updating launch posts with new info (`EDIT 2: shipped!`), correcting typos at scale, refreshing weekly-thread bodies on a schedule, AMA host edits. **Example** **Input** ```json { "operation": "edit", "edit_post": "https://www.reddit.com/r/test/comments/1tc6ncq/", "edit_text": "**EDIT 2026-05-14:** shipped — thanks for the feedback. Original body below.\n\nOriginal: which language should I learn next?", "credentialSource": "vault", "accountName": "motor_tip8865" } ```` **Output** *(one dataset record)* ```json { "success": true, "operation": "edit", "post": "https://www.reddit.com/r/test/comments/1tc6ncq/", "text": "**EDIT 2026-05-14:** shipped — thanks for the feedback. Original body below.", "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. Delete a post — permanent removal Permanently deletes one of your own posts. Cannot be undone. **Input:** post target. **Returns:** echoed action + post + account name + error info + bearer expiry + rate-limit counters. **Use it when:** taking down an outdated launch post, cleaning your history, removing a duplicate after a misfire. **Example** **Input** ```json { "operation": "delete", "delete_post": "t3_1tc6ncq", "credentialSource": "vault", "accountName": "motor_tip8865" } ``` **Output** *(one dataset record)* ```json { "success": true, "operation": "delete", "post": "t3_1tc6ncq", "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. Save / unsave — toggle a post in your Saved tab Adds or removes a post from your account's **Saved** tab. **Input:** post target + state (`true` = save, `false` = unsave). **Returns:** echoed action + post + state + account name + error info + rate-limit counters. **Use it when:** bookmarking content for later, building a "read later" pipeline, removing items from saved in bulk. **Example** **Input** ```json { "operation": "save", "save_post": "https://www.reddit.com/r/Wordpress/comments/1s4a4j6/", "save_state": true, "credentialSource": "vault", "accountName": "motor_tip8865" } ``` **Output** *(one dataset record)* ```json { "success": true, "operation": "save", "post": "https://www.reddit.com/r/Wordpress/comments/1s4a4j6/", "state": true, "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 } ``` ##### 4. Set / clear flair — apply or remove a post flair Adds, edits, or removes the flair on a post. **Input:** post target + subreddit name + flair action (`add` / `edit` / `remove`) + Flair ID (required for add / edit) + optional flair text. **Returns:** echoed action + post + subreddit + action + flair fields + account name + error info + rate-limit counters. **Use it when:** post-publish flair enforcement, weekly thread flair rotation, bulk re-flair after a subreddit's flair template overhaul. > Flair IDs come from the subreddit's available flair templates. Fetch them once and reuse — they're stable IDs. **Example** **Input** ```json { "operation": "flair", "flair_post": "t3_1s4a4j6", "flair_subreddit": "Wordpress", "flair_action": "add", "flair_id": "0269a28a-4553-11f0-8a14-8246a3a6560d", "flair_text": "Discussion", "credentialSource": "vault", "accountName": "motor_tip8865" } ``` **Output** *(one dataset record)* ```json { "success": true, "operation": "flair", "post": "t3_1s4a4j6", "subreddit": "Wordpress", "action": "add", "flair_id": "0269a28a-4553-11f0-8a14-8246a3a6560d", "flair_text": "Discussion", "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 } ``` ##### 5. Lock / unlock comments — close or re-open the comment thread Locks a post (no new comments accepted) or unlocks it. Only works on your own posts in some communities, or any post where your account is a mod. **Input:** post target + state (`true` = lock, `false` = unlock). **Returns:** echoed action + post + state + account name + error info + rate-limit counters. **Use it when:** stopping comment pile-ons after a controversy, closing time-bounded AMA threads, mod automation for stale megathreads. **Example** **Input** ```json { "operation": "lock", "lock_post": "t3_1tc6ncq", "lock_state": true, "credentialSource": "vault", "accountName": "motor_tip8865" } ``` **Output** *(one dataset record)* ```json { "success": true, "operation": "lock", "post": "t3_1tc6ncq", "state": true, "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 } ``` ##### 6. Mark / unmark NSFW — toggle the NSFW flag Marks a post as Not Safe For Work, or removes the NSFW flag. **Input:** post target + state. **Returns:** echoed action + post + state + account name + error info + rate-limit counters. **Use it when:** post-classification NSFW tagging, compliance sweeps, mod automation. **Example** **Input** ```json { "operation": "nsfw", "nsfw_post": "t3_1tc6ncq", "nsfw_state": true, "credentialSource": "vault", "accountName": "motor_tip8865" } ``` **Output** *(one dataset record)* ```json { "success": true, "operation": "nsfw", "post": "t3_1tc6ncq", "state": true, "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 } ``` ##### 7. Mark / unmark spoiler — toggle the spoiler flag Marks a post as a spoiler, or clears the spoiler flag. **Input:** post target + state. **Returns:** echoed action + post + state + account name + error info + rate-limit counters. **Use it when:** episodic-content subreddits, theatrical-release subs, hiding plot details on book / TV / game discussion posts. **Example** **Input** ```json { "operation": "spoiler", "spoiler_post": "t3_1tc6ncq", "spoiler_state": true, "credentialSource": "vault", "accountName": "motor_tip8865" } ``` **Output** *(one dataset record)* ```json { "success": true, "operation": "spoiler", "post": "t3_1tc6ncq", "state": true, "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 } ``` ##### 8. Hide / unhide — remove from your feeds Hides a post from your home / subreddit feeds (still exists on Reddit), or shows it again. **Input:** post target + state (`true` = hide, `false` = unhide). **Returns:** echoed action + post + state + account name + error info + rate-limit counters. **Use it when:** programmatic feed cleanup, hiding suggested promoted content in bulk, decluttering your home feed. **Example** **Input** ```json { "operation": "hide", "hide_post": "t3_1tc6ncq", "hide_state": true, "credentialSource": "vault", "accountName": "motor_tip8865" } ``` **Output** *(one dataset record)* ```json { "success": true, "operation": "hide", "post": "t3_1tc6ncq", "state": true, "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 } ``` ##### 9. Report a post — flag for moderation Reports a post for a site-wide rule violation. **Input:** post target + reason (free text or rule key like `spam`, `harassment`, `dis_misinformation`, `violent_content`, `targeted_harassment`). **Returns:** echoed action + post + reason + account name + error info + rate-limit counters. **Use it when:** flagging spam / harassment in bulk, automated mod-queue tooling for communities you mod, anti-abuse pipelines. **Example** **Input** ```json { "operation": "report", "report_post": "t3_1tc6ncq", "report_reason": "spam", "credentialSource": "vault", "accountName": "motor_tip8865" } ``` **Output** *(one dataset record)* ```json { "success": true, "operation": "report", "post": "t3_1tc6ncq", "reason": "spam", "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 } ``` ##### 10. Toggle reply notifications — silence or unsilence replies on your post Toggles whether your inbox is notified when someone replies to your post. **Input:** post target + state (`true` = receive notifications, `false` = silence). **Returns:** echoed action + post + state + account name + error info + rate-limit counters. **Use it when:** silencing noisy launch posts that are flooding your inbox, re-enabling notifications on stale posts you want to monitor again. **Example** **Input** ```json { "operation": "sendreplies", "sendreplies_post": "t3_1tc6ncq", "sendreplies_state": false, "credentialSource": "vault", "accountName": "motor_tip8865" } ``` **Output** *(one dataset record)* ```json { "success": true, "operation": "sendreplies", "post": "t3_1tc6ncq", "state": false, "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 10 actions sign in as your 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. > > ![Token V2 cookie in DevTools](https://docs.redcrawler.com/img/credentials/token-v2-cookie.jpg) > > ![Reddit Session cookie in DevTools](https://docs.redcrawler.com/img/credentials/reddit-session-cookie.jpg) #### 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** → pick one of the 10 actions from the dropdown. 2. Fill the matching section (only the chosen action's section matters — the rest are ignored). 3. Pick a **Credential source** and fill the matching vault or manual fields. 4. Hit **Start**. One run = one 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` | One of `edit / delete / save / flair / lock / nsfw / spoiler / hide / report / sendreplies` | | `post` | The post target you supplied (URL, ID, or fullname — passed through) | | `subreddit` | Subreddit name (flair action only) | | `state` | Boolean toggle echoed back (save / lock / nsfw / spoiler / hide / sendreplies) | | `action` | Flair action echoed (`add` / `edit` / `remove`) | | `reason` / `text` / `flair_id` / `flair_text` | Action-specific echoes (truncated to 200 chars for body text) | | `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`, `NOT_OWNER`, `NOT_MOD`, `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. | | Not your post (edit / delete / sendreplies) | The post belongs to a different account | Row with `success: false`, `error_kind: NOT_OWNER`. | | Not a self-post (edit) | You're trying to edit a link / image / video / poll post | Row with `success: false`, `error_kind: NOT_EDITABLE`. Only text posts can be edited. | | Not a mod (lock / nsfw / spoiler / flair) | Your account isn't a mod of that subreddit AND it isn't your own post | Row with `success: false`, `error_kind: NOT_MOD`. | | Post not found / deleted | Post ID is wrong, has been removed by Reddit, or never existed | Row with `success: false`, `error_kind: NOT_FOUND`. | | 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. | | Invalid flair ID | Flair ID doesn't exist in the subreddit's flair templates | Row with `success: false`, `error_kind: INVALID_FLAIR`. Re-fetch flair templates and use a valid ID. | | Missing required input | Forgot to paste the post URL / new body text / flair ID | 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. - **One actor for ten actions.** No need to chain ten different actors — pick the action from a dropdown and go. *** ### Status & error reference **Run status** *(Apify-side, shown on the run page)* | Status | Apify message | Meaning | What to do | |---|---|---|---| | Succeeded | "Actor succeeded with N results in the dataset" | Run finished, one record pushed. | Open the dataset to view the result. | | Failed | "The Actor process failed…" | Validation error or missing required input. | Check the run log. You are NOT charged for failed runs. | | Timed out | "The Actor timed out. You can resurrect it with a longer timeout to continue where you left off." | Run exceeded timeout (rare — actions are fast). | Re-run; check proxy is reachable. | | Aborted | "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`. | | `NOT_OWNER` / `NOT_MOD` | Your account isn't authorized to manage that post. | Run `SUCCEEDED`, failure row with the matching `error_kind`. | | `NOT_FOUND` | Post ID is wrong, removed, or never existed. | Run `SUCCEEDED`, failure row with `error_kind: NOT_FOUND`. | | Validation error: missing post / body / flair ID | 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 action — edit, delete, save, flair, lock, NSFW, spoiler, hide, report, sendreplies — 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 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 Commenting V2](https://apify.com/red_crawler/reddit-commenting-v2)** — write a top-level comment or reply - **[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 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 Post Manager 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 on a post. Each action has its own dedicated section below — only fill the one matching your choice. The 'Reddit credentials' section at the bottom is shared. ## `edit_post` (type: `string`): Your self-post — paste the URL, the stripped ID, or the t3\_-prefixed fullname. Only self-posts (text posts) can be edited; link / image / video / gallery / poll posts cannot. ## `edit_text` (type: `string`): Replacement body text — Reddit markdown supported (`**bold**`, `*italic*`, `> quote`, `[link](url)`, `- bullet`). ## `delete_post` (type: `string`): Your post — paste the URL, the stripped ID, or the t3\_-prefixed fullname. Deletion is permanent and only works on posts you own. ## `save_post` (type: `string`): Post to save or unsave — paste the URL, the stripped ID, or the t3\_-prefixed fullname. ## `save_state` (type: `boolean`): On = save the post to your account's `Saved` tab. Off = remove from saved. ## `flair_post` (type: `string`): Post to flair — paste the URL, the stripped ID, or the t3\_-prefixed fullname. The post must already exist in the subreddit you specify. ## `flair_subreddit` (type: `string`): Subreddit the post lives in (name only, with or without 'r/'). ## `flair_action` (type: `string`): `add` / `edit` apply a flair (require Flair ID). `remove` clears the post's flair. ## `flair_id` (type: `string`): Flair template ID. Required for `add` / `edit`. Ignored for `remove`. Get the ID from the subreddit's available flair templates. ## `flair_text` (type: `string`): Optional flair display text. Some flair templates allow custom text; others are fixed. Ignored for `remove`. ## `lock_post` (type: `string`): Post to lock or unlock — paste the URL, the stripped ID, or the t3\_-prefixed fullname. Only works on posts in a subreddit where your account is a moderator (or your own posts in some communities). ## `lock_state` (type: `boolean`): On = lock the post (no new comments). Off = unlock the post. ## `nsfw_post` (type: `string`): Post to mark or unmark as NSFW — paste the URL, the stripped ID, or the t3\_-prefixed fullname. ## `nsfw_state` (type: `boolean`): On = mark the post as Not Safe For Work. Off = remove the NSFW flag. ## `spoiler_post` (type: `string`): Post to mark or unmark as a spoiler — paste the URL, the stripped ID, or the t3\_-prefixed fullname. ## `spoiler_state` (type: `boolean`): On = mark the post as a spoiler. Off = clear the spoiler flag. ## `hide_post` (type: `string`): Post to hide or unhide from your feeds — paste the URL, the stripped ID, or the t3\_-prefixed fullname. ## `hide_state` (type: `boolean`): On = hide the post from your feeds. Off = show it again. ## `report_post` (type: `string`): Reddit post — paste the URL, the stripped ID (`1s4a4j6`), or the t3\_-prefixed fullname (`t3_1s4a4j6`). ## `report_reason` (type: `string`): Site-wide rule reason or free-form text. Examples: `spam`, `harassment`, `dis_misinformation`, `violent_content`, `targeted_harassment`. Leave blank for a generic report. ## `sendreplies_post` (type: `string`): Your post — paste the URL, the stripped ID, or the t3\_-prefixed fullname. The action only works on posts you own. ## `sendreplies_state` (type: `boolean`): If on, your inbox is notified when someone replies to this post. If off, replies are silent. ## `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": "edit", "save_state": true, "flair_action": "add", "lock_state": true, "nsfw_state": true, "spoiler_state": true, "hide_state": true, "sendreplies_state": true, "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-posts-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-manage-posts-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-manage-posts-v1 --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=red_crawler/reddit-manage-posts-v1", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Reddit Post Manager V1 — Edit,Delete,Save,Flair,Lock,NSFW", "description": "Manage your own Reddit posts in one click — report, lock comments, mark NSFW or spoiler, hide, save, edit body text, set or clear flair, toggle reply notifications, or delete. Bring your Reddit Token V2 (token_v2 cookie) + matching proxy, or pick a saved account from the Reddit Vault.", "version": "1.0", "x-build-id": "2QE9Oi19y0Kn82IoK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/red_crawler~reddit-manage-posts-v1/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-red_crawler-reddit-manage-posts-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-manage-posts-v1/runs": { "post": { "operationId": "runs-sync-red_crawler-reddit-manage-posts-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-manage-posts-v1/run-sync": { "post": { "operationId": "run-sync-red_crawler-reddit-manage-posts-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": [ "edit", "delete", "save", "flair", "lock", "nsfw", "spoiler", "hide", "report", "sendreplies" ], "type": "string", "description": "Pick the action to perform on a post. 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": "edit" }, "edit_post": { "title": "Post", "type": "string", "description": "Your self-post — paste the URL, the stripped ID, or the t3_-prefixed fullname. Only self-posts (text posts) can be edited; link / image / video / gallery / poll posts cannot." }, "edit_text": { "title": "New body text", "maxLength": 40000, "type": "string", "description": "Replacement body text — Reddit markdown supported (`**bold**`, `*italic*`, `> quote`, `[link](url)`, `- bullet`)." }, "delete_post": { "title": "Post", "type": "string", "description": "Your post — paste the URL, the stripped ID, or the t3_-prefixed fullname. Deletion is permanent and only works on posts you own." }, "save_post": { "title": "Post", "type": "string", "description": "Post to save or unsave — paste the URL, the stripped ID, or the t3_-prefixed fullname." }, "save_state": { "title": "Save", "type": "boolean", "description": "On = save the post to your account's `Saved` tab. Off = remove from saved.", "default": true }, "flair_post": { "title": "Post", "type": "string", "description": "Post to flair — paste the URL, the stripped ID, or the t3_-prefixed fullname. The post must already exist in the subreddit you specify." }, "flair_subreddit": { "title": "Subreddit", "type": "string", "description": "Subreddit the post lives in (name only, with or without 'r/')." }, "flair_action": { "title": "Flair action", "enum": [ "add", "edit", "remove" ], "type": "string", "description": "`add` / `edit` apply a flair (require Flair ID). `remove` clears the post's flair.", "default": "add" }, "flair_id": { "title": "Flair ID", "type": "string", "description": "Flair template ID. Required for `add` / `edit`. Ignored for `remove`. Get the ID from the subreddit's available flair templates." }, "flair_text": { "title": "Flair text", "maxLength": 120, "type": "string", "description": "Optional flair display text. Some flair templates allow custom text; others are fixed. Ignored for `remove`." }, "lock_post": { "title": "Post", "type": "string", "description": "Post to lock or unlock — paste the URL, the stripped ID, or the t3_-prefixed fullname. Only works on posts in a subreddit where your account is a moderator (or your own posts in some communities)." }, "lock_state": { "title": "Lock comments", "type": "boolean", "description": "On = lock the post (no new comments). Off = unlock the post.", "default": true }, "nsfw_post": { "title": "Post", "type": "string", "description": "Post to mark or unmark as NSFW — paste the URL, the stripped ID, or the t3_-prefixed fullname." }, "nsfw_state": { "title": "Mark as NSFW", "type": "boolean", "description": "On = mark the post as Not Safe For Work. Off = remove the NSFW flag.", "default": true }, "spoiler_post": { "title": "Post", "type": "string", "description": "Post to mark or unmark as a spoiler — paste the URL, the stripped ID, or the t3_-prefixed fullname." }, "spoiler_state": { "title": "Mark as spoiler", "type": "boolean", "description": "On = mark the post as a spoiler. Off = clear the spoiler flag.", "default": true }, "hide_post": { "title": "Post", "type": "string", "description": "Post to hide or unhide from your feeds — paste the URL, the stripped ID, or the t3_-prefixed fullname." }, "hide_state": { "title": "Hide", "type": "boolean", "description": "On = hide the post from your feeds. Off = show it again.", "default": true }, "report_post": { "title": "Post", "type": "string", "description": "Reddit post — paste the URL, the stripped ID (`1s4a4j6`), or the t3_-prefixed fullname (`t3_1s4a4j6`)." }, "report_reason": { "title": "Reason", "type": "string", "description": "Site-wide rule reason or free-form text. Examples: `spam`, `harassment`, `dis_misinformation`, `violent_content`, `targeted_harassment`. Leave blank for a generic report." }, "sendreplies_post": { "title": "Post", "type": "string", "description": "Your post — paste the URL, the stripped ID, or the t3_-prefixed fullname. The action only works on posts you own." }, "sendreplies_state": { "title": "Receive reply notifications", "type": "boolean", "description": "If on, your inbox is notified when someone replies to this post. If off, replies are silent.", "default": true }, "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 } } } } } } } } } } ```