POST /api/producthunt/lists — Product Hunt products with founders, makers, emails, socials and launch stats.
| Field | Type | Notes |
|---|---|---|
mode | string | "launches", "leaderboard", "search" or "urls". |
keyword | string | Search mode. |
urls | string[] or string | Urls mode: product, leaderboard, category, topic or search pages. Up to 50. |
maxResults | integer | 1–1000. Default 50. |
filters.launchedWithin | string | Launches mode: today, yesterday, last7days, last30days, anytime. |
filters.categories | string[] | Launches mode: category slugs, e.g. ai-software, ai-agents, data-analysis, design-creative, ecommerce, engineering-development, finance, health-fitness, marketing-sales, no-code-platforms, productivity, social-community, travel, web3 (a top-level category includes its subcategories). |
filters.includeNonFeatured | boolean | Launches without categories: include non-featured launches. |
filters.sortOrder | string | highest_rated, best_rated, most_recent, most_followed, trending. |
filters.leaderboardPeriod | string | Leaderboard mode: daily, weekly, monthly, yearly. |
filters.leaderboardDate | string | YYYY-MM-DD to start from (default: today). |
filters.leaderboardPeriodsBack | integer | 1–31 periods. |
filters.onlyWithEmail | boolean | Skip products with no email found. |
curl -X POST https://prospectcheap.com/api/producthunt/lists \
-H "Authorization: Bearer pc_live_your_key" \
-H "Content-Type: application/json" \
-d '{"mode":"search","keyword":"crm","maxResults":50}'Then
The response has list.id. Poll GET /api/producthunt/lists/{id} until list.status is completed (or failed); the results are under products. See Search Status, Filter & Paginate and Export CSV.
Credits: one per result found. The most the search could cost is reserved when it starts; what isn't used comes back when it finishes.