Producthunt

If no token is available, fall back to using web_search with site:producthunt.com queries.

Key Limitation: No Text Search

The Product Hunt API does not support free-text search on posts. You can browse by topic, date, or get a specific post by slug — but you cannot search "AI writing tool" and get matching products.

To find a product by name, use web_search first:

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

Then use the slug from the result to query the API for full details (votes, comments, makers, etc.).

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

Use exec with curl to make GraphQL requests:

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
      }
    }
  }
}

Remember: This browses a topic — it's not a text search. To find a specific product by name, use web_search with site:producthunt.com/posts "product name", then look up the post by slug via the API.

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

For a full list, query:

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

If no PH_API_TOKEN is available:

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?"

Query today's posts sorted by votes, present top 10.

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

Product Hunt API V2 — GraphQL API, requires free developer token.