{ "openapi": "3.0.1", "info": { "title": "Reddit Posts Scraper: Full Text, Scores & Awards", "description": "Scrape Reddit posts from any subreddit, search query or post URL. Extract title, selftext, author, score, upvote ratio, comment count, awards, flair and gallery images. Export to JSON, CSV or Excel. No login or API key.", "version": "0.1", "x-build-id": "woHIEo5Nf6UP6aM2H" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~reddit-posts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-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/scrapers_lat~reddit-posts-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-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/scrapers_lat~reddit-posts-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-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", "properties": { "maxPosts": { "title": "Max posts", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of posts to collect across all sources. Optional." }, "withDetails": { "title": "Fetch Full Post Text", "type": "boolean", "description": "When enabled, the scraper opens each post page to capture the full self text, gallery images and poll data. Disable for a faster, listing-only run.", "default": true }, "withSentiment": { "title": "AI Sentiment (paid add-on)", "type": "boolean", "description": "Add-on. Classify each post's sentiment (positive / negative / neutral) with a confidence score using AI. Billed per enriched post. Paid Apify plans only.", "default": false }, "withSummary": { "title": "AI Summary (paid add-on)", "type": "boolean", "description": "Add-on. Generate a 1-2 sentence AI summary of each post's title and body. Billed per enriched post. Paid Apify plans only.", "default": false }, "withTopics": { "title": "AI Topics & Category (paid add-on)", "type": "boolean", "description": "Add-on. Extract topic/keyword tags and a broad category for each post using AI. Billed per enriched post. Paid Apify plans only.", "default": false }, "withTopComments": { "title": "Top Comments (paid add-on)", "type": "boolean", "description": "Add-on. Capture the top few comments (author, score, text) for each post. Requires 'Fetch Full Post Text'. Billed per post with comments. Paid Apify plans only.", "default": false }, "subreddits": { "title": "Subreddits", "type": "array", "description": "Subreddit names to scrape. Enter names without the r/ prefix, for example: technology, worldnews.", "items": { "type": "string" } }, "searchQuery": { "title": "Search Query", "type": "string", "description": "Optional. Search terms to query instead of (or in addition to) the subreddit feeds. For example: artificial intelligence. When a single subreddit is provided, the search is restricted to it." }, "postUrls": { "title": "Post URLs", "type": "array", "description": "Optional. Exact Reddit post URLs to fetch directly (https://www.reddit.com/r/.../comments/...).", "items": { "type": "string" } }, "sort": { "title": "Sort", "enum": [ "hot", "new", "top", "rising", "controversial" ], "type": "string", "description": "Sort order for subreddit feeds and search.", "default": "hot" }, "timeFilter": { "title": "Time Range", "enum": [ "hour", "day", "week", "month", "year", "all" ], "type": "string", "description": "Time window for the 'top' and 'controversial' sorts (and search). Ignored for hot, new and rising.", "default": "day" } } }, "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 } } } } } } } } } }