{ "openapi": "3.0.1", "info": { "title": "Product Hunt Pro", "description": "Scrape Product Hunt launches free: daily, weekly, monthly and yearly leaderboards with ranks and upvotes, company websites, makers and hunters with LinkedIn, full review text with star ratings, comments, topics and media. Search by keyword, topic or URL. No API key needed.", "version": "1.0", "x-build-id": "qEkDSVe67gRmPiGXr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dz_omar~product-hunt-pro/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dz_omar-product-hunt-pro", "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/dz_omar~product-hunt-pro/runs": { "post": { "operationId": "runs-sync-dz_omar-product-hunt-pro", "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/dz_omar~product-hunt-pro/run-sync": { "post": { "operationId": "run-sync-dz_omar-product-hunt-pro", "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", "required": [ "mode" ], "properties": { "mode": { "title": "๐ŸŽฏ What do you want to scrape?", "enum": [ "today", "leaderboard", "topic", "search", "urls" ], "type": "string", "description": "Pick this first โ€” it decides which section below is used. Each choice has its own settings section; everything belonging to the other choices is ignored, and the run log says so. ๐Ÿ”ฅ Today's launches needs nothing else.", "default": "today" }, "leaderboardPeriod": { "title": "๐Ÿ“… Leaderboard period", "enum": [ "daily", "weekly", "monthly", "yearly" ], "type": "string", "description": "Daily gives one day's top products. Weekly, monthly and yearly give the best of that whole period, ranked as Product Hunt ranks them.", "default": "daily" }, "leaderboardDate": { "title": "๐Ÿ“† Date", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Which day, week, month or year to pull, as YYYY-MM-DD. Leave empty for the most recent. Examples: 2026-09-08 with Daily gives that day; with Weekly gives Mon 7 โ€“ Sun 13 Sep 2026; with Monthly gives all of September 2026; with Yearly gives all of 2026." }, "topic": { "title": "๐Ÿท๏ธ Topic", "enum": [ "productivity", "tech", "developer-tools", "artificial-intelligence", "marketing", "user-experience", "design-tools", "internet-of-things", "wearables", "analytics", "home", "growth-hacking", "photography", "web-app", "books", "bots", "ios", "mac", "games", "api-1", "social-media", "task-management", "health-fitness", "education", "slack", "prototyping", "product-hunt", "open-source", "writing", "android", "music", "chrome-extensions", "messaging", "social-network", "venture-capital", "fintech", "virtual-reality", "augmented-reality", "touch-bar-apps", "saas", "software-engineering", "streaming-services", "travel", "e-commerce", "github", "crypto", "branding", "seo", "news", "email", "email-marketing", "calendar", "freelance", "global-nomad", "linkedin", "advertising", "coffee", "investing", "crowdfunding", "gifs", "twitter", "spotify", "startup-books", "instagram", "imessage-apps", "drones", "sales", "design-books", "wordpress", "a-b-testing", "art", "snapchat", "typography", "sketch", "search", "medium", "amazon", "youtube", "text-editors", "virtual-assistants", "apple", "hiring", "movies", "reddit", "biohacking", "fashion", "languages", "photoshop", "payments", "climate-tech", "maps", "customer-communication", "windows", "meditation", "menu-bar-apps", "newsletters", "video-streaming", "time-tracking", "emoji", "funny", "hardware", "sports", "privacy", "facebook-messenger", "robots", "spreadsheets", "website-builder", "web-design", "icons", "3d-printer", "wi-fi", "cooking", "free-games", "public-relations", "space", "alexa-skills", "notes", "business", "pokemon", "beauty", "home-automation", "web3", "startup-lessons", "linux", "outdoors", "ipad", "vacation", "indie-games", "storage", "on-demand", "ux-design", "delivery", "health", "anonymous", "blockchain", "meetings", "wallpaper", "finance", "cars", "customer-success", "legal", "events", "development", "social-media-marketing", "no-code", "data-analytics", "strategy-games", "apple-watch", "cryptocurrency", "backpacks", "transportation", "tv", "side-project", "ridesharing", "dating", "board-games", "browser-extensions", "design", "telegram", "ebook-reader", "pc", "soundcloud", "dogs", "pets", "science-books", "money", "drinking", "couples", "apple-tv", "accessories", "growth-hacks", "graphics-design", "parenting", "charity-giving", "puzzle-games", "emulators", "standing-desks", "adventure-games", "politics", "marketing-automation", "remote-work", "comics-graphic-novels", "ad-blockers", "safari-extensions", "kids", "jewelry", "data-science", "cats", "batteries", "business-intelligence", "online-learning", "card-games", "data-visualization", "art-books", "medical", "action-games", "sneakers-shoes", "football", "oculus-rift", "biking", "history-books", "affiliate-marketing", "open-world-games", "retro-games", "moving-storage", "gear-vr", "weather", "social-impact", "graphic-design", "community", "star-wars", "adult-coloring-books", "wine", "quantified-self", "playstation", "party", "crafting-games", "personal-finance", "security", "food-drink", "maker-tools", "sci-fi-games", "novels", "rpgs", "cookbooks", "simulation-games", "tech-news", "digital-art", "arkit", "fantasy-games", "djing", "data", "soccer", "animation", "computers", "alarms", "word-games", "custom-keyboards", "nft", "notion", "beauty-fashion", "fashion-books", "database", "career", "funny-games", "basketball", "consulting", "platformers", "audio", "yoga-books", "sports-games", "design-resources", "tabletop-games", "crm", "celebrities", "influencer-marketing", "xbox", "3d-modeling", "photo-video", "human-resources", "entertainment", "video", "work-in-progress", "bitcoin", "design-templates", "accounting", "cannabis", "playstation-vr", "business-travel", "development-language", "fitness", "social-networking", "surfing", "lifestyle", "swimming", "horror-games", "logo-design", "monetization", "mmos", "nintendo", "banking", "shopping", "crime-books", "driving-games", "historical-games", "illustration", "clothing", "first-person-shooter", "photo-editing", "home-improvement", "construction", "fundraising", "diversity-inclusion", "science", "isometric-games", "defi", "health-news", "skateboarding", "interior-design", "golf", "femtech", "horror-books", "hacking", "operations", "tennis", "fighting-games", "thriller-books", "business-books", "donald-trump", "tower-defense-games", "home-services", "zombie-games", "boxing", "coding-books", "kanye-west", "htc-vive", "diy", "electronic-music", "drawing", "change-management", "baseball", "marketing-attribution", "event-marketing", "budgeting", "dj-khaled", "spirituality", "ethereum", "nutrition", "home-office", "graphics", "food-delivery", "crafting", "cosmetics", "furniture", "statistical-analysis", "dao", "drake", "nature-outdoors", "family", "dapp", "nature", "wii-u", "video-art", "comedy", "sdk", "wireframing", "painting", "vita", "electric-cars", "cell-phone", "live-music", "kids-parenting", "hotels", "encryption", "lgbtq", "physics", "school", "vibe-coding", "camping", "printing", "calligraphy", "hiking", "farming", "credit-card", "live-events", "mixed-reality", "aquarium", "chat-rooms", "marketing-calendar", "vpn", "password-manager", "plants", "running", "classical-music", "appliances", "memes", "home-security", "political-news", "inclusivity", "video-cameras", "weightlifting", "coloring", "extended-reality", "local-news", "concerts", "pop-culture", "modeling", "edge-extensions", "streetwear", "motorcycles", "dieting", "survival", "intimacy", "personal-shopper", "babies", "alcohol", "webcam", "hip-hop", "toys", "radio", "sensors", "dining", "tablet", "climbing", "gps", "concert", "textbooks", "dslrs", "sporting-events", "ticketing", "neighborhood", "theater", "psychedelics", "military", "snow-sports", "racing", "college-sports", "home-theater", "tuning", "apple-vision-pro", "toddlers", "pregnancy", "yc-application", "vercel-day", "openai-day", "alpha", "pitch-dubai", "pitch-london", "pitch-tel-aviv", "pitch-nyc", "pitch-paris", "pitch-singapore", "pitch-berlin" ], "type": "string", "description": "Pick a Product Hunt topic from the list. The most active topics are at the top." }, "topicPeriod": { "title": "โฑ๏ธ Topic time range", "enum": [ "all", "today", "this_week", "this_year" ], "type": "string", "description": "Which products to return for the chosen topic: the best ever, or only the ones trending right now. Matches the \"Show\" filter in the Product Hunt app.", "default": "all" }, "searchQuery": { "title": "๐Ÿ”Ž Search keyword", "type": "string", "description": "Any words you would type into Product Hunt's own search box, for example \"AI writing\" or \"design tools\"." }, "searchIn": { "title": "๐Ÿ—‚๏ธ Search in", "enum": [ "launches", "products", "people", "discussions" ], "type": "string", "description": "Which of Product Hunt's four search tabs to read. Products returns product pages with their overall rating; People returns maker profiles; Discussions returns forum threads.", "default": "launches" }, "productUrls": { "title": "๐Ÿ”— Product Hunt links", "uniqueItems": true, "type": "array", "description": "Product Hunt URLs to scrape. Supports launches (/posts/โ€ฆ), products (/products/โ€ฆ), topics (/topics/โ€ฆ), maker profiles (/@username) and leaderboards (/leaderboard/daily|weekly|monthly|yearly/โ€ฆ). Leaderboard and topic links return up to 'How many products?' each. Links from other websites are rejected.", "items": { "type": "object", "properties": { "url": { "title": "Product Hunt URL", "description": "A launch, product, topic, maker profile or leaderboard URL on producthunt.com.\n\nExample: https://www.producthunt.com/leaderboard/weekly/2022/49", "type": "string", "pattern": "^https://(www\\.)?producthunt\\.com/.+" } }, "required": [ "url" ] } }, "userLinkContent": { "title": "๐Ÿ‘ค For maker profile links, get", "enum": [ "launches", "upvoted" ], "type": "string", "description": "Only applies to /@username links. Their own launches, or the products they have upvoted.", "default": "launches" }, "includeFollowers": { "title": "๐Ÿ‘ฅ Include followers", "type": "boolean", "description": "Save the people who follow this maker, with their headline, profile and social links.", "default": false }, "maxFollowers": { "title": "๐Ÿ‘ฅ How many followers?", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Fetched 50 at a time. Popular makers have thousands, so keep this modest unless you need them all.", "default": 100 }, "includeFollowing": { "title": "โžก๏ธ Include following", "type": "boolean", "description": "Save the people this maker follows โ€” often a sharper signal of who they actually work with.", "default": false }, "maxFollowing": { "title": "โžก๏ธ How many following?", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Fetched 50 at a time.", "default": 100 }, "maxItems": { "title": "๐Ÿ”ข How many products?", "minimum": 1, "maximum": 100000, "type": "integer", "description": "The most products to save in this run. Start small the first time so you can check the results before running a big job.", "default": 50 }, "includeReviews": { "title": "โญ Include reviews and ratings", "type": "boolean", "description": "Adds user reviews with the star rating, the full review text and who wrote it. Free โ€” there is no extra charge.", "default": true }, "maxReviews": { "title": "โญ How many reviews per product?", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Reviews are fetched 20 at a time, so higher numbers make the run slower. Popular products can have well over a thousand.", "default": 10 }, "includeComments": { "title": "๐Ÿ’ฌ Include launch comments", "type": "boolean", "description": "Adds the launch discussion with the full comment text and each author's profile. Free โ€” there is no extra charge.", "default": false }, "maxComments": { "title": "๐Ÿ’ฌ How many comments per product?", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Comments are fetched 20 at a time, so higher numbers make the run slower.", "default": 10 }, "findEmails": { "title": "๐Ÿ“ง Find company emails", "type": "boolean", "description": "Visits each product's own website and collects any public contact email it finds. Makes the run noticeably slower.", "default": false }, "outputMode": { "title": "๐Ÿงพ How much detail per product?", "enum": [ "full", "lean" ], "type": "string", "description": "\"Everything\" gives all fields. \"Just the essentials\" gives a short record that is easier to read in a spreadsheet or feed to an AI agent.", "default": "full" } } }, "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 } } } } } } } } } }