{ "openapi": "3.0.1", "info": { "title": "Product Hunt Scraper — Launches, Makers & Leads", "description": "Scrape Product Hunt launches with full data: votes, comments, ranks, topics, website, socials, funding, reviews and makers. Optionally extract maker contact emails for lead generation. Scrape by date range, topic or URL, with monitoring mode for new launches. Export JSON, CSV, Excel.", "version": "1.0", "x-build-id": "w0nJnhdamv7oWU80Y" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapesage~product-hunt-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapesage-product-hunt-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/scrapesage~product-hunt-scraper/runs": { "post": { "operationId": "runs-sync-scrapesage-product-hunt-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/scrapesage~product-hunt-scraper/run-sync": { "post": { "operationId": "run-sync-scrapesage-product-hunt-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": { "daysBack": { "title": "Days back", "minimum": 1, "maximum": 365, "type": "integer", "description": "Scrape the daily Product Hunt leaderboards for the last N days (including today). The simplest way to pull recent launches. Ignored if you set a Date range, Topics, or Start URLs.", "default": 7 }, "dateFrom": { "title": "Date from (YYYY-MM-DD)", "type": "string", "description": "Start of an explicit date range of daily leaderboards to scrape, e.g. `2026-06-01`. Overrides Days back." }, "dateTo": { "title": "Date to (YYYY-MM-DD)", "type": "string", "description": "End of the date range (inclusive), e.g. `2026-06-13`. Defaults to today when only Date from is set." }, "topics": { "title": "Topics", "type": "array", "description": "Also scrape these Product Hunt topic pages. Use the topic slug from the URL, e.g. `artificial-intelligence`, `developer-tools`, `saas`, `marketing`.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Also scrape specific Product Hunt URLs: leaderboard pages (`/leaderboard/daily/2026/6/12/all`), topic pages (`/topics/ai`), or individual product/post pages (`/products/`, `/posts/`).", "items": { "type": "string" } }, "includeProductDetails": { "title": "Include product details", "type": "boolean", "description": "Open each launch's product page to add the product website, full description, all social links, funding, employee size, reviews, categories, badges and makers. Adds one request per launch. Strongly recommended.", "default": true }, "enrichMakerEmails": { "title": "Enrich maker emails (lead generation)", "type": "boolean", "description": "Crawl each product's own website (home + contact/about, a few pages) for contact emails, phone numbers and extra social links. Product Hunt never exposes emails — this is the only way to turn a launch into a contactable B2B lead. Requires Include product details.", "default": false }, "monitorMode": { "title": "Monitoring mode (only new launches)", "type": "boolean", "description": "Only output launches that were NOT seen in previous runs of this Actor. Combine with Apify Schedules to capture only fresh launches each day. This does not conflict with the scheduler — the schedule starts the run, while monitoring mode filters out anything already emitted by earlier runs.", "default": false }, "monitorStoreName": { "title": "Monitor store name", "type": "string", "description": "Named key-value store used to remember which launches were already emitted (for Monitoring mode). Use one name per monitored search so their histories stay separate.", "default": "product-hunt-monitor" }, "maxItems": { "title": "Max launches", "minimum": 0, "type": "integer", "description": "Maximum number of launches to output (0 = no limit). Handy for quick, cheap test runs.", "default": 0 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 30, "type": "integer", "description": "Maximum number of pages fetched in parallel.", "default": 8 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Product Hunt has no aggressive anti-bot, so the default Apify proxy is plenty.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }