Docs menu

Datasets API endpoint

Product Hunt product facets API

Returns distribution counts over the Product Hunt products dataset (dataset id enum value `producthunt-products`), honoring the same filters as search. Facet enum: `topic`, `launch_year`, `pricing_type`, `product_state`.

GETapiKey1 credit/requestDatasetsdatasets.producthuntProductsFacetResponseDoc/datasets/producthunt-products/facets

Endpoint facts

Method: GET
API path: /datasets/producthunt-products/facets
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Datasets
Execution: Stored dataset records. No live scraping, browser session or proxy routing.
Response schema: #/definitions/datasets.producthuntProductsFacetResponseDoc

Stored structured dataset search API Try Product Hunt product facets API in Playground Datasets API documentation

How this endpoint behaves

Dataset id enum:

producthunt-products

Query parameters:

facet: required facet to aggregate. Allowed values: topic, launch_year, pricing_type, product_state.
q: optional full-text query over product name and tagline, max 256 characters.
topic: optional exact topic-slug filter, e.g. artificial-intelligence, max 128 characters.
maker: optional exact maker-username filter, max 128 characters.
launched_after: optional lower bound on first-launch date, an ISO-8601 date (YYYY-MM-DD).
launched_before: optional upper bound on first-launch date, an ISO-8601 date (YYYY-MM-DD).
min_votes: optional minimum upvotes, 0 or greater.
min_rating: optional minimum review rating, from 0 through 5.
pricing_type: optional exact pricing-type filter, e.g. free, paid, freemium.
has_website: optional website presence filter.
is_online: optional lifecycle filter; true keeps only products still online, false only retired products.

Response behavior:

Each item is a { value, count } bucket. For facet=topic, value is a topic slug; for facet=launch_year, a four-digit year; for facet=pricing_type/product_state, the token value.
Invalid enum values return the standard invalid params envelope.
Returns an empty items array (not an error) when nothing matches or the dataset has no data yet.
Does not trigger live scraping.

Live monitoring

Monitored request: GET /datasets/producthunt-products/facets?facet=topic
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 0.32 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /datasets/producthunt-products/facets?facet=topic
Items in items: 50
Fields filled in every checked item: 2

Field	Filled in, of 50 checked	Values in the sample
value	50
count	50	639 to 15,626, median 1,131

Request parameters

Parameter	Type	Required	Description	Example
facet	string	Yes	Facet enum: topic, launch_year, pricing_type, product_state Allowed values: topic, launch_year, pricing_type, product_state.	topic
q	string	No	Full-text query over product name and tagline, max 256 characters
topic	string	No	Exact topic-slug filter, e.g. artificial-intelligence, max 128 characters
maker	string	No	Exact maker-username filter (populated by hydration), max 128 characters
launched_after	string	No	Lower bound on first-launch date, an ISO-8601 date (YYYY-MM-DD)
launched_before	string	No	Upper bound on first-launch date, an ISO-8601 date (YYYY-MM-DD)
min_votes	integer	No	Minimum upvotes, 0 or greater
min_rating	number	No	Minimum review rating, from 0 through 5
pricing_type	string	No	Exact pricing-type filter, e.g. free, paid, freemium
has_website	boolean	No	Website presence filter
is_online	boolean	No	true keeps only products still online, false only retired products
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/datasets/producthunt-products/facets?facet=topic&q=coffee&has_website=true&is_online=true" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "producthunt-products",
    "facet": "launch_year",
    "items": [
      {
        "value": "2024",
        "count": 12043
      },
      {
        "value": "2023",
        "count": 11890
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/datasets.producthuntProductsFacetResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	datasets.ProductHuntProductsFacetResponse	No
data.dataset	string	No		Identifier of the dataset queried (`producthunt-products`).
data.facet	string	No		Facet that was aggregated.
data.items	array	No		Facet values with the number of matching records for each.
data.items[].count	integer	No		Number of products in this bucket.
data.items[].value	string	No		Bucket value, such as a topic slug, a four-digit launch year, a pricing type or a product state.
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/datasets/producthunt-products/facets?facet=topic&q=coffee&has_website=true&is_online=true" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Datasets endpoint docs Stored structured dataset search API Stored Datasets List API documentation Airbnb Markets Dataset Facets API documentation Airbnb Markets Dataset Country API documentation Nearby Airbnb Markets Dataset API documentation Airbnb Markets Dataset Search API documentation Facet Apple Podcasts shows dataset API documentation

Open in Playground Back to group

Docs menu

Datasets API endpoint

Product Hunt product facets API

GETapiKey1 credit/requestDatasetsdatasets.producthuntProductsFacetResponseDoc/datasets/producthunt-products/facets

Endpoint facts

Method: GET
API path: /datasets/producthunt-products/facets
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Datasets
Execution: Stored dataset records. No live scraping, browser session or proxy routing.
Response schema: #/definitions/datasets.producthuntProductsFacetResponseDoc

Stored structured dataset search API Try Product Hunt product facets API in Playground Datasets API documentation

How this endpoint behaves

Dataset id enum:

producthunt-products

Query parameters:

facet: required facet to aggregate. Allowed values: topic, launch_year, pricing_type, product_state.
q: optional full-text query over product name and tagline, max 256 characters.
topic: optional exact topic-slug filter, e.g. artificial-intelligence, max 128 characters.
maker: optional exact maker-username filter, max 128 characters.
launched_after: optional lower bound on first-launch date, an ISO-8601 date (YYYY-MM-DD).
launched_before: optional upper bound on first-launch date, an ISO-8601 date (YYYY-MM-DD).
min_votes: optional minimum upvotes, 0 or greater.
min_rating: optional minimum review rating, from 0 through 5.
pricing_type: optional exact pricing-type filter, e.g. free, paid, freemium.
has_website: optional website presence filter.
is_online: optional lifecycle filter; true keeps only products still online, false only retired products.

Response behavior:

Each item is a { value, count } bucket. For facet=topic, value is a topic slug; for facet=launch_year, a four-digit year; for facet=pricing_type/product_state, the token value.
Invalid enum values return the standard invalid params envelope.
Returns an empty items array (not an error) when nothing matches or the dataset has no data yet.
Does not trigger live scraping.

Live monitoring

Monitored request: GET /datasets/producthunt-products/facets?facet=topic
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 0.32 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /datasets/producthunt-products/facets?facet=topic
Items in items: 50
Fields filled in every checked item: 2

Field	Filled in, of 50 checked	Values in the sample
value	50
count	50	639 to 15,626, median 1,131

Request parameters

Parameter	Type	Required	Description	Example
facet	string	Yes	Facet enum: topic, launch_year, pricing_type, product_state Allowed values: topic, launch_year, pricing_type, product_state.	topic
q	string	No	Full-text query over product name and tagline, max 256 characters
topic	string	No	Exact topic-slug filter, e.g. artificial-intelligence, max 128 characters
maker	string	No	Exact maker-username filter (populated by hydration), max 128 characters
launched_after	string	No	Lower bound on first-launch date, an ISO-8601 date (YYYY-MM-DD)
launched_before	string	No	Upper bound on first-launch date, an ISO-8601 date (YYYY-MM-DD)
min_votes	integer	No	Minimum upvotes, 0 or greater
min_rating	number	No	Minimum review rating, from 0 through 5
pricing_type	string	No	Exact pricing-type filter, e.g. free, paid, freemium
has_website	boolean	No	Website presence filter
is_online	boolean	No	true keeps only products still online, false only retired products
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/datasets/producthunt-products/facets?facet=topic&q=coffee&has_website=true&is_online=true" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "producthunt-products",
    "facet": "launch_year",
    "items": [
      {
        "value": "2024",
        "count": 12043
      },
      {
        "value": "2023",
        "count": 11890
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/datasets.producthuntProductsFacetResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	datasets.ProductHuntProductsFacetResponse	No
data.dataset	string	No		Identifier of the dataset queried (`producthunt-products`).
data.facet	string	No		Facet that was aggregated.
data.items	array	No		Facet values with the number of matching records for each.
data.items[].count	integer	No		Number of products in this bucket.
data.items[].value	string	No		Bucket value, such as a topic slug, a four-digit launch year, a pricing type or a product state.
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/datasets/producthunt-products/facets?facet=topic&q=coffee&has_website=true&is_online=true" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Product Hunt product facets API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Product Hunt product facets API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related