{ "openapi": "3.0.1", "info": { "title": "Reddit User Scraper — Profile, Karma, Posts & Comments", "description": "Reddit users by name: the profile (link and comment karma, cake day, bio, trophies and the subreddits they moderate) and the user's posts and comments, newest first, with text, score, exact time and score per hour. Only-new mode. No login.", "version": "0.2", "x-build-id": "9GGCcBiw7la0wDwXC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/foxlabs~reddit-user-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-foxlabs-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/foxlabs~reddit-user-scraper/runs": { "post": { "operationId": "runs-sync-foxlabs-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/foxlabs~reddit-user-scraper/run-sync": { "post": { "operationId": "run-sync-foxlabs-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": [ "users" ], "properties": { "users": { "title": "Users", "type": "array", "description": "One user per line: a name (spez), u/spez, or a profile address (https://www.reddit.com/user/spez/). A user written twice is read once. Suspended, deleted and shadowbanned users get a status row.", "items": { "type": "string" } }, "include": { "title": "What to read", "enum": [ "overview", "posts", "comments" ], "type": "string", "description": "The user's posts and comments together (overview, default), posts only, or comments only. The profile row comes in any case unless turned off below.", "default": "overview" }, "sort": { "title": "Order", "enum": [ "new", "hot", "top", "controversial" ], "type": "string", "description": "new (newest first, default), hot, top (highest score in the period), controversial.", "default": "new" }, "time": { "title": "Period (for top and controversial)", "enum": [ "hour", "day", "week", "month", "year", "all" ], "type": "string", "description": "The period the top and controversial orders cover. Ignored for new and hot.", "default": "all" }, "maxItemsPerUser": { "title": "Maximum posts and comments per user", "minimum": 1, "maximum": 100000, "type": "integer", "description": "How many of the user's posts and comments to deliver, from the top of the listing. Reddit hands them out 100 a request, as far back as it lists the user's history to a visitor who is not signed in: a larger number stops where Reddit stops.", "default": 100 }, "maxItems": { "title": "Maximum posts and comments in total", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "The run stops when this many post and comment rows have been delivered. You are charged only for delivered rows.", "default": 100000 }, "includeProfile": { "title": "Deliver the profile row", "type": "boolean", "description": "On (default): one row per user (type \"user\") with karma, account age, flags, trophies and moderated subreddits, charged as a profile. Off: posts and comments only.", "default": true }, "includeTrophies": { "title": "Add trophies and moderated subreddits to the profile", "type": "boolean", "description": "Two more requests per user add the user's trophies and the subreddits the user moderates (public lists). Off: the profile row carries karma, age and flags alone.", "default": true }, "onlyNewItems": { "title": "Only posts and comments not delivered before", "type": "boolean", "description": "Remember delivered posts and comments under the list name below and skip them in later runs: schedule the same users and each run brings only what is new. The profile row is delivered every run.", "default": false }, "listName": { "title": "List name", "pattern": "^[A-Za-z0-9]([A-Za-z0-9-]{0,38}[A-Za-z0-9])?$", "type": "string", "description": "Name of the memory used by \"Only posts and comments not delivered before\" (looked at only when that is on). Letters, digits and hyphens (a hyphen not first or last), up to 40 characters; capitals are read as lower case.", "default": "default" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Nothing to change for normal use: the Actor reads Reddit through Apify Proxy residential addresses, the only kind Reddit hands its guest token to (measured: residential 7 of 7 sessions, datacenter 0 of 8). Set a proxy here to send every request through it instead; a setting the platform refuses ends the run before anything is read." } } }, "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 } } } } } } } } } }