Endpoint Playground
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). Dataset Playground requests query indexed data and do not apply proxy routing.
14 Oct 2026: 10 items; 11 fields had a value in every checked item.
Sample value profiles: snapshot_date: 2026-10-13; rank: 1 to 10, median 5; permalink: reddit.com.
curl 'https://api.crawlora.net/api/v1/datasets/reddit-trending/search?sort=rank' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| q | string | No | Full-text query over the post title, max 256 characters | |
| subreddit | string | No | Exact subreddit-name filter, max 128 characters | |
| date | string | No | Snapshot date filter yyyy-MM-dd; defaults to the latest snapshot | |
| sort | string | No | rank | Sort enum: rank, date_desc |
| page | integer | No | Page number, defaults to 1 | |
| page_size | integer | No | Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000 |
{
"code": 200,
"msg": "OK",
"data": {
"dataset": "reddit-trending",
"items": [
{
"post_uid": "webscraping:2026-07-27:1",
"subreddit": "webscraping",
"snapshot_date": "2026-07-27",
"rank": 1,
"post_id": "1v7p3i7",
"title": "I own a wood factory and want to use webscrapers to get info",
"author": "Thin-Application-575",
"permalink": "https://www.reddit.com/r/webscraping/comments/1v7p3i7/i_own_a_wood_factory_and_want_to_use_webscrapers/",
"url": "https://www.reddit.com/r/webscraping/comments/1v7p3i7/i_own_a_wood_factory_and_want_to_use_webscrapers/",
"domain": "self.webscraping",
"created_utc": 1785123567
}
],
"snapshot_date": "2026-07-27",
"page": 1,
"page_size": 20,
"total": 10,
"sort": "rank"
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.