---
title: "Search the Product Hunt trends dataset"
method: GET
path: "/datasets/producthunt-trends/search"
tags: ["Datasets"]
---

# Search the Product Hunt trends dataset

`GET /datasets/producthunt-trends/search`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/datasets/producthunt-trends/search`
- Auth: API key in header `x-api-key`

Returns aggregate Product Hunt launch trends from the dataset id enum value `producthunt-trends`. Aggregate-only: each row is a category-over-time cell (a topic, optionally within a calendar period), reporting launch count, total and average upvotes, average rating and the top product — never an individual product record. Thin cells are suppressed. group_by enum: `topic_month`, `topic_year`, `topic`. Sort enum: `period_desc`, `period_asc`, `launch_count_desc`, `sum_votes_desc`. Billing: this search costs 1 credit per record returned, with a minimum of 2 (an empty result costs 2, a full page of 100 costs 100).

## Query parameters

- `group_by` 'topic_month' | 'topic_year' | 'topic'
- `topic` string
- `launched_after` string
- `launched_before` string
- `min_votes` integer
- `min_launches` integer
- `sort` 'period_desc' | 'period_asc' | 'launch_count_desc' | 'sum_votes_desc'
- `page` integer
- `page_size` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- DatasetsProducthuntTrendsSearchResponseDoc
  - `code` integer
  - `data` DatasetsProductHuntTrendsSearchResponse
    - `dataset` string: Identifier of the dataset queried (`producthunt-trends`).
    - `group_by` string: Dimension the cells are grouped by: `topic_month`, `topic_year` or `topic`.
    - `items` EsProductHuntTrendCell[]: Aggregate launch-trend cells on this page, one per group.
      - `avg_rating` number: Average review rating out of 5 across the cell's launches. Omitted when too few launches have ratings.
      - `avg_votes` number: Average upvotes per launched product in the cell.
      - `launches` integer: Number of product launches in the cell.
      - `period` string: "2024-01" | "2024" | "" for all-time
      - `top_product` EsProductHuntTrendTopProduct
        - `name` string: Product name as shown on Product Hunt.
        - `slug` string: URL slug of the product on Product Hunt.
        - `votes` integer: Upvote count of the product.
      - `topic` string: Slug of the Product Hunt topic the cell covers.
      - `total_votes` integer: Total upvotes across the launches in the cell.
    - `min_launches` integer: Minimum number of launches a cell needs to be included.
    - `page` integer: Page number returned.
    - `page_size` integer: Number of items per page.
    - `sort` string: Sort order applied.
    - `total` integer: Total number of cells.
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)