Datasets

Search the Product Hunt trends dataset

Returns aggregate Product Hunt launch trends from the dataset id enum value producthunt-trends. Aggregate-only: each row is a category-over-time cell (a topic, optionally within a calendar period), reporting launch count, total and average upvotes, average rating and the top product — never an individual product record. Thin cells are suppressed. group_by enum: topic_month, topic_year, topic. Sort enum: period_desc, period_asc, launch_count_desc, sum_votes_desc. Billing: this search costs 1 credit per record returned, with a minimum of 2 (an empty result costs 2, a full page of 100 costs 100).

get/datasets/producthunt-trends/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/datasets/producthunt-trends/search
  • Auth: API key in header x-api-key

Query parameters

group_by'topic_month' | 'topic_year' | 'topic'

Aggregate cell dimension enum: topic_month, topic_year, topic. Defaults to topic_month

topicstring

Exact topic-slug filter, e.g. artificial-intelligence, max 128 characters

launched_afterstring

Lower bound on first-launch date, an ISO-8601 date (YYYY-MM-DD)

launched_beforestring

Upper bound on first-launch date, an ISO-8601 date (YYYY-MM-DD)

min_votesinteger

Minimum product upvotes, 0 or greater

min_launchesinteger

Minimum launches per cell; raises the small-cell suppression floor (never lowered below the built-in minimum)

sort'period_desc' | 'period_asc' | 'launch_count_desc' | 'sum_votes_desc'

Sort enum: period_desc, period_asc, launch_count_desc, sum_votes_desc

pageinteger

Page number, defaults to 1

page_sizeinteger

Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.