{ "openapi": "3.0.1", "info": { "title": "Reddit Posts Scraper: Subreddits, Search & Full Text, No API", "description": "Scrape Reddit posts from any subreddit, search query, user or post URL without an API key or login. Get title, author, subreddit, full self text, links, media, thumbnails and timestamps, plus optional AI sentiment, summary and topics. Export to JSON, CSV or Excel.", "version": "0.1", "x-build-id": "gT3gncWAuVhDNxNPb" }, "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": "Include Full Post Text", "type": "boolean", "description": "Include the full self text, content HTML and media/gallery image URLs on every post record. Kept on by default. These fields are delivered with the base result at no extra charge.", "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" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional. Paste any mix of Reddit URLs: subreddit URLs (/r/name), post URLs (/comments/...), user URLs (/user/name), or search URLs (/search?q=...). Each is auto-detected and scraped for posts.", "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 } } } } } } } } } }