ProductHunt API endpoint
Retrieve Product Hunt product customers
Returns paginated customer products for a Product Hunt product using Product Hunt's ProductCustomersPage GraphQL operation.
GETapiKey2 credits/requestproducthunt.customersResponseDoc
/producthunt/product/{id}/customersParameters
| Name | In | Type | Required | Enum | Example | Description |
|---|---|---|---|---|---|---|
| id | path | string | Yes | "openai" | Product Hunt slug | |
| order | query | string | No | customers, latest_launch | Product Hunt customers order | |
| page | query | integer | No | Page number | ||
| page_size | query | integer | No | Results per page | ||
| x-api-key | header | string | Yes | API key required |
Authentication
Send your scraping API key in the x-api-key header. Use the console API Keys page to rotate or select the active key.
Billing
Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.
- Credit cost
- 2 credits/request
- Charged response
- Successful 2xx responses
| Plan | Price | Included credits | Daily cap | Rate limit | Overage |
|---|---|---|---|---|---|
| Free | $0/mo | 2,000 | 500 daily credits | 5/min | No overage |
| Starter | $9/mo | 20,000 | 5,000 daily credits | 15/min | $0.75/1,000 overage credits when enabled |
| Growth | $29/mo | 100,000 | 25,000 daily credits | 45/min | $0.45/1,000 overage credits when enabled |
| Pro | $79/mo | 400,000 | No daily cap | 120/min | $0.30/1,000 overage credits |
| Business | $199/mo | 1,200,000 | No daily cap | 300/min | $0.20/1,000 overage credits |
| Enterprise | $499/mo | 5,000,000 | No daily cap | 1,000/min | $0.12/1,000 overage credits |
Response behavior
- Returns `404` when Product Hunt does not return a product for the slug. - Returns `502` when Product Hunt omits the customers/products connection or returns a blocked/malformed upstream payload.
Failure responses
| Status | Description | Schema |
|---|---|---|
| 400 | Missing or invalid parameters | #/definitions/app.Response |
| 404 | Product not found | #/definitions/app.Response |
| 429 | Rate limit exceeded | #/definitions/app.Response |
| 500 | Internal server error | #/definitions/app.Response |
Example response
{
"code": 200,
"msg": "OK",
"data": {
"product_id": "594550",
"slug": "openai",
"name": "OpenAI",
"order": "customers",
"page": 1,
"page_size": 10,
"connection": "customers",
"total_count": 120,
"pages_count": 12,
"has_previous_page": false,
"has_next_page": true,
"items": [
{
"id": "1192159",
"slug": "sheet-ninja-2",
"name": "Sheet Ninja",
"tagline": "Ship vibe-coded apps. Your data stays in Google Sheets.",
"reviews_rating": 4.8,
"reviews_count": 42
}
]
}
}Request schema
No body schema
Response schema
#/definitions/producthunt.customersResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | producthunt.ProductCustomersPage | No | ||||
| data.connection | string | No | customers | |||
| data.end_cursor | string | No | ||||
| data.has_next_page | boolean | No | ||||
| data.has_previous_page | boolean | No | ||||
| data.items | array | No | ||||
| data.items[].badges | array | No | ||||
| data.items[].badges[].category | string | No | ||||
| data.items[].badges[].date | string | No | ||||
| data.items[].badges[].id | string | No | ||||
| data.items[].badges[].period | string | No | ||||
| data.items[].badges[].position | integer | No | ||||
| data.items[].badges[].post_id | string | No | ||||
| data.items[].badges[].post_name | string | No | ||||
| data.items[].badges[].post_slug | string | No | ||||
| data.items[].badges[].year | string | No | ||||
| data.items[].categories | array | No | ||||
| data.items[].categories[].id | string | No | ||||
| data.items[].categories[].name | string | No | ||||
| data.items[].categories[].path | string | No | ||||
| data.items[].categories[].slug | string | No | ||||
| data.items[].detailed_reviews_count | integer | No | ||||
| data.items[].followers_count | integer | No | ||||
| data.items[].founder_reviews_count | integer | No | ||||
| data.items[].founder_shoutouts | array | No | ||||
| data.items[].founder_shoutouts[].from_post | producthunt.ProductCategoryFounderPost | No | ||||
| data.items[].founder_shoutouts[].from_post.badges | array | No | ||||
| data.items[].founder_shoutouts[].from_post.badges[].category | string | No | ||||
| data.items[].founder_shoutouts[].from_post.badges[].date | string | No | ||||
| data.items[].founder_shoutouts[].from_post.badges[].id | string | No | ||||
| data.items[].founder_shoutouts[].from_post.badges[].period | string | No | ||||
| data.items[].founder_shoutouts[].from_post.badges[].position | integer | No | ||||
| data.items[].founder_shoutouts[].from_post.badges[].post_id | string | No | ||||
| data.items[].founder_shoutouts[].from_post.badges[].post_name | string | No | ||||
| data.items[].founder_shoutouts[].from_post.badges[].post_slug | string | No | ||||
| data.items[].founder_shoutouts[].from_post.badges[].year | string | No | ||||
| data.items[].founder_shoutouts[].from_post.id | string | No | ||||
| data.items[].founder_shoutouts[].from_post.name | string | No | ||||
| data.items[].founder_shoutouts[].from_post.product_id | string | No | ||||
| data.items[].founder_shoutouts[].from_post.product_slug | string | No | ||||
| data.items[].founder_shoutouts[].from_post.product_state | string | No | ||||
| data.items[].founder_shoutouts[].from_post.slug | string | No | ||||
| data.items[].founder_shoutouts[].from_post.thumbnail_image_uuid | string | No | ||||
| data.items[].founder_shoutouts[].id | string | No | ||||
| data.items[].founder_shoutouts[].product_id | string | No | ||||
| data.items[].id | string | No | ||||
| data.items[].is_no_longer_online | boolean | No | ||||
| data.items[].is_subscribed | boolean | No | ||||
| data.items[].is_top_product | boolean | No | ||||
| data.items[].latest_launch | producthunt.ProductCategoryLatestLaunch | No | ||||
| data.items[].latest_launch.id | string | No | ||||
| data.items[].latest_launch.scheduled_at | string | No | ||||
| data.items[].logo_uuid | string | No | ||||
| data.items[].name | string | No | ||||
| data.items[].posts_count | integer | No | ||||
| data.items[].reviews_count | integer | No | ||||
| data.items[].reviews_rating | number | No | ||||
| data.items[].slug | string | No | ||||
| data.items[].structured_data | producthunt.ProductAlternativeStructuredData | No | ||||
| data.items[].structured_data.application_category | string | No | ||||
| data.items[].structured_data.context | string | No | ||||
| data.items[].structured_data.date_modified | string | No | ||||
| data.items[].structured_data.date_published | string | No | ||||
| data.items[].structured_data.description | string | No | ||||
| data.items[].structured_data.id | string | No | ||||
| data.items[].structured_data.image | string | No | ||||
| data.items[].structured_data.name | string | No | ||||
| data.items[].structured_data.operating_system | string | No | ||||
| data.items[].structured_data.screenshot | array | No | ||||
| data.items[].structured_data.url | string | No | ||||
| data.items[].tagline | string | No | ||||
| data.items[].tags | array | No | ||||
| data.name | string | No | OpenAI | |||
| data.order | string | No | customers | |||
| data.page | integer | No | 1 | |||
| data.page_size | integer | No | 10 | |||
| data.pages_count | integer | No | 12 | |||
| data.product_id | string | No | 594550 | |||
| data.raw_page_info | object | No | ||||
| data.slug | string | No | openai | |||
| data.total_count | integer | No | 120 | |||
| msg | string | No | OK |
Example request
curl -X GET "https://api.crawlora.net/api/v1/producthunt/product/%22openai%22/customers" -H "x-api-key: <api-key>"
TypeScript fetch
const url = new URL("https://api.crawlora.net/api/v1/producthunt/product/%22openai%22/customers");
const headers = new Headers();
headers.set("x-api-key", "<api-key>");
const response = await fetch(url, {
method: "GET",
headers,
});
const payload = await response.json();