{ "openapi": "3.0.1", "info": { "title": "Reddit Search V2 — Posts, Communities & People (up to 500)", "description": "FREE — Search Reddit at scale: posts, comments, media, communities, people, and interest topics. Up to 500 results per run — Reddit stops one search at ~500 posts per sort (~250 with Hot), so search several subreddits (comma-separated) to go higher. 3 endpoints, no Reddit account or proxy required.", "version": "1.12", "x-build-id": "MuVvCdiTtp8vke2Ym" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/red_crawler~reddit-search-v2/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-red_crawler-reddit-search-v2", "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/red_crawler~reddit-search-v2/runs": { "post": { "operationId": "runs-sync-red_crawler-reddit-search-v2", "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/red_crawler~reddit-search-v2/run-sync": { "post": { "operationId": "run-sync-red_crawler-reddit-search-v2", "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": [ "endpoint" ], "properties": { "endpoint": { "title": "What to fetch", "enum": [ "search", "community_picker", "interest_topics" ], "type": "string", "description": "Choose which search to call.", "default": "search" }, "search_query": { "title": "Query (all types)", "type": "string", "description": "Search query string. Required for every type." }, "search_type": { "title": "Type (all types)", "enum": [ "posts", "comments", "media", "communities", "people" ], "type": "string", "description": "What kind of results to return: posts, comments, media, communities, or people. The fields below behave differently per type — see the section description above.", "default": "posts" }, "search_sort": { "title": "Sort (posts / comments / media only — IGNORED for communities & people)", "enum": [ "relevance", "hot", "top", "new", "comments" ], "type": "string", "description": "Sort order. Posts & media support all 5 values. Comments support 'relevance', 'top', 'new' only — 'hot' and 'comments' fall back to 'relevance'. Communities & people IGNORE this field entirely (Reddit sorts those by relevance).", "default": "relevance" }, "search_time": { "title": "Time filter (posts / comments / media only — IGNORED for communities & people)", "enum": [ "hour", "day", "week", "month", "year", "all" ], "type": "string", "description": "Time window for the search. Only applies to posts, comments, and media. Communities and people IGNORE this field entirely (Reddit doesn't time-filter those).", "default": "all" }, "search_safe": { "title": "Safe search (all types)", "enum": [ "on", "off" ], "type": "string", "description": "Hide NSFW results when 'on'. Applies to every type.", "default": "off" }, "search_subreddit": { "title": "Limit to subreddit(s) (posts / comments / media only — IGNORED for communities & people)", "type": "string", "description": "Optional. Restrict the search to one subreddit, or several comma-separated (e.g. cats,dog,aww) to fan out across them — each sub is queried separately and the results merged. Only applies to posts, comments, and media. Communities and people searches always run globally — this field is IGNORED for those types." }, "search_limit": { "title": "Limit (all types)", "minimum": 1, "maximum": 500, "type": "integer", "description": "Max results to return (1–500). Applies to every type. With multiple subreddits this is the TOTAL across them, split evenly. What you actually get is bounded by Reddit's own ceiling for one search: about 500 posts or media per sort (about 250 with Hot), about 250 comments, about 250 communities, about 25 people. Search several subreddits (comma-separated), or use another sort, to get more.", "default": 100 }, "community_picker_query": { "title": "Query", "type": "string", "description": "Search query string." }, "community_picker_nsfw": { "title": "Include NSFW", "type": "boolean", "description": "Include NSFW communities in results.", "default": true }, "interest_topics_query": { "title": "Query", "type": "string", "description": "Search query string." } } }, "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 } } } } } } } } } }