---
canonical_url: "https://docs.composio.dev/toolkits/product_hunt"
markdown_url: "https://docs.composio.dev/toolkits/product_hunt.md"
product: "platform"
version: null
last_updated: null
---

# Product Hunt

Product Hunt is a community platform for discovering, discussing, and following new technology products.

- **Category:** product management
- **Auth:** OAUTH2, BEARER_TOKEN
- **Composio-managed OAuth available?** No
- **Tools:** 24
- **Triggers:** 0
- **Slug:** `PRODUCT_HUNT`
- **Version:** 00000000_00

## Tools

### Follow User

**Slug:** `PRODUCT_HUNT_FOLLOW_USER`

Follow a Product Hunt user as the connected viewer. Product Hunt must separately approve write access for the application; OAuth write consent alone is insufficient.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | Yes | ID of the Product Hunt user to follow. |
| `client_mutation_id` | string | No | Optional caller correlation ID echoed by Product Hunt. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Collection

**Slug:** `PRODUCT_HUNT_GET_COLLECTION`

Get one published Product Hunt collection by ID or slug, including its supported fields and owner; use the dedicated collection connection tools for posts and topics.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `collection_id` | string | No | Collection ID; provide exactly one of collection_id or collection_slug. |
| `collection_slug` | string | No | Collection slug; provide exactly one of collection_id or collection_slug. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Comment

**Slug:** `PRODUCT_HUNT_GET_COMMENT`

Get one Product Hunt comment by ID, including its author, parent summary, vote state, and vote count.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `comment_id` | string | Yes | Comment ID to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Post

**Slug:** `PRODUCT_HUNT_GET_POST`

Get one Product Hunt post by ID or slug, including ranks, counts, maker and submitter details, media, links, and viewer vote and collection state.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `post_id` | string | No | Post ID; provide exactly one of post_id or post_slug. |
| `post_slug` | string | No | Post slug; provide exactly one of post_id or post_slug. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Topic

**Slug:** `PRODUCT_HUNT_GET_TOPIC`

Get one Product Hunt topic by ID or slug, including its description, counts, image, URL, and viewer follow state.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `topic_id` | string | No | Topic ID; provide exactly one of topic_id or topic_slug. |
| `topic_slug` | string | No | Topic slug; provide exactly one of topic_id or topic_slug. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User

**Slug:** `PRODUCT_HUNT_GET_USER`

Get one Product Hunt user by ID or username. Non-viewer profiles may be privacy-redacted; check redacted before relying on identity data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | No | User ID; provide exactly one of user_id or username. |
| `username` | string | No | Product Hunt username; provide exactly one of user_id or username. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Viewer

**Slug:** `PRODUCT_HUNT_GET_VIEWER`

Return the fully populated Product Hunt user associated with the connected OAuth access token or developer token.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Collection Posts

**Slug:** `PRODUCT_HUNT_LIST_COLLECTION_POSTS`

List one forward or backward Relay page of complete posts contained in one Product Hunt collection identified by ID or slug.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Opaque cursor from a prior page; its meaning follows direction. |
| `direction` | string ("FORWARD" | "BACKWARD") | No | Traverse after the cursor or backward before it. |
| `page_size` | integer | No | Posts to return on this page (1-20). |
| `collection_id` | string | No | Collection ID; provide exactly one of collection_id or collection_slug. |
| `collection_slug` | string | No | Collection slug; provide exactly one of collection_id or collection_slug. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Collections

**Slug:** `PRODUCT_HUNT_LIST_COLLECTIONS`

List one page of Product Hunt collections, optionally filtering by featured status, post, or owner and ordering the results. Supports forward and backward Relay traversal.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `order` | string ("FEATURED_AT" | "FOLLOWERS_COUNT" | "NEWEST") | No | Order in which to return collections. |
| `cursor` | string | No | Opaque cursor from a prior page. Pass it back unchanged; its meaning follows direction. |
| `post_id` | string | No | Only return collections containing this post ID. |
| `user_id` | string | No | Only return collections owned by this user ID. |
| `featured` | boolean | No | Only return featured or non-featured collections when set. |
| `direction` | string ("FORWARD" | "BACKWARD") | No | Traverse after the cursor or backward before it. |
| `page_size` | integer | No | Collections to return on this page (1-20). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Collection Topics

**Slug:** `PRODUCT_HUNT_LIST_COLLECTION_TOPICS`

List one forward or backward Relay page of complete topics associated with one Product Hunt collection identified by ID or slug.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Opaque cursor from a prior page; its meaning follows direction. |
| `direction` | string ("FORWARD" | "BACKWARD") | No | Traverse after the cursor or backward before it. |
| `page_size` | integer | No | Topics to return on this page (1-20). |
| `collection_id` | string | No | Collection ID; provide exactly one of collection_id or collection_slug. |
| `collection_slug` | string | No | Collection slug; provide exactly one of collection_id or collection_slug. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Comment Replies

**Slug:** `PRODUCT_HUNT_LIST_COMMENT_REPLIES`

List direct replies to one Product Hunt comment, ordered by newest or vote count, one forward or backward Relay page at a time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `order` | string ("NEWEST" | "VOTES_COUNT") | No | Order in which to return replies. |
| `cursor` | string | No | Opaque cursor from a prior page; its meaning follows direction. |
| `direction` | string ("FORWARD" | "BACKWARD") | No | Traverse after the cursor or backward before it. |
| `page_size` | integer | No | Replies to return on this page (1-20). |
| `comment_id` | string | Yes | Parent comment ID whose direct replies to return. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Comment Votes

**Slug:** `PRODUCT_HUNT_LIST_COMMENT_VOTES`

List one forward or backward Relay page of individual votes on a Product Hunt comment, optionally limited to a creation-time range. Nested voter profiles may be privacy-redacted; use each vote's user_id as the voter ID and check user.redacted before using nested identity fields.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Opaque cursor from a prior page; its meaning follows direction. |
| `direction` | string ("FORWARD" | "BACKWARD") | No | Traverse after the cursor or backward before it. |
| `page_size` | integer | No | Votes to return on this page (1-20). |
| `comment_id` | string | Yes | Comment ID whose votes to return. |
| `created_after` | string | No | Only return votes created after this ISO 8601 timestamp. |
| `created_before` | string | No | Only return votes created before this ISO 8601 timestamp. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Post Collections

**Slug:** `PRODUCT_HUNT_LIST_POST_COLLECTIONS`

List one forward or backward Relay page of collections containing one Product Hunt post identified by ID or slug.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Opaque cursor from a prior page; its meaning follows direction. |
| `post_id` | string | No | Post ID; provide exactly one of post_id or post_slug. |
| `direction` | string ("FORWARD" | "BACKWARD") | No | Traverse after the cursor or backward before it. |
| `page_size` | integer | No | Collections to return on this page (1-20). |
| `post_slug` | string | No | Post slug; provide exactly one of post_id or post_slug. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Post Comments

**Slug:** `PRODUCT_HUNT_LIST_POST_COMMENTS`

List one forward or backward Relay page of complete comments and authors on a Product Hunt post identified by ID or slug, ordered by newest or votes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `order` | string ("NEWEST" | "VOTES_COUNT") | No | Order comments by newest first or by vote count. |
| `cursor` | string | No | Opaque cursor from a prior page; its meaning follows direction. |
| `post_id` | string | No | Post ID; provide exactly one of post_id or post_slug. |
| `direction` | string ("FORWARD" | "BACKWARD") | No | Traverse after the cursor or backward before it. |
| `page_size` | integer | No | Comments to return on this page (1-20). |
| `post_slug` | string | No | Post slug; provide exactly one of post_id or post_slug. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Posts

**Slug:** `PRODUCT_HUNT_LIST_POSTS`

List and filter Product Hunt posts by date, topic, URL, featured status, or ordering, one forward or backward Relay page at a time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | No | Only return posts matching this product URL. |
| `order` | string ("FEATURED_AT" | "NEWEST" | "RANKING" | "VOTES") | No | Order in which to return posts. |
| `topic` | string | No | Only return posts associated with this topic slug. |
| `cursor` | string | No | Opaque cursor from a prior page; its meaning follows direction. |
| `featured` | boolean | No | Only return featured or non-featured posts when set. |
| `direction` | string ("FORWARD" | "BACKWARD") | No | Traverse after the cursor or backward before it. |
| `page_size` | integer | No | Posts to return on this page (1-20). |
| `twitter_url` | string | No | Only return posts matching this Twitter/X URL. |
| `posted_after` | string | No | Only return posts published after this ISO 8601 timestamp. Product Hunt otherwise defaults to roughly one month ago. |
| `posted_before` | string | No | Only return posts published before this ISO 8601 timestamp. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Post Topics

**Slug:** `PRODUCT_HUNT_LIST_POST_TOPICS`

List one forward or backward Relay page of complete topics associated with one Product Hunt post identified by ID or slug.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Opaque cursor from a prior page; its meaning follows direction. |
| `post_id` | string | No | Post ID; provide exactly one of post_id or post_slug. |
| `direction` | string ("FORWARD" | "BACKWARD") | No | Traverse after the cursor or backward before it. |
| `page_size` | integer | No | Topics to return on this page (1-20). |
| `post_slug` | string | No | Post slug; provide exactly one of post_id or post_slug. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Topics

**Slug:** `PRODUCT_HUNT_LIST_TOPICS`

List or search Product Hunt topics, optionally restricting them to topics followed by a user, one forward or backward Relay page at a time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `order` | string ("FOLLOWERS_COUNT" | "NEWEST") | No | Order in which to return topics. |
| `query` | string | No | Text to search for in topics. |
| `cursor` | string | No | Opaque cursor from a prior page; its meaning follows direction. |
| `direction` | string ("FORWARD" | "BACKWARD") | No | Traverse after the cursor or backward before it. |
| `page_size` | integer | No | Topics to return on this page (1-20). |
| `followed_by_user_id` | string | No | Only return topics followed by this user ID. Product Hunt spells the GraphQL argument exactly followedByUserid. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Followed Collections

**Slug:** `PRODUCT_HUNT_LIST_USER_FOLLOWED_COLLECTIONS`

List one forward or backward Relay page of collections followed by a Product Hunt user. Results are reliable for the connected viewer; check redacted before interpreting an empty non-viewer result.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Opaque cursor from a prior page; its meaning follows direction. |
| `user_id` | string | No | User ID; provide exactly one of user_id or username. |
| `username` | string | No | Product Hunt username; provide exactly one of user_id or username. |
| `direction` | string ("FORWARD" | "BACKWARD") | No | Traverse after the cursor or backward before it. |
| `page_size` | integer | No | Collections to return on this page (1-20). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Followers (Deprecated)

**Slug:** `PRODUCT_HUNT_LIST_USER_FOLLOWERS`

List one forward or backward Relay page of followers through Product Hunt's deprecated User.followers field, which is scheduled for removal. Use Get User and followersCount when only the count is needed. Non-viewer identities and connections may be privacy-redacted, so a redacted empty result does not prove that the user has no followers.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Opaque cursor from a prior page; its meaning follows direction. |
| `user_id` | string | No | User ID; provide exactly one of user_id or username. |
| `username` | string | No | Product Hunt username; provide exactly one of user_id or username. |
| `direction` | string ("FORWARD" | "BACKWARD") | No | Traverse after the cursor or backward before it. |
| `page_size` | integer | No | Followers to return on this page (1-20). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Following (Deprecated)

**Slug:** `PRODUCT_HUNT_LIST_USER_FOLLOWING`

List one forward or backward Relay page of users followed by a Product Hunt user. The following field is deprecated and scheduled for removal; use Get User when only followingCount is needed. Non-viewer profiles and connections may be privacy-redacted, so check redacted before interpreting identity values or an empty result.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Opaque cursor from a prior page; its meaning follows direction. |
| `user_id` | string | No | User ID; provide exactly one of user_id or username. |
| `username` | string | No | Product Hunt username; provide exactly one of user_id or username. |
| `direction` | string ("FORWARD" | "BACKWARD") | No | Traverse after the cursor or backward before it. |
| `page_size` | integer | No | Users to return on this page (1-20). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Made Posts

**Slug:** `PRODUCT_HUNT_LIST_USER_MADE_POSTS`

List one forward or backward Relay page of complete posts a Product Hunt user is credited with making. Check redacted before treating an empty result as authoritative.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Opaque cursor from a prior page; its meaning follows direction. |
| `user_id` | string | No | User ID; provide exactly one of user_id or username. |
| `username` | string | No | Product Hunt username; provide exactly one of user_id or username. |
| `direction` | string ("FORWARD" | "BACKWARD") | No | Traverse after the cursor or backward before it. |
| `page_size` | integer | No | Posts to return on this page (1-20). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Submitted Posts

**Slug:** `PRODUCT_HUNT_LIST_USER_SUBMITTED_POSTS`

List one forward or backward Relay page of complete posts submitted by a Product Hunt user identified by ID or username. Non-viewer relationships may be privacy-redacted; check redacted before interpreting an empty page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Opaque cursor from a prior page; its meaning follows direction. |
| `user_id` | string | No | User ID; provide exactly one of user_id or username. |
| `username` | string | No | Product Hunt username; provide exactly one of user_id or username. |
| `direction` | string ("FORWARD" | "BACKWARD") | No | Traverse after the cursor or backward before it. |
| `page_size` | integer | No | Posts to return on this page (1-20). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List User Voted Posts

**Slug:** `PRODUCT_HUNT_LIST_USER_VOTED_POSTS`

List one forward or backward Relay page of complete posts voted for by the connected Product Hunt viewer. Arbitrary non-viewer vote history is privacy-redacted and may appear empty; check redacted before interpreting it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Opaque cursor from a prior page; its meaning follows direction. |
| `user_id` | string | No | User ID; provide exactly one of user_id or username. Prefer the ID returned by Get Viewer. |
| `username` | string | No | Product Hunt username; provide exactly one of user_id or username. Prefer the username returned by Get Viewer. |
| `direction` | string ("FORWARD" | "BACKWARD") | No | Traverse after the cursor or backward before it. |
| `page_size` | integer | No | Posts to return on this page (1-20). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Unfollow User

**Slug:** `PRODUCT_HUNT_UNFOLLOW_USER`

Stop following a Product Hunt user as the connected viewer. Product Hunt must separately approve write access for the application; OAuth write consent alone is insufficient.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | Yes | ID of the Product Hunt user to unfollow. |
| `client_mutation_id` | string | No | Optional caller correlation ID echoed by Product Hunt. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
