API Reference

Access weekly Series A predictions for Product Hunt launches.

Authentication

External API requests require an API key passed via the x-api-key header. To request a key, email benchmark@vela.partners.

curl -H "x-api-key: pk_your_key_here" \
  https://phbench.com/api/predictions

GET/api/predictions

Returns scored featured Product Hunt launches, ranked by predicted Series A probability. By default only launches verified as not having raised Series A are included. Pass include_funded=true to receive every launch, each carrying afunding_stage and raised_series_a field so you can filter on your side.

Query Parameters

Parameter	Type	Description
days	int	Look back N days from now. Default: 7
week	string	Monday date in YYYY-MM-DD format. Returns Mon-Sun of that week.
include_funded	bool	Include launches that have already raised Series A+. Default false (funded excluded). Each post always carries funding_stage + raised_series_a.

Examples

# Current week
curl -H "x-api-key: pk_..." https://phbench.com/api/predictions

# Specific week
curl -H "x-api-key: pk_..." https://phbench.com/api/predictions?week=2026-05-12

# Last 14 days
curl -H "x-api-key: pk_..." https://phbench.com/api/predictions?days=14

Response

{
  "count": 9,
  "from": "2026-05-12",
  "to": "2026-05-19",
  "weeks": ["2026-05-12", "2026-05-05"],
  "posts": [
    {
      "id": 1147034,
      "name": "Drizz",
      "slug": "drizz",
      "tagline": "Build dashboards with natural language",
      "votes_count": 200,
      "comments_count": 45,
      "daily_rank": 4,
      "weekly_rank": 12,
      "topics": "Developer Tools|AI",
      "score": 0.32,
      "above_baseline": true,
      "funding_status": "not_funded",
      "funding_stage": "seed",
      "raised_series_a": false,
      "created_at": "2026-05-14T07:01:00+00:00",
      "website_domain": "drizz.dev"
    }
  ]
}

Post Fields

Field	Description
id	Product Hunt post ID
name	Product name
slug	PH URL slug
tagline	One-line product description
votes_count	Total upvotes on launch day
comments_count	Total comments
daily_rank	Rank on Product Hunt for that day (null if unranked)
weekly_rank	Rank for the week
topics	Pipe-separated category tags
score	Model probability of Series A within 18 months (0-1)
above_baseline	Whether score exceeds the 0.78% base rate
funding_stage	Latest financing stage: unknown \| none \| pre_seed \| seed \| series_a \| series_b \| series_c_plus \| public
raised_series_a	True when the company has raised Series A or later (series_a and beyond)
funding_status	Legacy flag, derived: funded when raised_series_a, else not_funded
created_at	Launch timestamp (ISO 8601)
website_domain	Resolved company domain

Rate Limits

No hard rate limits currently enforced. Please be reasonable -- the data updates once per week. Usage is tracked per API key.

About the Model

Predictions are generated by the PHBench champion model (Top-3 ensemble) trained on 67,292 featured Product Hunt launches from 2019-2025, with 528 verified Series A outcomes from Crunchbase. The model uses 68 engineered features from public launch signals. On held-out test data, it achieves 4.7x lift over random. See the paper for details.

phbench.com · Predictions · arXiv · GitHub