{ "openapi": "3.0.1", "info": { "title": "Product Hunt Scraper - Daily Leaderboard, Pay Per Result", "description": "Scrape the Product Hunt daily leaderboard for any date: launch name, tagline, daily, weekly and monthly rank, comment count, topics, thumbnail and launch page. Backfill any date range. No API token needed. No personal data: voters, makers and commenters are never collected.", "version": "0.1", "x-build-id": "udySjgcnGC7xWVeeN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automia-admin~product-hunt-leaderboard-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automia-admin-product-hunt-leaderboard-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/automia-admin~product-hunt-leaderboard-scraper/runs": { "post": { "operationId": "runs-sync-automia-admin-product-hunt-leaderboard-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/automia-admin~product-hunt-leaderboard-scraper/run-sync": { "post": { "operationId": "run-sync-automia-admin-product-hunt-leaderboard-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": "Which dates to scrape", "enum": [ "recent", "range", "dates" ], "type": "string", "description": "\"Recent days\" walks back from yesterday. \"Date range\" scrapes every day between two dates. \"Specific dates\" scrapes only the days you list. Today is never scraped: its leaderboard is still filling up.", "default": "recent" }, "days": { "title": "How many recent days (only used in Recent days mode)", "minimum": 1, "maximum": 120, "type": "integer", "description": "Number of complete days to scrape, counting back from yesterday. Each day returns the launches that Product Hunt ranked on its daily leaderboard, typically 10 to 17.", "default": 3 }, "startDate": { "title": "Start date (only used in Date range mode)", "type": "string", "description": "First day of the range, as YYYY-MM-DD. If left empty, the range starts six days before the end date." }, "endDate": { "title": "End date (only used in Date range mode)", "type": "string", "description": "Last day of the range, as YYYY-MM-DD. Defaults to today. A range longer than 120 days is trimmed to the most recent 120." }, "dates": { "title": "Specific dates (only used in Specific dates mode)", "type": "array", "description": "One date per line, as YYYY-MM-DD. Future dates are ignored.", "items": { "type": "string" } }, "maxLaunchesPerDay": { "title": "Maximum launches per day", "minimum": 0, "maximum": 100, "type": "integer", "description": "Keep only the top N ranked launches of each day. Leave at 0 to keep every ranked launch the leaderboard returns.", "default": 0 }, "politeDelayMs": { "title": "Delay between requests", "minimum": 250, "maximum": 5000, "type": "integer", "description": "Milliseconds between requests to Product Hunt. The default of 1000 ms (one request per second) is deliberately conservative and was measured clean over ten consecutive dates. Lower it only if you know what you are doing.", "default": 1000 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy, on by default and required in practice: Product Hunt sits behind Cloudflare, which rejects datacenter ranges outright. Every retry takes a fresh exit IP.", "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 } } } } } } } } } }