{ "openapi": "3.0.1", "info": { "title": "Product Hunt Scraper for Launch & Maker Leads", "description": "Scrape Product Hunt launches, makers, hunters, websites, social links, comments, reviews, upvotes, rankings, and startup lead signals.", "version": "0.8", "x-build-id": "fmokEPyxmVCDpWLFd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/runtime~producthunt-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-runtime-producthunt-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/runtime~producthunt-scraper/runs": { "post": { "operationId": "runs-sync-runtime-producthunt-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/runtime~producthunt-scraper/run-sync": { "post": { "operationId": "run-sync-runtime-producthunt-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": { "startUrls": { "title": "Start URLs", "type": "string", "description": "Product Hunt URLs to start from, one per line. Supports daily leaderboards and product pages. If Start Date is provided, this field is ignored." }, "startDate": { "title": "Start Date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Start date for daily leaderboard scraping (YYYY-MM-DD format). If provided, Start URLs will be ignored. Leave empty to use Start URLs instead." }, "endDate": { "title": "End Date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "End date for daily leaderboard scraping (YYYY-MM-DD format). If not provided, defaults to yesterday. Only used when Start Date is provided." }, "getDetails": { "title": "Get Product Details", "type": "boolean", "description": "Visit each product page to enrich leaderboard rows with makers, hunters, websites, social links, comments, reviews, launches, built-with tools, and lead signals. Disable for faster daily monitoring.", "default": false }, "maxResults": { "title": "Max Results", "minimum": 1, "type": "integer", "description": "Maximum number of products to save. Lower values reduce timeout risk. Recommended: 25 for fast leaderboard monitoring, 5-10 with detail enrichment enabled.", "default": 25 }, "timeoutSecs": { "title": "Timeout (seconds)", "minimum": 300, "maximum": 3600, "type": "integer", "description": "Maximum runtime before the Actor stops. Increase for large scraping jobs. Recommended: 900s for ~10 products with details, 1800s for ~25 products.", "default": 900 }, "maxRequestRetries": { "title": "Max Request Retries", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum retries for failed requests. Higher values improve reliability but may slow down scraping.", "default": 5 }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Number of pages to process simultaneously. Lower values (1-3) are more stable, higher values (5-10) are faster but may hit rate limits.", "default": 3 }, "maxRequestsPerCrawl": { "title": "Max Requests Per Crawl", "minimum": 50, "maximum": 1000, "type": "integer", "description": "Total number of pages to crawl. Increase for large date ranges (e.g., 200+ for multi-day leaderboard scraping with details).", "default": 200 }, "useApifyProxy": { "title": "Use Apify Proxy", "type": "boolean", "description": "Enable Apify Proxy for improved reliability and to avoid rate limiting. Highly recommended for production use.", "default": true }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Advanced proxy settings. Choose Apify Proxy groups, custom proxy URLs, or no proxy. Leave empty to use the 'Use Apify Proxy' checkbox above. If runs fail with 403 blocks, select the RESIDENTIAL proxy group.", "default": {} }, "maxCommentPages": { "title": "Max Comment Pages", "minimum": 0, "maximum": 10, "type": "integer", "description": "Number of comment pages to scrape per product (0-10). Each page adds runtime. Set to 0 for faster lead enrichment without comments. Only applies when Get Product Details is enabled.", "default": 0 } } }, "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 } } } } } } } } } }