Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

period
enum<string>

Leaderboard window (default daily)

Available options:
daily,
weekly,
monthly
date
string

Date the leaderboard is anchored to (YYYY-MM-DD, daily/weekly only). Defaults to today.

Pattern: ^\d{4}-\d{2}-\d{2}$
category
string

Topic slug to filter by, e.g. 'artificial-intelligence'

Minimum string length: 1
full_list

Scroll to load the full list instead of just the first ~19 products (default false, extra cost)

Response

Structured Product Hunt leaderboard.

provider
enum<string>
required
Available options:
product_hunt
page_type
enum<string>
required
Available options:
leaderboard
snapshot_at
string<date-time>
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
period
enum<string>
required
Available options:
daily,
weekly,
monthly
date
string | null
required
category
string | null
required
products
object[]
required
truncated
boolean
required
url
string<uri>
required