{ "openapi": "3.0.1", "info": { "title": "Reddit Opinions Scraper: Pros, Cons & Quotes", "description": "Type a product or brand and see what Reddit says about it: pros, cons, repeat complaints and a verdict, each backed by a quoted post or comment with its link. Up to 500 posts and comments per run.", "version": "0.1", "x-build-id": "w609RjI522w8ETN9s" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/physealabs~reddit-sentiment-report/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-physealabs-reddit-sentiment-report", "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/physealabs~reddit-sentiment-report/runs": { "post": { "operationId": "runs-sync-physealabs-reddit-sentiment-report", "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/physealabs~reddit-sentiment-report/run-sync": { "post": { "operationId": "run-sync-physealabs-reddit-sentiment-report", "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": [ "topic" ], "properties": { "topic": { "title": "Product, brand or topic", "type": "string", "description": "Type it the way people would on Reddit, like Framework Laptop or Notion vs Obsidian." }, "subreddits": { "title": "Only these subreddits (optional)", "type": "array", "description": "For example r/laptops. Leave blank to search all of Reddit.", "items": { "type": "string" } }, "buyerPerspective": { "title": "Whose point of view (optional)", "type": "string", "description": "Who is deciding and what they care about, like a student on a budget.", "default": "a prospective buyer evaluating whether this is right for them" }, "maxPosts": { "title": "Max posts and comments", "minimum": 10, "maximum": 1000, "type": "integer", "description": "Roughly 60% posts and 40% comments from the most relevant threads. 100 gives a solid read; 500 is the cap.", "default": 100 }, "sort": { "title": "Sort", "enum": [ "relevance", "hot", "top", "new", "comments" ], "type": "string", "description": "How Reddit orders the search results.", "default": "relevance" }, "timeRange": { "title": "How far back", "enum": [ "hour", "day", "week", "month", "year", "all" ], "type": "string", "description": "Limit the search to recent posts.", "default": "year" }, "llm": { "title": "Your own analysis endpoint", "type": "object", "description": "Leave blank. Only for teams who want the summary step billed to their own OpenAI-compatible key: baseUrl, model and apiKey. Without a key the other two are ignored." }, "emitComplaintRecords": { "title": "Complaint records (beta)", "type": "boolean", "description": "Adds one row per post or comment with its type (complaint, question, praise, promo, off topic), the complaint excerpt, issue category and any requested fix. No extra charge. Counts mean posts collected, not how common a problem is.", "default": false }, "entityAliases": { "title": "Other names for it", "type": "array", "description": "Nicknames or abbreviations. Used to drop posts that are not about your topic from the complaint rows.", "default": [], "items": { "type": "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 } } } } } } } } } }