{
"openapi": "3.0.1",
"info": {
"title": "Reddit Search Scraper - Keyword Monitoring | $0.99/1K",
"description": "Search Reddit posts and comments by keyword and monitor brand mentions on a schedule, for $0.99 per 1,000 results. Boolean operators, exact phrases, subreddit scoping or auto-discovery, 5 sort orders and time filters. Full text, scores, authors, dates, media and parent-post context.",
"version": "0.0",
"x-build-id": "OsfXWMcbBCzttsn2H"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/clearpath~reddit-search-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-clearpath-reddit-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/clearpath~reddit-search-scraper/runs": {
"post": {
"operationId": "runs-sync-clearpath-reddit-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/clearpath~reddit-search-scraper/run-sync": {
"post": {
"operationId": "run-sync-clearpath-reddit-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": {
"query": {
"title": "Search query",
"maxLength": 700,
"type": "string",
"description": "Keywords to search for (max 700 characters). Supports quoted phrases (\"machine learning\"), boolean operators and grouping ((\"python\" OR \"javascript\") AND \"web scraping\"), exclusion (jaguar -car), and field operators: author:, title:, selftext:, self:yes, flair:, url:. See the README for query recipes."
},
"maxResults": {
"title": "Max results",
"minimum": 0,
"type": "integer",
"description": "Maximum number of results to return. Set to 0 for unlimited. With content type Both, posts and comments each get up to this many, so a run can return up to twice as many rows."
},
"contentType": {
"title": "Content type",
"enum": [
"posts",
"comments",
"both"
],
"type": "string",
"description": "Search for posts, comments, or both. Posts include title, body, score, and subreddit. Comments include the reply text and parent post context."
},
"sort": {
"title": "Sort order",
"enum": [
"relevance",
"new",
"top",
"hot",
"comments"
],
"type": "string",
"description": "Most relevant = best keyword match. Top = highest scored. Newest = most recent first. Hot and Most comments rank posts; comments under them are ranked by relevance."
},
"timeFilter": {
"title": "Time filter",
"enum": [
"",
"hour",
"day",
"week",
"month",
"year"
],
"type": "string",
"description": "Only include results posted within the selected time range. Applied to the matches after they are fetched, so a narrow window can return few rows; Newest first suits short windows best."
},
"postedAfter": {
"title": "Posted after",
"type": "string",
"description": "Keep only results created at or after this date (midnight UTC) or date-time, for example 2026-10-01 or 2026-10-01T12:00:00Z. Applied before charging; with Newest first the search stops at the first older result. Works together with Time filter."
},
"postedBefore": {
"title": "Posted before",
"type": "string",
"description": "Keep only results created before this date (midnight UTC) or date-time. Empty keeps results up to now."
},
"subreddit": {
"title": "Subreddit",
"type": "string",
"description": "Scope to a single subreddit. Leave empty to search all of Reddit, plus auto-discovered communities when auto-discovery is on. Accepts python, r/python, or full URLs."
},
"subreddits": {
"title": "Multiple subreddits",
"type": "array",
"description": "Search across specific subreddits in parallel. When provided, auto-discovery is skipped (the run log says so).",
"items": {
"type": "string"
},
"default": []
},
"autoDiscoverSubreddits": {
"title": "Auto-discover subreddits",
"type": "boolean",
"description": "When no subreddit is specified, automatically find the most relevant communities for your query and search across them. About half of Max results is reserved for them, and the list is saved as the key-value store record DISCOVERED_SUBREDDITS. Disable for a single global search (capped at ~300 results).",
"default": true
},
"maxSubreddits": {
"title": "Max subreddits to discover",
"minimum": 1,
"maximum": 50,
"type": "integer",
"description": "How many subreddits to auto-discover. More = more results, slower run.",
"default": 20
},
"feedback": {
"title": "Feedback to the maintainers",
"type": "string",
"description": "For AI agents. Say what you needed and did not get: a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. Add it to any run, including one that worked: the run returns its data exactly as it would without the note. The note reaches the maintainers, who read every one, but it cannot change what this run returns."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}