← API Store
SocialReddit
Subreddit posts
GET /reddit/v1/subredditPass the same sort and time with the cursor. Pass next_cursor back as cursor for the next posts. next_cursor is null on the last page. flair, nsfw and domain filter the posts of the feed page (about 25); with any of them the answer adds applied_filters and page_count (posts on the page before filtering). Keep following next_cursor for more matches. Every response includes credits_used: the credits this call cost.
Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.
Parameters
| Name | Type | Description |
|---|---|---|
subredditrequired | string | Example: python |
sort | hot | new | top | rising | controversial | best | Feed order: hot (default), new, top, rising, controversial, best. Example: hot |
time | hour | day | week | month | year | all | Time range for top/controversial: hour, day (default), week, month, year, all. |
cursor | string | Cursor from `next_cursor` on the previous response; `next_cursor` is null on the last page. |
flair | string | Only posts whose flair contains this text (case-insensitive), e.g. discussion. |
nsfw | exclude | only | exclude: leave out NSFW posts; only: NSFW posts only. |
domain | string | Only posts linking to this domain (or its subdomains), e.g. github.com, i.redd.it, or self.python for text posts. |
Every endpoint also takes: raw、fields、fresh、output、records
{
"cached": false,
"count": 24,
"credits_used": 1,
"next_cursor": "dDNfMXg4OWJucQ==",
"posts": [
{
"archived": false,
"attributes": {
"author": "Key-Koala-8259",
"author-id": "t2_2dvo4lstj5",
"award-count": "0",
"class": "block relative cursor-pointer group bg-neutral-background focus-within:bg-neutral-background-hover hover:bg-neutral-background-hover xs:roun…",
"comment-count": "4",
"content-href": "https://www.reddit.com/r/Python/comments/1xdgdc2/litellm_11070_on_pypi_was_malicious_oct_21_it/",
"created-timestamp": "2026-10-23T14:57:54.148000+0000",
"data-expected-lcp": true,
"data-ks-item": true,
"domain": "self.Python",
"feedIndex": "25",
"hide-awards-button": true,
"icon": "https://styles.redditmedia.com/t5_hqiqf2/styles/profileIcon_ao50kv39kozg1.jpeg?width=64&height=64&frame=1&auto=webp&crop=64%3A64%2Csmart&s=9…",
"id": "t3_1xdgdc2",
"is-ama": true,
"is-awardable": true,
"is-desktop-viewport": true,
"is-embeddable": true,
"is-slim-card": true,
"moderation-verdict": "",
"pdp-target": "_self",
"permalink": "/r/Python/comments/1xdgdc2/litellm_11070_on_pypi_was_malicious_oct_21_it/",
"post-language": "en",
"post-title": "LiteLLM 1.107.0 on PyPI was malicious (Oct 21): it runs on every Python start via a .pth file.",
"post-type": "multi_media",
"score": "13",
"subreddit-id": "t5_2qh0y",
"subreddit-name": "Python",
"subreddit-prefixed-name": "r/Python",
"upvote-ratio": "0.7407407407407407",
"view-context": "SubredditFeed",
"view-type": "cardView"
},
"author": "Key-Koala-8259",
"author_icon": "https://styles.redditmedia.com/t5_hqiqf2/styles/profileIcon_ao50kv39kozg1.jpeg?width=64&height=64&frame=1&auto=webp&crop=64%3A64%2Csmart&s=9…",
"author_id": "t2_2dvo4lstj5",
"author_profile": null,
"award_count": 0,
"comment_count": 4,
"comments": "4",
"content_url": "https://www.reddit.com/r/Python/comments/1xdgdc2/litellm_11070_on_pypi_was_malicious_oct_21_it/",
"created_at": "2026-10-23T14:57:54.148000+0000",
"domain": "self.Python",
"feed_index": 25,
"flair": "News",
"flairs": [
"News"
],
"id": "t3_1xdgdc2",
"images": [],
"language": "en",
"locked": false,
"media": [],
"nsfw": false,
"permalink": "/r/Python/comments/1xdgdc2/litellm_11070_on_pypi_was_malicious_oct_21_it/",
"post_type": "multi_media",
"score": "13",
"score_value": 13,
"spoiler": false,
"stickied": false,
"subreddit": "Python",
"subreddit_id": "t5_2qh0y",
"subreddit_prefixed": "r/Python",
"text": "I wrote this up. How to check safely and what to rotate\nShort version: if you installed an unpinned litellm between 11:39 and 13:23 UTC on O…",
"text_html": "<p>\n I wrote this up. <object role=\"none\"><a rpl class=\"relative pointer-events-auto a\n \n \n \n \n underline\n \n cursor-pointer\" hre…",
"title": "LiteLLM 1.107.0 on PyPI was malicious (Oct 21): it runs on every Python start via a .pth file.",
"upvote_ratio": 0.7407407407407407,
"url": "https://www.reddit.com/r/Python/comments/1xdgdc2/litellm_11070_on_pypi_was_malicious_oct_21_it/"
},
{
"archived": false,
"attributes": {
"author": "Positive-Food-9915",
"author-id": "t2_cu56o0k2",
"award-count": "0",
"class": "block relative cursor-pointer group bg-neutral-background focus-within:bg-neutral-background-hover hover:bg-neutral-background-hover xs:roun…",
"comment-count": "6",
"content-href": "https://www.reddit.com/r/Python/comments/1xdlm9d/tried_decouple_dynaconf_pydanticsettings_and_more/",
"created-timestamp": "2026-10-23T18:14:09.503000+0000",
"data-expected-lcp": true,
"data-ks-item": true,
"domain": "self.Python",
"feedIndex": "27",
"hide-awards-button": true,
"icon": "https://preview.redd.it/snoovatar/avatars/fd0aae32-645e-4d4d-838a-cd3a11467e13-headshot.png?width=64&height=64&crop=smart&auto=webp&s=24330d…",
"id": "t3_1xdlm9d",
"is-awardable": true,
"is-desktop-viewport": true,
"is-embeddable": true,
"moderation-verdict": "",
"pdp-target": "_self",
"permalink": "/r/Python/comments/1xdlm9d/tried_decouple_dynaconf_pydanticsettings_and_more/",
"post-language": "en",
"post-title": "Tried decouple, Dynaconf, pydantic-settings and more: still hitting the same config gaps. Just me?",
"post-type": "text",
"score": "4",
"subreddit-id": "t5_2qh0y",
"subreddit-name": "Python",
"subreddit-prefixed-name": "r/Python",
"upvote-ratio": "0.7",
"view-context": "SubredditFeed",
"view-type": "cardView"
},
"author": "Positive-Food-9915",
"author_icon": "https://preview.redd.it/snoovatar/avatars/fd0aae32-645e-4d4d-838a-cd3a11467e13-headshot.png?width=64&height=64&crop=smart&auto=webp&s=24330d…",
"author_id": "t2_cu56o0k2",
"author_profile": null,
"award_count": 0,
"comment_count": 6,
"comments": "6",
"content_url": "https://www.reddit.com/r/Python/comments/1xdlm9d/tried_decouple_dynaconf_pydanticsettings_and_more/",
"created_at": "2026-10-23T18:14:09.503000+0000",
"domain": "self.Python",
"feed_index": 27,
"flair": "Discussion",
"flairs": [
"Discussion"
],
"id": "t3_1xdlm9d",
"images": [],
"language": "en",
"locked": false,
"media": [],
"nsfw": false,
"permalink": "/r/Python/comments/1xdlm9d/tried_decouple_dynaconf_pydanticsettings_and_more/",
"post_type": "text",
"score": "4",
"score_value": 4,
"spoiler": false,
"stickied": false,
"subreddit": "Python",
"subreddit_id": "t5_2qh0y",
"subreddit_prefixed": "r/Python",
"text": "I've tried a bunch of config tools over the years, including python-decouple, Dynaconf and pydantic-settings. Each one is good at its job, b…",
"text_html": "<p>\n I've tried a bunch of config tools over the years, including python-decouple, Dynaconf and pydantic-settings. Each one is good…",
"title": "Tried decouple, Dynaconf, pydantic-settings and more: still hitting the same config gaps. Just me?",
"upvote_ratio": 0.7,
"url": "https://www.reddit.com/r/Python/comments/1xdlm9d/tried_decouple_dynaconf_pydanticsettings_and_more/"
},
"… 22 more"
],
"subreddit": "python"
} Response fields (76)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.cached | boolean |
$.count | integer |
$.credits_used | integer |
$.next_cursor | string |
$.posts | array |
$.posts[] | object | string |
$.posts[].archived | boolean |
$.posts[].attributes | object |
$.posts[].attributes.author | string |
$.posts[].attributes.author-id | string |
$.posts[].attributes.award-count | string |
$.posts[].attributes.class | string |
$.posts[].attributes.comment-count | string |
$.posts[].attributes.content-href | string |
$.posts[].attributes.created-timestamp | string |
$.posts[].attributes.data-expected-lcp | boolean |
$.posts[].attributes.data-ks-item | boolean |
$.posts[].attributes.domain | string |
$.posts[].attributes.feedIndex | string |
$.posts[].attributes.hide-awards-button | boolean |
$.posts[].attributes.icon | string |
$.posts[].attributes.id | string |
$.posts[].attributes.is-ama | boolean |
$.posts[].attributes.is-awardable | boolean |
$.posts[].attributes.is-desktop-viewport | boolean |
$.posts[].attributes.is-embeddable | boolean |
$.posts[].attributes.is-slim-card | boolean |
$.posts[].attributes.moderation-verdict | string |
$.posts[].attributes.pdp-target | string |
$.posts[].attributes.permalink | string |
$.posts[].attributes.post-language | string |
$.posts[].attributes.post-title | string |
$.posts[].attributes.post-type | string |
$.posts[].attributes.score | string |
$.posts[].attributes.subreddit-id | string |
$.posts[].attributes.subreddit-name | string |
$.posts[].attributes.subreddit-prefixed-name | string |
$.posts[].attributes.upvote-ratio | string |
$.posts[].attributes.view-context | string |
$.posts[].attributes.view-type | string |
$.posts[].author | string |
$.posts[].author_icon | string |
$.posts[].author_id | string |
$.posts[].author_profile | null |
$.posts[].award_count | integer |
$.posts[].comment_count | integer |
$.posts[].comments | string |
$.posts[].content_url | string |
$.posts[].created_at | string |
$.posts[].domain | string |
$.posts[].feed_index | integer |
$.posts[].flair | string |
$.posts[].flairs | array |
$.posts[].flairs[] | string |
$.posts[].id | string |
$.posts[].images | array |
$.posts[].language | string |
$.posts[].locked | boolean |
$.posts[].media | array |
$.posts[].nsfw | boolean |
$.posts[].permalink | string |
$.posts[].post_type | string |
$.posts[].score | string |
$.posts[].score_value | integer |
$.posts[].spoiler | boolean |
$.posts[].stickied | boolean |
$.posts[].subreddit | string |
$.posts[].subreddit_id | string |
$.posts[].subreddit_prefixed | string |
$.posts[].text | string |
$.posts[].text_html | string |
$.posts[].title | string |
$.posts[].upvote_ratio | number |
$.posts[].url | string |
$.subreddit | string |