---
title: "Retrieve Product Hunt product customers"
method: GET
path: "/producthunt/product/{id}/customers"
tags: ["ProductHunt"]
---

# Retrieve Product Hunt product customers

`GET /producthunt/product/{id}/customers`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/producthunt/product/{id}/customers`
- Auth: API key in header `x-api-key`

Lists the customer products of a Product Hunt product, looked up by its slug in `id`. `order` is `customers` (default) or `latest_launch`, `page` defaults to 1 and `page_size` to 10. Each item has its name, categories, badges, review and follower counts, and founder shoutouts. An unknown slug returns 404.

## Path parameters

- `id` string, required

## Query parameters

- `order` 'customers' | 'latest_launch'
- `page` integer
- `page_size` integer

## Headers

- `x-api-key` string, required

## Response `200`

Wrapped customers payload

- ProducthuntCustomersResponseDoc
  - `code` integer
  - `data` ProducthuntProductCustomersPage
    - `connection` string: Kind of list the items come from, for example `customers`.
    - `end_cursor` string: Cursor of the last item on this page. Omitted when Product Hunt returns none.
    - `has_next_page` boolean: Whether another page of customers follows this one.
    - `has_previous_page` boolean: Whether a page of customers precedes this one.
    - `items` ProducthuntProductCategoryListProduct[]: Products that are customers of the product, one per entry.
      - `badges` ProducthuntProductCategoryListBadge[]: Badges the product has earned on Product Hunt.
        - `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.
      - `categories` ProducthuntProductCategoryRef[]: Product Hunt categories the product is listed in.
        - `id` string: Product Hunt id of the category.
        - `name` string: Name of the category as shown on Product Hunt.
        - `path` string: Path of the category page on Product Hunt.
        - `slug` string: URL slug of the category.
      - `detailed_reviews_count` integer: Number of detailed reviews the product has.
      - `followers_count` integer: Number of Product Hunt users following the product.
      - `founder_reviews_count` integer: Number of reviews written by the product's founders.
      - `founder_shoutouts` ProducthuntProductCategoryFounderShoutout[]: Shoutouts the product received from other founders.
        - `from_post` ProducthuntProductCategoryFounderPost
          - `badges` ProducthuntProductCategoryListBadge[]: Badges the launch post has earned.
            - `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.
          - `id` string: Product Hunt id of the launch post.
          - `name` string: Name of the launch post.
          - `product_id` string: Product Hunt id of the product the post belongs to.
          - `product_slug` string: URL slug of the product the post belongs to.
          - `product_state` string: State of the product on Product Hunt, for example `default`.
          - `slug` string: URL slug of the launch post.
          - `thumbnail_image_uuid` string: Identifier of the launch post's thumbnail image file.
        - `id` string: Product Hunt id of the shoutout.
        - `product_id` string: Product Hunt id of the product that received the shoutout.
      - `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 requesting viewer follows the product.
      - `is_top_product` boolean: Whether Product Hunt flags the product as a top product.
      - `latest_launch` ProducthuntProductCategoryLatestLaunch
        - `id` string: Product Hunt id of the product's latest launch.
        - `scheduled_at` string: Time the latest launch was scheduled for, in ISO 8601 with a UTC offset.
      - `logo_uuid` string: Identifier of the product's logo image file.
      - `name` string: Name of the product as shown on Product Hunt.
      - `posts_count` integer: Number of launch posts the product has.
      - `reviews_count` integer: Number of reviews the product has.
      - `reviews_rating` number: Average review rating of the product.
      - `slug` string: URL slug of the product on Product Hunt.
      - `structured_data` ProducthuntProductAlternativeStructuredData
        - `application_category` string: Schema.org application category of the product.
        - `context` string: Schema.org context URL of the product's structured data block.
        - `date_modified` string: Date the product page was last modified.
        - `date_published` string: Date the product was published on Product Hunt.
        - `description` string: Product description as given in its structured data.
        - `id` string: Identifier of the product in its structured data block.
        - `image` string: URL of the product's main image.
        - `name` string: Product name as given in its structured data.
        - `operating_system` string: Operating systems the product runs on, as listed in its structured data.
        - `screenshot` string[]: URLs of the product's screenshots.
        - `url` string: Product Hunt page URL of the product.
      - `tagline` string: Short tagline of the product.
      - `tags` string[]: Tags describing the product.
    - `name` string: Name of the product.
    - `order` string: Order the customers are sorted in, `customers` or `latest_launch`.
    - `page` integer: Page number returned.
    - `page_size` integer: Number of customers requested per page.
    - `pages_count` integer: Total number of pages of customers.
    - `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 customers 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/afac9b012a27?raw)
