{ "openapi": "3.0.1", "info": { "title": "Reddit User Scraper - Profiles, Karma, Posts & Comments", "description": "Reddit profiles for 1 to 1,000 usernames per run: post and comment karma, account age, followers, verified badge, premium and bio, plus each account's newest posts and comments if you want them. Suspended, deleted and missing accounts are listed and never charged.", "version": "0.1", "x-build-id": "v9h7bftDjWQahDo2x" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studioxl~reddit-user-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studioxl-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/studioxl~reddit-user-scraper/runs": { "post": { "operationId": "runs-sync-studioxl-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/studioxl~reddit-user-scraper/run-sync": { "post": { "operationId": "run-sync-studioxl-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", "required": [ "usernames" ], "properties": { "usernames": { "title": "Usernames or profile links", "minItems": 1, "maxItems": 1000, "type": "array", "description": "One per line, 1,000 at most. Accepts spez, u/spez or https://www.reddit.com/user/spez/. The same account listed twice is collected and charged once.", "items": { "type": "string", "minLength": 1, "maxLength": 300 }, "default": [ "spez" ] }, "mode": { "title": "What to collect", "enum": [ "profile", "profile_posts", "profile_comments", "all" ], "type": "string", "description": "Profile only takes one step per account: one row per account with karma, account age, followers and bio. The other options add one row per post or comment.", "default": "profile" }, "maxPostsPerUser": { "title": "Max posts per account", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Newest posts first. Used only when posts are collected. You pay only for posts that are saved.", "default": 25 }, "maxCommentsPerUser": { "title": "Max comments per account", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Newest comments first. Used only when comments are collected. You pay only for comments that are saved.", "default": 25 }, "fullCommentText": { "title": "Full text of long comments", "type": "boolean", "description": "On: comments longer than 300 characters are saved in full, with their parent ID, edit date and flair. Off: those comments stop at 300 characters (bodyTruncated is true), which saves one step per long comment. The price per row is the same either way.", "default": true }, "includeTrophies": { "title": "Trophy list", "type": "boolean", "description": "Adds each account's trophies (name, date, icon) to its profile row. The trophy count is included either way. Adds one step per account.", "default": false }, "includeModeratedSubreddits": { "title": "Moderated subreddits", "type": "boolean", "description": "Adds isMod and the list of subreddits the account moderates. When off, these fields are empty rather than false, so an empty value never reads as 'moderates nothing'. Adds one step per account.", "default": false }, "includeNsfw": { "title": "Include 18+ posts", "type": "boolean", "description": "Off by default: posts marked 18+ are left out. Every account still gets its profile row; isNsfw shows whether the profile itself is marked 18+, as 22% of 944 measured accounts were. Comments carry no 18+ marker and are kept.", "default": false } } }, "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 } } } } } } } } } }