canonical: https://jentic.com/apis/producthunt.com/producthunt

# Product Hunt API

The best new products in tech. Product Hunt API v2 is GraphQL-based, providing a single POST endpoint for all queries and mutations. Authenticate via OAuth 2.0 or a developer token. The API exposes 4 endpoints secured with bearer authentication.

## For AI agents

Programmatically execute graphql query or mutation, obtain an oauth access token. Covers 4 operations with bearer authentication.

## Scope

Does not handle payments, communications, or crm - use for identity and authentication only.

## Capabilities

- Execute GraphQL query or mutation
- Obtain an OAuth access token
- Authorize a user via OAuth
- Test an access token

## Use cases

### Identity and Authentication Operations

Use the Product Hunt API to perform identity auth operations programmatically. The API provides 4 endpoints covering core functionality including execute graphql query or mutation, obtain an oauth access token, authorize a user via oauth.

Example prompt: Call POST /api/graphql to execute graphql query or mutation

### Automated Authentication Management

Automate authentication operations by combining multiple Product Hunt API endpoints. Agents can obtain an oauth access token and then authorize a user via oauth in a single workflow.

Example prompt: Call POST /oauth/token to obtain an oauth access token, then verify the result

### AI Agent Integration via Jentic

AI agents discover and call Product Hunt API endpoints through Jentic without managing credentials directly. An agent searches for the required operation by intent, receives the matching endpoint schema, and executes the call with Jentic-managed authentication. This eliminates the need to read API documentation or handle bearer tokens manually.

Example prompt: Search Jentic for 'execute graphql query or mutation', load the operation schema, and execute with Jentic-managed credentials

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | /api/graphql | Execute GraphQL query or mutation |
| POST | /oauth/token | Obtain an OAuth access token |
| GET | /oauth/authorize | Authorize a user via OAuth |
| GET | /oauth/test | Test an access token |

## Key resources

- **Authentication** — Operations related to Authentication
- **GraphQL** — Operations related to GraphQL

## Why Jentic

- **Setup:** Wiring the Product Hunt API by hand means completing the OAuth flow, setting the bearer token on api.producthunt.com/v2, and composing GraphQL queries against the single graphql endpoint yourself. Through Jentic you install once, import Product Hunt from the API Directory, store the token once, and your agent calls it.
- **Permission scoping:** Product Hunt exposes a single GraphQL endpoint with no resource id in the URL path, so scope the agent by operations: allow it the GraphQL query it needs and nothing more. You choose the operations it may call, so it only runs the calls you permit.
- **Credential handling:** Your Product Hunt bearer token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'run a GraphQL query for trending products', and Jentic returns the matching Product Hunt operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Auth0** — Alternative identity auth API
- **Okta** — Alternative identity auth API

## FAQ

### What authentication does the Product Hunt API use?

The Product Hunt API uses a Bearer token in the Authorization header. Through Jentic, these credentials are stored encrypted in your Jentic One instance and injected at execution time, so raw secrets never enter the agent context.

### Can I execute graphql query or mutation with the Product Hunt API?

Yes. Use the POST /api/graphql endpoint. The API returns structured JSON responses that agents can parse and act on directly.

### What are the rate limits for the Product Hunt API?

Rate limits are not specified in the OpenAPI spec. Check the vendor documentation for current limits. Through Jentic, rate limiting is handled automatically with retry logic built into the execution layer.

### How do I execute graphql query or mutation through Jentic?

Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'execute graphql query or mutation'. Jentic returns the matching Product Hunt API operation with its input schema. Load the schema and execute the call - credentials are injected automatically.

### How many endpoints does the Product Hunt API have?

The Product Hunt API exposes 4 endpoints covering authentication, graphql operations.

### Can I limit what my agent is allowed to do with the Product Hunt API?

Yes. Product Hunt exposes a single GraphQL endpoint (POST /api/graphql) with no resource id in the URL path, so in your self-hosted Jentic One instance you scope the agent by operation: you decide which GraphQL query or mutation it may run and it executes only the calls you permit. Your own rules also govern the OAuth token operations, so the agent uses just the credentials and endpoints you allow. It cannot reach any operation you have not granted.
