Subreddits
Read a subreddit's profile, paginate its posts, search within it, or trigger background tracking to unlock trend signals.
GET
/v1/subreddits/{name}Get subreddit metadata
Return the subreddit's about payload: display name, subscriber count, public description, NSFW flag, and creation timestamp.
Parameters
name string·path·required | Subreddit short name without the `r/` prefix. 2-32 chars, alphanumeric + underscore. example: python |
Request
curl -X GET https://api.redditintel.dev/v1/subreddits/{name} \
-H "Authorization: Bearer <YOUR_API_KEY>"Response · 200
X-RateLimit-Limit: 100000{ "data": { "id": "2qh0y", "fullname": "t5_2qh0y", "display_name": "Python", "name_prefixed": "r/Python", "title": "Python", "public_description": "The largest Python community for Reddit! Stay up to date with the latest news, packages, and meta information relating to the Python programming language. --- If you have questions or are new to Python use r/LearnPython", "description": "####[The Python Discord](https://discord.gg/python) News about the dynamic, interpreted, interactive, object-oriented, extensible programming language Python # Upcoming Events [Full Events Calendar](https://www.python.org/events/) # Ple…" /* 5689 more chars */, "description_html": "<!-- SC_OFF --><div class="md"><h4><a href="https://discord.gg/python">The Python Discord</a></h4> <p>News about the dynamic, interpreted, interactive, object-oriented, extensible programming language Python</p> <h1>Upcoming Events</h1> …" /* 7850 more chars */, "subreddit_type": "public", "subscribers": 1479142, "active_user_count": null, "created_utc": "2008-01-25T03:14:39+00:00", "over_18": false, "lang": "en", "icon_img": null, "banner_img": null, "header_img": "https://b.thumbs.redditmedia.com/8HiO52_EuT_h63Qg.png", "url": "/r/Python/" }, "meta": { "request_id": "<redacted>" } }
Error responses
404
GET /v1/subreddits/this-sub-cannot-exist-zzz/about{ "error": { "code": "RESOURCE_NOT_FOUND", "message": "Not Found", "request_id": "<redacted>" } }
GET
/v1/subreddits/{name}/postsList subreddit posts
Paginated post listing for a subreddit. Cursor pagination via the `next_cursor` field in the envelope's meta block.
Parameters
name string·path·required | Subreddit short name. example: python |
limit integer·query | Number of posts to return. Default 25, max 100 (or your plan's max_page_size, whichever is lower). example: 25 |
sort string·query | One of `new`, `hot`, `top`, `rising`. Default `hot`. example: new |
cursor string·query | Signed cursor token from a previous response's `meta.page.next_cursor`. Omit for the first page. |
Request
curl -X GET https://api.redditintel.dev/v1/subreddits/{name}/posts \
-H "Authorization: Bearer <YOUR_API_KEY>"Response · 200
X-RateLimit-Limit: 10000025 of 143 lines
Error responses
400
GET /v1/subreddits/python/posts?cursor=garbage{ "error": { "code": "INVALID_CURSOR", "message": "cursor is missing, malformed, expired, or signed for a different route", "request_id": "<redacted>" } }
400
GET /v1/subreddits/python/posts?limit=999999{ "error": { "code": "BAD_REQUEST", "message": "request validation failed", "request_id": "<redacted>", "details": { "errors": [ { "loc": [ "query", "limit" ],, "type": "less_than_equal", "msg": "Input should be less than or equal to 100" } ] } } }
GET
/v1/r/{name}/postsList subreddit posts (Reddit-style alias)
Identical to `/v1/subreddits/{name}/posts`. Provided for Reddit-style URL parity.
Parameters
name string·path·required | Subreddit short name. example: python |
limit integer·query | 1-100. Defaults to 25. example: 10 |
Request
curl -X GET https://api.redditintel.dev/v1/r/{name}/posts \
-H "Authorization: Bearer <YOUR_API_KEY>"Response · 200
X-RateLimit-Limit: 10000025 of 99 lines
GET
/v1/subreddits/{name}/searchPro+Search within a subreddit
Full-text search scoped to a single subreddit.
Parameters
name string·path·required | Subreddit short name. example: python |
q string·query·required | Query string. 1-512 chars. example: async |
limit integer·query | 1-100. Defaults to 25. example: 10 |
Request
curl -X GET https://api.redditintel.dev/v1/subreddits/{name}/search \
-H "Authorization: Bearer <YOUR_API_KEY>"Response · 200
X-RateLimit-Limit: 10000025 of 142 lines
POST
/v1/subreddits/{name}/trackPro+Start tracking a subreddit
Adds the subreddit to the active polling set and backfills the velocity buckets. Required before trend signals will return data.
Parameters
name string·path·required | Subreddit to track. example: python |
Request body (JSON)
| backfill_hours | integer (1-24, default 7) |
Request
curl -X POST https://api.redditintel.dev/v1/subreddits/{name}/track \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-H "Content-Type: application/json" \
-d '{"backfill_hours":7}'Response · 200
X-RateLimit-Limit: 100000{ "data": { "subreddit": "python", "tracked_since": "2026-05-15T20:01:28.911506+00:00", "newly_tracked": false, "backfill": { "ran": true, "posts_seen": 100, "posts_observed": 100, "oldest_post_iso": "2026-04-19T06:57:54+00:00", "newest_post_iso": "2026-05-15T19:20:15+00:00" }, "trends_available_now": true }, "meta": { "request_id": "<redacted>" } }