{ "openapi": "3.0.1", "info": { "title": "Reddit User Scraper: Posts & Comment History, $2/1K Items", "description": "Input: Reddit usernames. Output: each user's public posts and comments, newest first, as JSON rows with subreddit, score, body text, permalink and UTC date, up to about 1,000 items per user. $2 per 1,000 posts or comments, no start fee.", "version": "0.1", "x-build-id": "lhj8kWyU78aQza4aW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/actorforgehq~reddit-user-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-actorforgehq-reddit-user-scraper", "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/actorforgehq~reddit-user-scraper/runs": { "post": { "operationId": "runs-sync-actorforgehq-reddit-user-scraper", "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/actorforgehq~reddit-user-scraper/run-sync": { "post": { "operationId": "run-sync-actorforgehq-reddit-user-scraper", "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", "properties": { "users": { "title": "Usernames", "type": "array", "description": "Reddit usernames without u/, one per line, for example spez. Links to profiles like https://www.reddit.com/user/spez/ work too.", "items": { "type": "string" } }, "content": { "title": "Content", "enum": [ "both", "posts", "comments" ], "type": "string", "description": "What to read from the history: posts and comments mixed, newest first (default), only posts, or only comments.", "default": "both" }, "maxItems": { "title": "Max items per user", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many posts and comments to keep per user (default 100, hard cap 1,000, about where Reddit's own feeds end). One request returns 25 items, so 1,000 items take about 40 requests. The profile row does not count.", "default": 100 }, "postedAfter": { "title": "Posts after (ISO date)", "type": "string", "description": "Keep only posts submitted on or after this date (UTC). The history is newest first, so with Posts only, or with both date fields set, the Actor stops paging at the first item older than the date." }, "commentedAfter": { "title": "Comments after (ISO date)", "type": "string", "description": "Keep only comments written on or after this date (UTC). The history is newest first, so with Comments only, or with both date fields set, the Actor stops paging at the first item older than the date." }, "includeNSFW": { "title": "Include NSFW", "type": "boolean", "description": "Off by default: posts marked NSFW are skipped unless you turn this on. Comments carry no NSFW flag in the history and are always included.", "default": false }, "onlyNew": { "title": "Only new since last run", "type": "boolean", "description": "Skip posts and comments this Actor already gave you in earlier runs for the same users and content setting: they are not saved again and not charged. New means not delivered to you before, not newer by time. With this on, Max items counts new rows only, and paging stops at the first page where everything was already delivered. The list of delivered rows is kept in a key-value store in your own Apify account named reddit-user-only-new- plus a code made from your users (the run log shows the exact name). It does not expire. To start over, delete that store in Storage. The profile row is saved on every run.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Residential proxies are the default and the supported configuration. No country pin is needed. The run rotates proxy sessions and visitor cookies whenever Reddit refuses one.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }