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

# Search the Product Hunt products dataset

`GET /datasets/producthunt-products/search`

## Request

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

Searches individual Product Hunt launches from the dataset id enum value `producthunt-products` — the searchable launch archive. Each result is one product with its topics, upvotes, ranks and launch history; description/website/twitter_url/pricing/makers are filled in over time. Sort enum: `relevance`, `votes_desc`, `launched_desc`, `launched_asc`, `rating_desc`, `best_rank_asc`. 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

- `q` string
- `topic` string
- `maker` string
- `launched_after` string
- `launched_before` string
- `min_votes` integer
- `min_rating` number
- `pricing_type` string
- `has_website` boolean
- `is_online` boolean
- `sort` 'relevance' | 'votes_desc' | 'launched_desc' | 'launched_asc' | 'rating_desc' | 'best_rank_asc'
- `page` integer
- `page_size` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- DatasetsProducthuntProductsSearchResponseDoc
  - `code` integer
  - `data` DatasetsProductHuntProductsSearchResponse
    - `dataset` string: Identifier of the dataset queried (`producthunt-products`).
    - `items` EsProductHuntProductItem[]: Matching Product Hunt product records on this page.
      - `best_daily_rank` integer: Best position the product reached on a Product Hunt daily leaderboard.
      - `best_monthly_rank` integer: Best position the product reached on a Product Hunt monthly leaderboard.
      - `best_weekly_rank` integer: Best position the product reached on a Product Hunt weekly leaderboard.
      - `comments_count` integer: Number of comments on the product's Product Hunt page.
      - `description` string: Product description as the maker wrote it on Product Hunt.
      - `first_launch_date` string: Date of the product's earliest launch, in YYYY-MM-DD format.
      - `followers_count` integer: Number of Product Hunt users following the product.
      - `is_no_longer_online` boolean: Whether Product Hunt marks the product as no longer online.
      - `is_top_product` boolean: Whether Product Hunt flags the product as a top product.
      - `latest_launch_date` string: Date of the product's most recent launch, in YYYY-MM-DD format.
      - `latest_score` integer: Current upvote count of the product.
      - `launch_count` integer: Number of times the product has launched on Product Hunt.
      - `launch_year` integer: Year of the product's first launch.
      - `launches` EsProductHuntLaunch[]: Each launch of the product on Product Hunt, with its date, ranks and score.
        - `daily_rank` integer: Rank on the Product Hunt daily leaderboard for the launch day.
        - `date` string: Launch date, in YYYY-MM-DD format.
        - `launch_day_score` integer: Score the launch had on its launch day.
        - `launch_number` integer: Sequence number of this launch among the product's Product Hunt launches.
        - `monthly_rank` integer: Rank on the Product Hunt monthly leaderboard.
        - `post_id` string: Product Hunt identifier of the launch post.
        - `post_slug` string: URL slug of the launch post on Product Hunt.
        - `score` integer: Upvote count of the launch post.
        - `weekly_rank` integer: Rank on the Product Hunt weekly leaderboard.
      - `logo_uuid` string: Identifier of the product logo image on Product Hunt.
      - `makers` EsProductHuntMaker[]: People credited as makers of the product.
        - `avatar_url` string: URL of the maker's profile picture.
        - `headline` string: Short headline from the maker's Product Hunt profile.
        - `maker_id` string: Product Hunt identifier of the maker.
        - `name` string: Maker's display name.
        - `username` string: Maker's Product Hunt username. Use it with the maker item endpoint.
      - `name` string: Product name as shown on Product Hunt.
      - `pricing_type` string: Pricing model of the product, such as `free`, `paid` or `freemium`.
      - `primary_topic` string: Slug of the product's main topic.
      - `product_id` string: Product Hunt identifier of the product.
      - `product_state` string: Lifecycle state of the product as Product Hunt reports it.
      - `reviews_count` integer: Number of reviews the product has on Product Hunt.
      - `reviews_rating` number: Average review rating out of 5.
      - `slug` string: URL slug of the product on Product Hunt. Use it with the product item endpoint.
      - `tagline` string: One-line tagline of the product.
      - `topic_slugs` string[]: Slugs of all topics the product is filed under.
      - `topics` EsProductHuntTopic[]: Topics the product is filed under.
        - `id` string: Product Hunt identifier of the topic.
        - `name` string: Topic name as Product Hunt shows it.
        - `slug` string: URL slug of the topic on Product Hunt.
      - `twitter_url` string: URL of the product's X (Twitter) profile.
      - `url` string: URL of the product's page on Product Hunt.
      - `website` string: URL of the product's own website.
      - `won_daily` boolean: Whether the product ranked first on a Product Hunt daily leaderboard.
    - `page` integer: Page number returned.
    - `page_size` integer: Number of items per page.
    - `sort` string: Sort order applied.
    - `total` integer: Total number of records matching the filters.
  - `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)