Datasets API endpoint
Returns distribution counts over the Product Hunt makers dataset (dataset id enum value `producthunt-makers`), honoring the same filters as search. Facet enum: `topic`, `product_count_band`.
/datasets/producthunt-makers/facetsDataset id enum:
producthunt-makersQuery parameters:
facet: required facet to aggregate. Allowed values: topic, product_count_band.q: optional full-text query over maker name and headline, max 256 characters.topic: optional exact topic-slug the maker builds in, max 128 characters.min_products: optional minimum number of products made, 0 or greater.min_total_votes: optional minimum total upvotes across the maker's products, 0 or greater.Response behavior:
{ value, count } bucket. For facet=topic, value is a topic slug; for facet=product_count_band, one of 1, 2-4, 5-9, 10+.items array (not an error) when nothing matches or the dataset has no data yet.| Field | Filled in, of 50 checked | Values in the sample |
|---|---|---|
| value | 50 | |
| count | 50 | 1,030 to 26,809, median 2,237 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| facet | string | Yes | Facet enum: topic, product_count_band Allowed values: topic, product_count_band. | topic | |
| q | string | No | Full-text query over maker name and headline, max 256 characters | ||
| topic | string | No | Exact topic-slug the maker builds in, max 128 characters | ||
| min_products | integer | No | Minimum number of products made, 0 or greater | ||
| min_total_votes | integer | No | Minimum total upvotes across the maker's products, 0 or greater | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/datasets/producthunt-makers/facets?facet=topic&q=coffee" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"dataset": "producthunt-makers",
"facet": "product_count_band",
"items": [
{
"value": "1",
"count": 180234
},
{
"value": "2-4",
"count": 42150
},
{
"value": "5-9",
"count": 8300
},
{
"value": "10+",
"count": 2100
}
]
}
}Request schema
No body schema
Response schema
#/definitions/datasets.producthuntMakersFacetResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | datasets.ProductHuntMakersFacetResponse | No | ||||
| data.dataset | string | No | ||||
| data.facet | string | No | ||||
| data.items | array | No | ||||
| data.items[].count | integer | No | ||||
| data.items[].value | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/datasets/producthunt-makers/facets?facet=topic&q=coffee" \
-H "x-api-key: $CRAWLORA_API_KEY"