{ "openapi": "3.0.1", "info": { "title": "Reddit User Profile Posts And Comments Scraper", "description": "Scrape any Reddit user’s public posts and comments in one click. Ideal for academic research, sentiment analysis, or community behavior tracking. Clean, structured JSON output makes it easy to extract insights from Reddit user activity.", "version": "0.1", "x-build-id": "ssEOjeWNJDy8xEzeQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraper-engine~reddit-user-profile-posts-and-comments-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraper-engine-reddit-user-profile-posts-and-comments-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/scraper-engine~reddit-user-profile-posts-and-comments-scraper/runs": { "post": { "operationId": "runs-sync-scraper-engine-reddit-user-profile-posts-and-comments-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/scraper-engine~reddit-user-profile-posts-and-comments-scraper/run-sync": { "post": { "operationId": "run-sync-scraper-engine-reddit-user-profile-posts-and-comments-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": [ "startUrls" ], "properties": { "startUrls": { "title": "πŸ‘€ Usernames / URLs / Keywords", "type": "array", "description": "πŸ“‹ Enter Reddit usernames, profile URLs, or keyword searches.\n\nExamples:\nβ€’ Username: cyPersimmon9 or u/cyPersimmon9\nβ€’ Profile URL: https://www.reddit.com/user/cyPersimmon9\nβ€’ Keyword search: keyword:python\n\nπŸ’‘ Tip: You can add multiple usernames or keywords to scrape them all!", "items": { "type": "string" } }, "sortOrder": { "title": "πŸ”€ Sort Order", "enum": [ "new", "hot", "top", "controversial" ], "type": "string", "description": "πŸ“Š Choose how to sort the posts:\nβ€’ πŸ†• new - Most recent posts first\nβ€’ πŸ”₯ hot - Most popular posts\nβ€’ ⬆️ top - Highest scored posts\nβ€’ πŸ’₯ controversial - Most debated posts", "default": "new" }, "maxPosts": { "title": "πŸ“ˆ Max Posts Per Profile", "minimum": 1, "maximum": 10000, "type": "integer", "description": "🎯 Maximum number of posts to collect per profile or keyword.\n\nπŸ’‘ Range: 1-500 posts\nπŸ“Œ Default: 20 posts", "default": 10 }, "fetchSelftext": { "title": "πŸ“„ Enrich Posts (full selftext, preview, subscribers)", "type": "boolean", "description": "πŸ“ Enable to fetch each post's per-thread JSON and merge in fields the listing omits (full untruncated selftext, preview images, subreddit_subscribers, full media_embed for videos, etc.).\n\nβœ… Enabled: rich output matching require_output.json shape (slower; +1 request per post)\n❌ Disabled: fast listing-only metadata", "default": true }, "maxComments": { "title": "πŸ’¬ Max Top-level Comments per Post", "minimum": 0, "maximum": 100, "type": "integer", "description": "πŸ’¬ Number of top-level comments to attach to each post (in a `comments` array).\n\nπŸ“Œ Default: 0 (skip comments β€” fastest)\nπŸ’‘ Range: 0–100", "default": 0 }, "proxyConfiguration": { "title": "🌐 Proxy Configuration", "type": "object", "description": "πŸ”’ Proxy settings.\n\nπŸ”„ Smart fallback system:\n1️⃣ Default β€” residential proxy with up to 3 retries.\n2️⃣ If you provide a custom proxy (proxyUrls or non-residential Apify group) β€” that proxy first with 3 retries, then residential fallback with 3 retries.\n\nπŸ’‘ Leave the default (no proxy) for most use cases β€” residential is always used automatically." } } }, "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 } } } } } } } } } }