{ "openapi": "3.0.1", "info": { "title": "reddit-posts-scraper-with-author-media-details", "description": "Automate Reddit post extraction for research or analysis. This actor scrapes titles, engagement stats, authorship info, timestamps, and direct URLs from any subreddit. Great for building datasets or tracking community trends at scale.", "version": "0.1", "x-build-id": "Hw4TQRgK6ygTVUKJR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/simpleapi~reddit-posts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-simpleapi-reddit-posts-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/simpleapi~reddit-posts-scraper/runs": { "post": { "operationId": "runs-sync-simpleapi-reddit-posts-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/simpleapi~reddit-posts-scraper/run-sync": { "post": { "operationId": "run-sync-simpleapi-reddit-posts-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": "๐ŸŽฏ Subreddits, post URLs & search terms", "type": "array", "description": "One per line. Accepts a subreddit name (news or r/news), a full Reddit URL (https://www.reddit.com/r/news/), or a free-text search term (artificial intelligence). Duplicate subreddits are merged. At least one entry is required.", "items": { "type": "string" } }, "sortOrder": { "title": "๐Ÿ”€ Ranking", "enum": [ "hot", "new", "top", "rising" ], "type": "string", "description": "Ranking used on the listing. ๐Ÿ”ฅ Hot = trending, ๐Ÿ†• New = newest first, โฌ†๏ธ Top = most upvoted, ๐Ÿ“ˆ Rising = gaining fast. For keyword sources this maps to Reddit search relevance/hot/top/new.", "default": "top" }, "timeFilter": { "title": "๐Ÿ—“๏ธ Time window", "enum": [ "hour", "day", "week", "month", "year", "all" ], "type": "string", "description": "Time window for the ranking. Applies only when Ranking is Top or Rising; ignored for Hot and New.", "default": "week" }, "maxPosts": { "title": "๐Ÿ”ข Posts per source", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Upper bound of posts to collect for each source (1โ€“1000). Three sources at 50 can yield up to 150 posts.", "default": 10 }, "maxComments": { "title": "๐Ÿงต Top-level comments per post", "minimum": 0, "maximum": 1000, "type": "integer", "description": "How many top-level comments to attach to each post (0โ€“1000), each with its nested replies. Set 0 to skip comments and run faster.", "default": 5 }, "includeAuthorStats": { "title": "๐Ÿง‘ Fetch author account stats", "type": "boolean", "description": "When on, adds authorKarma, authorCommentKarma, authorAccountAgeDays, authorCakeDay, authorId, authorVerified, authorIsMod and an authorSource marker. Coverage is partial (karma/age reliable via profile page; verified/is_mod only when the JSON profile is reachable). Off by default.", "default": false }, "proxyConfiguration": { "title": "๐ŸŒ Proxy", "type": "object", "description": "Proxy picker. Leave default for most runs; enable Apify Proxy (residential recommended) for large runs or if you hit blocks." } } }, "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 } } } } } } } } } }