{ "openapi": "3.0.1", "info": { "title": "Product Hunt Launches Scraper", "description": "Ranked Product Hunt launches by day, week, month or year, plus product detail. Flags the paid placements injected into the ranking, and refuses impossible dates that Product Hunt would silently serve as a different day.", "version": "0.1", "x-build-id": "2BhuPpagUBOtl1rwr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapyx~producthunt-launches-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapyx-producthunt-launches-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/scrapyx~producthunt-launches-scraper/runs": { "post": { "operationId": "runs-sync-scrapyx-producthunt-launches-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/scrapyx~producthunt-launches-scraper/run-sync": { "post": { "operationId": "run-sync-scrapyx-producthunt-launches-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": { "mode": { "title": "What to collect", "enum": [ "leaderboard", "products" ], "type": "string", "description": "leaderboard = ranked launches for a day, week, month or year. products = full detail for product slugs you name. There is no keyword-search mode: Product Hunt's robots.txt disallows /search* outright.", "default": "leaderboard" }, "period": { "title": "Leaderboard period", "enum": [ "daily", "weekly", "monthly", "yearly" ], "type": "string", "description": "daily walks a date range one day at a time. weekly/monthly/yearly fetch one board.", "default": "daily" }, "startDate": { "title": "Start date (daily)", "type": "string", "description": "YYYY-MM-DD. Impossible dates are refused here rather than sent: Product Hunt answers HTTP 200 for something like 2026-02-31 and silently serves a DIFFERENT real date, and neither its canonical URL nor its page heading reveals the swap." }, "endDate": { "title": "End date (daily)", "type": "string", "description": "YYYY-MM-DD. Defaults to the start date. Max 400 days per run." }, "year": { "title": "Year (weekly / monthly / yearly)", "minimum": 2013, "type": "integer", "description": "Product Hunt's data starts in 2013." }, "month": { "title": "Month (monthly)", "minimum": 1, "maximum": 12, "type": "integer", "description": "1-12. Out-of-range values are refused locally, because upstream rolls them into a different real period without saying so." }, "week": { "title": "ISO week (weekly)", "minimum": 1, "maximum": 53, "type": "integer", "description": "1-53." }, "productSlugs": { "title": "Product slugs or URLs", "type": "array", "description": "For mode='products'. A slug like `notion` or a full producthunt.com/products/ URL. Slugs cannot be guessed from a product's name — a wrong guess is an honest 404 — so take them from this actor's own leaderboard output.", "items": { "type": "string" } }, "includePromoted": { "title": "Include promoted ad slots", "type": "boolean", "description": "Product Hunt injects paid placements into the ranking. They are always FLAGGED (rank is null, isPromoted is true) — this only controls whether they are emitted at all. On by default so nothing is hidden from you.", "default": true }, "fetchProductDetails": { "title": "Also fetch each product's own page", "type": "boolean", "description": "Leaderboard mode only — products mode always fetches it. Adds description, category, maker list, screenshots and the overall rating, at one extra request per unique product.", "default": false }, "maxResults": { "title": "Max launches", "minimum": 0, "type": "integer", "description": "Set 0 for unlimited. A daily board holds roughly 17 ranked entries plus any promoted slots.", "default": 200 }, "maxConcurrency": { "title": "Max concurrent requests", "minimum": 1, "maximum": 10, "type": "integer", "description": "Product-detail fetches in flight at once. Leaderboard days are sequential.", "default": 3 }, "minRequestInterval": { "title": "Min seconds between request starts", "minimum": 0, "maximum": 30, "type": "integer", "description": "Politeness pacing shared across all workers. 0 uses the built-in default of 1s. Raising this is the right response to Cloudflare challenges.", "default": 0 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Cloudflare here gates the TLS fingerprint rather than the IP — the whole reconnaissance ran proxy-free. Residential is still the default for cloud runs, because datacenter ASNs are scored separately.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }