{ "openapi": "3.0.1", "info": { "title": "Reddit Subreddit Search Scraper", "description": "Find public Reddit communities by keyword with activity, descriptions, and direct URLs. MCP-ready. $0.005/query + $0.01/community, plus platform usage.", "version": "1.2", "x-build-id": "jfeNKM0JvxrAc5fCG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~reddit-subreddit-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-reddit-subreddit-search-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/khadinakbar~reddit-subreddit-search-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-reddit-subreddit-search-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/khadinakbar~reddit-subreddit-search-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-reddit-subreddit-search-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": { "queries": { "title": "Subreddit search queries", "type": "array", "description": "Use this when you need to discover public Reddit communities from keywords. Pass one or more phrases such as \"machine learning\" or \"personal finance\". Defaults to \"artificial intelligence\" and accepts at most 20 distinct phrases. This is not a subreddit URL, post URL, or Reddit username.", "default": [ "artificial intelligence" ], "items": { "type": "string" } }, "maxSubreddits": { "title": "Maximum subreddits", "minimum": 1, "maximum": 100, "type": "integer", "description": "Use this to cap the total unique communities returned across every query. Pass an integer such as 25. Defaults to 25 and accepts 1 through 100, which also caps event charges. This is not a number of posts, comments, or results per query.", "default": 25 }, "minSubscribers": { "title": "Minimum subscriber count", "minimum": 0, "maximum": 1000000000, "type": "integer", "description": "Use this to filter out communities below a subscriber threshold. Pass an integer such as 10000. Defaults to 0 and accepts 0 through 1,000,000,000; communities with an unavailable count do not pass a positive threshold. This is not a sort order or a guaranteed active-user count.", "default": 0 }, "sort": { "title": "Result order", "enum": [ "relevance", "subscribers", "activity", "newest" ], "type": "string", "description": "Use this to choose how matching communities are ordered after deduplication. Choose relevance, subscribers, activity, or newest; for example, \"subscribers\" ranks the largest known communities first. Defaults to relevance. This does not change Reddit's matching logic or search inside post content.", "default": "relevance" }, "includeNsfw": { "title": "Include NSFW communities", "type": "boolean", "description": "Use this only when adult-marked public communities are appropriate for the research task. Pass true to include a community whose Reddit metadata is marked NSFW, for example true. Defaults to false. This does not bypass Reddit safety controls or access private communities.", "default": false }, "responseFormat": { "title": "Response detail", "enum": [ "concise", "detailed" ], "type": "string", "description": "Use this to balance agent context size against metadata depth. Choose concise for identifiers, counts, URLs, and status, or detailed for descriptions and artwork URLs; for example, \"concise\". Defaults to concise. This does not affect matching, filtering, or billing per returned community.", "default": "concise" } } }, "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 } } } } } } } } } }