{ "openapi": "3.0.1", "info": { "title": "PainPoint Radar: Startup Idea Generator from Reddit", "description": "Scrape pains from Reddit, HN, GitHub & more → Auto-generate validated startup ideas with MVP suggestions. Discover and validate startup ideas by analyzing real user pain points from 7 platforms. Perfect for indie hackers, founders, and product managers seeking idea validation.", "version": "1.0", "x-build-id": "OgjM1kDkpODOYIz4i" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ornamental_oversight~pain-point-discovery/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ornamental_oversight-pain-point-discovery", "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/ornamental_oversight~pain-point-discovery/runs": { "post": { "operationId": "runs-sync-ornamental_oversight-pain-point-discovery", "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/ornamental_oversight~pain-point-discovery/run-sync": { "post": { "operationId": "run-sync-ornamental_oversight-pain-point-discovery", "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": [ "subreddits", "keywords" ], "properties": { "sources": { "title": "Data Sources", "uniqueItems": true, "type": "array", "description": "Which platforms to scrape for pain points. Select multiple sources for comprehensive coverage.", "items": { "type": "string", "enum": [ "reddit", "hackernews", "github", "stackoverflow", "producthunt", "indiehackers", "ycombinator" ], "enumTitles": [ "Reddit (Forums & Communities)", "Hacker News (Tech News & Discussions)", "GitHub (Issue Tracking & Code)", "Stack Overflow (Q&A & Technical Problems)", "Product Hunt (Product Reviews)", "Indie Hackers (Indie Business)", "Y Combinator (Startup Community)" ] }, "default": [ "reddit" ] }, "subreddits": { "title": "Subreddits", "type": "array", "description": "Which subreddits to scrape (without r/ prefix). Add multiple for broader coverage.", "items": { "type": "string", "minLength": 1 }, "default": [ "startups" ] }, "keywords": { "title": "Pain Point Keywords", "type": "array", "description": "Keywords that indicate pain points in content. More keywords = more results.", "items": { "type": "string", "minLength": 1 }, "default": [ "struggling", "frustrated" ] }, "maxPosts": { "title": "Max Posts Per Source", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of posts to fetch from each subreddit/source. Higher = more data but slower.", "default": 10 }, "minScore": { "title": "Minimum Pain Point Score", "minimum": 0, "maximum": 100, "type": "integer", "description": "Minimum relevance score (0-100) to include a pain point. Lower = more results (15-25 recommended for emerging pain points), Higher = stricter quality (40-60 for established pain points).", "default": 15 }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Number of parallel requests to make simultaneously. Higher = faster but may trigger rate limits. Recommended: 3-5 for most sources, 1-2 if getting blocked.", "default": 3 }, "timeRange": { "title": "Time Range", "enum": [ "day", "week", "month", "year", "all" ], "type": "string", "description": "Time period for fetching posts. Applies to Reddit and other time-filtered sources. Shorter = fresher data, Longer = more historical data.", "default": "week" }, "enableDeduplication": { "title": "Enable Content Deduplication", "type": "boolean", "description": "Remove duplicate pain points based on content similarity (recommended)", "default": true }, "extractVideoContent": { "title": "Extract Video Content", "type": "boolean", "description": "Include pain points from video posts (Reddit videos, YouTube)", "default": false }, "enableCSVExport": { "title": "Enable CSV Export", "type": "boolean", "description": "Export pain points to CSV/Excel format for easy analysis", "default": true }, "enableTrendDetection": { "title": "Enable Trend Detection", "type": "boolean", "description": "Detect similar pain points across different sources to identify trending problems", "default": true }, "enableCategoryClassification": { "title": "Enable Category Classification", "type": "boolean", "description": "Auto-classify pain points into categories (Technical, Marketing, Hiring, etc.)", "default": true }, "enableSentimentAnalysis": { "title": "Enable Sentiment Analysis", "type": "boolean", "description": "Analyze sentiment of pain points (Critical, Mild, Solution-seeking, Positive)", "default": true }, "enableCompetitorDetection": { "title": "Enable Competitor Detection", "type": "boolean", "description": "Detect mentions of competitors/tools in pain points", "default": false }, "enableKeywordFrequencyReport": { "title": "Enable Keyword Frequency Report", "type": "boolean", "description": "Generate summary report with keyword frequency and statistics", "default": true }, "maxRetries": { "title": "Max Retries", "minimum": 0, "maximum": 10, "type": "integer", "description": "Maximum number of retries for failed requests (with exponential backoff)", "default": 3 }, "enableStatisticsCard": { "title": "Enable Summary Statistics Card", "type": "boolean", "description": "Generate summary statistics card with total pain points, sources, top 5 by score, average score, and deduplication rate", "default": true }, "enableMultiFormatExport": { "title": "Enable Multi-Format Export", "type": "boolean", "description": "Export pain points to multiple formats: JSON, CSV, and HTML Report (with filters and pretty table)", "default": true }, "enableSignalClassification": { "title": "Enable Signal Classification", "type": "boolean", "description": "Classify pain points into signal types (complaint, feedback, help_request, etc.) with urgency, persona, and business value mapping. Transforms raw data into actionable intelligence.", "default": true }, "enableDataValidation": { "title": "Enable Data Validation", "type": "boolean", "description": "Enrich pain points with data freshness (age in days), industry classification, and resolution status. Improves data quality and enables time-based filtering.", "default": true }, "enableUrlValidation": { "title": "Enable URL Validation", "type": "boolean", "description": "Check if pain point URLs are still accessible. Slower but provides more accurate resolution status. Recommended for smaller datasets.", "default": false }, "githubToken": { "title": "GitHub Personal Access Token (Optional)", "type": "string", "description": "GitHub Personal Access Token for API authentication. Without this, you're limited to 60 requests/hour. With token: 5000 requests/hour. Create at: https://github.com/settings/tokens" }, "redditClientId": { "title": "Reddit Client ID (Optional)", "type": "string", "description": "Reddit OAuth Client ID for authenticated API access. Helps avoid 403 errors. Create app at: https://www.reddit.com/prefs/apps" }, "redditClientSecret": { "title": "Reddit Client Secret (Optional)", "type": "string", "description": "Reddit OAuth Client Secret (required if Client ID is provided)." } } }, "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 } } } } } } } } } }