Datasets

Search the reddit-trending dataset

Searches daily snapshots of each tracked subreddit's hot-feed post order (one document per subreddit × snapshot × rank) so history accumulates. With no date the latest snapshot is returned (today's trending); pair subreddit with sort=date_desc for a subreddit's trending history over time. There is no score or comment-count field, so rank reflects Reddit's own hot-feed order rather than a locally computed score. 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/reddit-trending/search

Request

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

Query parameters

qstring

Full-text query over the post title, max 256 characters

subredditstring

Exact subreddit-name filter, max 128 characters

datestring

Snapshot date filter yyyy-MM-dd; defaults to the latest snapshot

sort'rank' | 'date_desc'

Sort enum: rank, date_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.