--- title: "Retrieve Product Hunt product launches" method: GET path: "/producthunt/product/{id}/launches" tags: ["ProductHunt"] --- # Retrieve Product Hunt product launches `GET /producthunt/product/{id}/launches` ## Request - Base URL: `https://api.crawlora.net/api/v1` - URL: `https://api.crawlora.net/api/v1/producthunt/product/{id}/launches` - Auth: API key in header `x-api-key` Lists the launch posts of a Product Hunt product, looked up by its slug in `id`. `order` defaults to `DATE`; pass the returned `end_cursor` as `cursor` for the next page. Each launch has its name, tagline, ranks, scores, comment count, badges and dates. An unknown slug returns 404. ## Path parameters - `id` string, required ## Query parameters - `cursor` string - `order` string ## Headers - `x-api-key` string, required ## Response `200` Wrapped launches payload - ProducthuntLaunchesResponseDoc - `code` integer - `data` ProducthuntProductLaunchesPage - `connection` string: Kind of list the items come from, for example `posts`. - `end_cursor` string: Cursor of the last launch on this page. Pass it as `cursor` to get the next page. - `has_next_page` boolean: Whether another page of launches follows this one. - `items` ProducthuntProductAboutPost[]: Launch posts of the product, one per entry. - `badges` ProducthuntProductCategoryListBadge[]: Badges the launch has earned, such as leaderboard awards. - `category` string: Award category of the badge, for example `Product of the Year`. Omitted for daily and weekly badges. - `date` string: Date the badge refers to. - `id` string: Product Hunt id of the badge. - `period` string: Period the badge covers, for example `daily` or `weekly`. - `position` integer: Rank the product placed at for this badge. - `post_id` string: Product Hunt id of the launch post the badge was earned on. - `post_name` string: Name of the launch post the badge was earned on. - `post_slug` string: URL slug of the launch post the badge was earned on. - `year` string: Year of the award the badge belongs to. - `comments_count` integer: Number of comments on the launch. - `created_at` string: ISO 8601 timestamp of when the launch was created. - `daily_rank` integer: Rank on the daily leaderboard. `0` when Product Hunt gives no rank. - `disabled_when_scheduled` boolean: Whether upvoting is disabled while the launch is scheduled. - `embargo_preview_at` string: ISO 8601 timestamp of the embargo preview, when the launch has one. - `featured_at` string: ISO 8601 timestamp of when Product Hunt featured the launch. - `has_voted` boolean: Whether the viewer has upvoted this launch. - `hide_votes_count` boolean: Whether the maker hides the vote count for this launch. - `id` string: Product Hunt ID of the launch post. - `latest_score` integer: Current upvote score of the launch. - `launch_day_score` integer: Upvote score the launch had on its launch day. - `monthly_rank` integer: Rank on the monthly leaderboard. `0` when Product Hunt gives no rank. - `name` string: Name of the launch. - `product` ProducthuntLeaderboardProductRef - `id` string: Product Hunt ID of the product. - `is_no_longer_online` boolean: Whether Product Hunt marks the product as no longer online. - `is_subscribed` boolean: Whether the viewer follows this product. - `is_top_product` boolean: Whether Product Hunt marks this as a top product. - `logo_uuid` string: Identifier of the product logo on Product Hunt's image host. - `name` string: Name of the product. - `slug` string: URL slug of the product. Use it with the product endpoint. - `product_state` string: Product Hunt's state label for the product, for example `default`. - `randomization_status` ProducthuntLeaderboardRandomizationStatus - `active` boolean: Whether randomization is currently in effect. - `next_transition_at` string: ISO 8601 timestamp of the next change to the randomization state, when there is one. - `random_day` boolean: Whether the launch day is randomized. - `randomize_order` boolean: Whether the order of this launch among others is randomized. - `redirect_to_product` ProducthuntLeaderboardProductRef - `id` string: Product Hunt ID of the product. - `is_no_longer_online` boolean: Whether Product Hunt marks the product as no longer online. - `is_subscribed` boolean: Whether the viewer follows this product. - `is_top_product` boolean: Whether Product Hunt marks this as a top product. - `logo_uuid` string: Identifier of the product logo on Product Hunt's image host. - `name` string: Name of the product. - `slug` string: URL slug of the product. Use it with the product endpoint. - `shortened_url` string: Short Product Hunt link to the launch. - `slug` string: URL slug of the launch post. - `tagline` string: Short tagline of the launch. - `thumbnail_image_uuid` string: Identifier of the launch thumbnail image on Product Hunt's image host. - `updated_at` string: ISO 8601 timestamp of the last update to the launch. - `weekly_rank` integer: Rank on the weekly leaderboard. `0` when Product Hunt gives no rank. - `name` string: Name of the product. - `order` string: Order the launches are sorted in, for example `DATE`. - `product_id` string: Product Hunt id of the product. - `raw_page_info` object: Pagination details for this page as Product Hunt returns them. - `slug` string: URL slug of the product on Product Hunt. - `total_count` integer: Total number of launches the product has. - `msg` string ## Other responses - `400`: Missing or invalid parameters - `404`: Product not found - `429`: Rate limit exceeded - `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/028417aa35bb?raw)