{ "openapi": "3.0.1", "info": { "title": "Product Hunt Launches Scraper", "description": "Scrape daily product launches from Product Hunt with votes, comments, daily rank, topics, makers, descriptions and product websites.", "version": "0.0", "x-build-id": "agaCaTSpxiNoIo1WJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~producthunt-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-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/parseforge~producthunt-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-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/parseforge~producthunt-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-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": "🔗 Launch URLs", "type": "array", "description": "Read these Product Hunt launches directly instead of the daily leaderboards. Accepts https://www.producthunt.com/posts/ and the https://www.producthunt.com/products/?launch= address it redirects to. Leave empty to scrape the leaderboards by date.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "daysBack": { "title": "Days Back", "minimum": 1, "maximum": 30, "type": "integer", "description": "How many past days of launches to collect, counting back from today (1 = today only, 7 = the last week). Product Hunt publishes one leaderboard per day, so a wider window returns more products. Max 30." }, "daysOffset": { "title": "⏪ Skip this many days", "minimum": 0, "maximum": 365, "type": "integer", "description": "Start this many days before today. With Days back 7 and Skip 7 you get the week before last. Ignored when a date range is set.", "default": 0 }, "startDate": { "title": "📅 From date", "type": "string", "description": "First leaderboard day to read, as YYYY-MM-DD (Pacific time, the timezone Product Hunt uses for its daily boards). Setting a date range overrides Days back." }, "endDate": { "title": "📅 To date", "type": "string", "description": "Last leaderboard day to read, as YYYY-MM-DD. Defaults to today. Capped at 30 days from the start date." }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" }, "getDetails": { "title": "📄 Open each launch page", "type": "boolean", "description": "On by default. Opens one page per launch to add the description, the website and the makers. Turn it off for a much faster and cheaper run that returns only what the leaderboard itself carries: name, tagline, rank, votes, comments, topics and dates. Forced on when launch URLs or any paid extra are used.", "default": true }, "includeProductProfile": { "title": "🏢 Include product profile", "type": "boolean", "description": "Adds the product record behind each launch: social links (X, LinkedIn, Instagram, Facebook, GitHub), App Store and Google Play links, followers, review rating, weekly rank, launch-day score, pricing type, categories, hunter and makers with their profile links and headlines, awards, screenshots and alternatives. No extra request, it is read from the launch page. Charged only for a row that receives it.", "default": false }, "includeComments": { "title": "💬 Include launch comments", "type": "boolean", "description": "Adds the comment threads Product Hunt renders on the launch page (the first page, usually 5 to 10 threads, each with its replies): author, username, maker flag, text, votes, date and link. No extra request. Charged only for a row that receives at least one comment.", "default": false }, "includeReviews": { "title": "⭐ Include product reviews", "type": "boolean", "description": "Adds the review block of the product: the star breakdown, Product Hunt's written review summary, pro and con tags, and the latest reviews shown on the page (up to 3) with rating, reviewer, positive and negative feedback. No extra request. Charged only for a row whose product has reviews.", "default": false }, "proxyConfiguration": { "title": "🌐 Proxy", "type": "object", "description": "Proxy used to reach Product Hunt. Defaults to Apify residential proxies in the US, which is what gets past the bot protection; datacenter IPs are mostly blocked.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } }