Product Hunt Search & Monitoring

When to Use

• User asks about a product's Product Hunt launch or performance
• User wants to find trending products in a category
• User wants to monitor Product Hunt for competitors or similar products
• User asks "what launched on Product Hunt today/this week"
• User wants to research a product's reception on PH

Requirements

Getting a Token

1. Go to API Dashboard
2. Create an application (any name/URL works)
3. Use the Developer Token at the bottom of your app's page (no OAuth flow needed for read-only access)
4. Store the token in an environment variable:

   PH_API_TOKEN

web_search

site:producthunt.com

Key Limitation: No Text Search

web_search

web_search: site:producthunt.com/posts "product name"

API Overview

• Endpoint:

  https://api.producthunt.com/v2/api/graphql

• Method: POST
• Auth:

  Authorization: Bearer {token}

• Format: GraphQL
• Rate Limit: ~900 requests per 15 minutes, complexity limit of 1000 per query

How to Query

exec

curl

curl -s -X POST https://api.producthunt.com/v2/api/graphql \
  -H "Authorization: Bearer $PH_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "YOUR_GRAPHQL_QUERY"}'

Common Queries

Today's Top Posts

query {
  posts(order: VOTES, first: 10) {
    edges {
      node {
        id
        name
        tagline
        votesCount
        commentsCount
        url
        website
        createdAt
        makers {
          name
          username
        }
        topics {
          edges {
            node {
              name
            }
          }
        }
      }
    }
  }
}

Browse Posts by Topic

query {
  posts(order: VOTES, first: 10, topic: "developer-tools") {
    edges {
      node {
        id
        name
        tagline
        votesCount
        url
        website
      }
    }
  }
}

web_search

site:producthunt.com/posts "product name"

Get a Specific Post

query {
  post(slug: "chatgpt") {
    id
    name
    tagline
    description
    votesCount
    commentsCount
    reviewsCount
    reviewsRating
    url
    website
    createdAt
    featuredAt
    makers {
      name
      username
      headline
    }
    topics {
      edges {
        node {
          name
          slug
        }
      }
    }
    comments(first: 5) {
      edges {
        node {
          body
          votesCount
          createdAt
          user {
            name
            username
          }
        }
      }
    }
  }
}

Get Posts by Topic

query {
  topic(slug: "artificial-intelligence") {
    name
    postsCount
    posts(first: 10, order: VOTES) {
      edges {
        node {
          name
          tagline
          votesCount
          url
          createdAt
        }
      }
    }
  }
}

Get Posts for a Specific Date

query {
  posts(postedAfter: "2024-01-15T00:00:00Z", postedBefore: "2024-01-16T00:00:00Z", order: VOTES, first: 10) {
    edges {
      node {
        name
        tagline
        votesCount
        url
      }
    }
  }
}

Look Up a User

query {
  user(username: "rrhoover") {
    name
    username
    headline
    followersCount
    followingCount
    madePosts(first: 5) {
      edges {
        node {
          name
          tagline
          votesCount
          url
        }
      }
    }
  }
}

Available Topics (Common Slugs)

• artificial-intelligence

  ,

  developer-tools

  ,

  design-tools

• productivity

  ,

  marketing

  ,

  saas

  ,

  fintech

• no-code

  ,

  open-source

  ,

  social-media

• web-app

  ,

  iphone

  ,

  android

  ,

  mac

  ,

  chrome-extensions

query { topics(first: 50, order: FOLLOWERS_COUNT) { edges { node { name slug followersCount } } } }

Constructing Product Hunt Links

• Product page:

  https://www.producthunt.com/posts/{slug}

• User profile:

  https://www.producthunt.com/@{username}

• Topic page:

  https://www.producthunt.com/topics/{slug}

Fallback: No API Token

PH_API_TOKEN

1. Use

   web_search

   with queries like:

   • site:producthunt.com/posts "product name"

   • site:producthunt.com "topic" launched

2. Use

   web_fetch

   on specific Product Hunt URLs to get basic info
3. Inform the user that richer data (vote counts, comments, maker info) requires an API token

Output Format

### Product Hunt Results

1. **Product Name** — Tagline
   🔼 votes · 💬 comments · ⭐ rating
   By @maker_username
   Topics: AI, Developer Tools
   🔗 product_url
   🏠 website_url
   📅 launched_date

2. ...

Error Handling

• 401 Unauthorized: Token is invalid or expired. Check

  PH_API_TOKEN

  .
• 429 Rate Limited: Wait 15 minutes for rate limit reset.
• Complexity limit exceeded: Reduce the number of fields or nested queries. Remove

  comments

  ,

  topics

  , or

  makers

  sub-queries.
• Post not found: The slug may be wrong. Try searching with

  web_search

  first to confirm the exact slug.
• No results for topic: Check the topic slug — use the topics query to find valid slugs.

Examples

Example 1: "What launched on Product Hunt today?"

Example 2: "How did Linear do on Product Hunt?"

1. Search:

   web_search "site:producthunt.com/posts linear"

2. Get the slug from results
3. Query:

   post(slug: "linear-5")

   with full details

Example 3: "Show me top AI tools on Product Hunt this month"

1. Query posts by topic

   artificial-intelligence

   with date filters
2. Sort by votes, present top results

Data Source