> ## Documentation Index
> Fetch the complete documentation index at: https://clair.im/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Product Hunt Launches API

> Product Hunt API for daily launches. List today's Pacific-time homepage or a past leaderboard by date. Optional q filter. Rank index — open a slug for the full product page.

Live scrape of **Product Hunt** public pages. `GET /v1/launches` is the daily
rank index. Pass `results[].slug` to [`GET /v1/launches/product`](/docs/producthunt-api/product)
for hunter, makers, comments, and contact.

It does not log in, vote, comment, or call Product Hunt's private GraphQL API.

See the [product page](https://clair.im/dashboard/apis/producthunt) and
[launch tracking use case](https://clair.im/resources/use-cases/product-launches).

## Endpoint

`GET /v1/launches` · **8 credits**

```sh theme={null}
curl -G https://api.clair.im/v1/launches \
  -H "Authorization: Bearer YOUR_KEY" \
  --data-urlencode "date=2026-05-22" \
  --data-urlencode "q=linear"
```

## Parameters

| Parameter | Required | Contract                                                                        |
| --------- | -------- | ------------------------------------------------------------------------------- |
| `date`    | no       | Product Hunt calendar day as `YYYY-MM-DD` (Pacific time). Omit for today.       |
| `q`       | no       | Keep launches whose name, tagline, slug, or topic contain this text.            |
| `page`    | no       | Must be 1. The daily leaderboard is a single listing page. Do not send `limit`. |

## Response

```json theme={null}
{
  "date": "2026-08-22",
  "url": "https://www.producthunt.com/",
  "count": 1,
  "results": [
    {
      "id": "42",
      "name": "Linear",
      "tagline": "Issue tracking for software teams",
      "slug": "linear",
      "url": "https://www.producthunt.com/posts/linear",
      "website": "https://linear.app/",
      "votes": 1280,
      "comments": 90,
      "rank": 1,
      "topics": ["Developer Tools"],
      "thumbnail": "https://ph-files.imgix.net/linear.png"
    }
  ],
  "next_cursor": null
}
```

Auth, credits, and error codes: [Authentication](/docs/authentication).