# Reddit Subreddit Posts API. Posts, page by page. Hot, New, Top or Rising, with exact scores. We handle the proxies, blocks and platform changes. [Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dreddit.subreddit_posts) ## Reddit Subreddit Posts API at a glance Returns a public subreddit's posts a page at a time, sorted Best, Hot, New, Top, Rising or Controversial. Top and Controversial take a time range, from the past hour to all time. Each post has its title and full text, author, exact score and upvote ratio, comment and award counts, images, gallery or video, flair, and whether it is pinned, NSFW, a spoiler, locked, archived or a crosspost. Send the subreddit's link, r/\ or its name; r/popular works too. GET `/v1/reddit/subreddit_posts` [Read the API reference](https://socialtap.dev/docs/reference/reddit/subreddit_posts/index.md) - **1 credit** per page, $0.75–$1.97 per 1,000 pages - **22 typed fields** null when unknown - **25** posts per page, Reddit's Best order (its default ranking of a subreddit's posts) - **`url`** is all it needs, e.g. `https://www.reddit.com/r/golang/` ## Send one request. Get up to 25 posts back. Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free. `$ npm install socialtap` `url = https://www.reddit.com/r/golang/` [Open in playground](https://socialtap.dev/playground/?endpoint=reddit.subreddit_posts) cURL: ```shell curl -G 'https://socialtap.dev/v1/reddit/subreddit_posts' \ --data-urlencode 'sort=best' \ --data-urlencode 'url=https://www.reddit.com/r/golang/' \ -H "x-api-key: $SOCIALTAP_API_KEY" ``` TypeScript SDK: ```typescript import { SocialTap } from "socialtap"; const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY const res = await client.reddit.subredditPosts.list({ url: "https://www.reddit.com/r/golang/", sort: "best" }); console.log(res.data); console.log(res.credits.charged, res.meta.request_id); ``` Node.js (fetch): ```javascript const params = new URLSearchParams({ sort: "best", url: "https://www.reddit.com/r/golang/", }); const res = await fetch(`https://socialtap.dev/v1/reddit/subreddit_posts?${params}`, { headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" }, }); const body = await res.json(); if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`); const { data, page, meta } = body; console.log(data, meta.credits_charged); ``` Python (requests): ```python import os import requests res = requests.get( "https://socialtap.dev/v1/reddit/subreddit_posts", params={"sort": "best", "url": "https://www.reddit.com/r/golang/"}, headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]}, ) body = res.json() if not res.ok: raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}") data, page, meta = body["data"], body["page"], body["meta"] print(data, meta["credits_charged"]) ``` Go (net/http): ```go package main import ( "encoding/json" "fmt" "log" "net/http" "net/url" "os" ) func main() { q := url.Values{} q.Set("sort", "best") q.Set("url", "https://www.reddit.com/r/golang/") req, err := http.NewRequest("GET", "https://socialtap.dev/v1/reddit/subreddit_posts?"+q.Encode(), nil) if err != nil { log.Fatal(err) } req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY")) res, err := http.DefaultClient.Do(req) if err != nil { log.Fatal(err) } defer res.Body.Close() var body struct { Data json.RawMessage `json:"data"` Page json.RawMessage `json:"page"` Meta map[string]any `json:"meta"` Error *struct { Code string `json:"code"` Message string `json:"message"` } `json:"error"` } if err := json.NewDecoder(res.Body).Decode(&body); err != nil { log.Fatal(err) } if body.Error != nil { log.Fatalf("%s: %s", body.Error.Code, body.Error.Message) } fmt.Println(string(body.Data), body.Meta["credits_charged"]) } ``` 200 OK: ```json { "data": [ { "approximate_fields": [], "author": { "avatar_url": "https://styles.redditmedia.com/t5_a1v2lk/styles/profileIcon_snoo-nftv2_bmZ0X2VpcDE1NToxMzdfZWI5NTlhNzE1ZGZmZmU2ZjgyZjQ2MDU1MzM5ODJjNDg1OWNiMTRmZV8yMzcwNDc5Mw_rare_bab5aafc-9be8-4a21-9291-292d69269d8f-headshot.png?width=64&height=64&frame=1&auto=webp&crop=64%3A64%2Csmart&s=91b4656…", "display_name": null, "id": "t2_oamvoow25", "is_verified": null, "url": "https://www.reddit.com/user/masteryourown/", "username": "masteryourown" }, "coauthors": [], "duration_ms": null, "hashtags": [], "id": "t3_1xlsvt6", "is_nsfw": false, "is_pinned": false, "is_sponsored": false, "language": "en", "media": [], "mentions": [], "metrics": { "comment_count": 18, "like_count": 50, "quote_count": null, "repost_count": null, "save_count": null, "share_count": null, "view_count": null }, "platform": "reddit", "platform_specific": { "reddit": { "award_count": 0, "crosspost_of": null, "domain": "self.golang", "flair": null, "is_archived": false, "is_locked": false, "is_spoiler": false, "link_url": null, "score": 50, "subreddit": { "id": "t5_2rc7j", "name": "golang", "url": "https://www.reddit.com/r/golang/" }, "upvote_ratio": 0.9310344827586207 } }, "platform_type": "text", "published_at": "2026-11-02T09:39:53Z", "text": "I am a Go beginner, I had understood the concepts of go and now I want to implement the things using Go, I want to built projects but not typically looking for beginner ones like web scraper or task/expense tracker, I want something intermediate level or hard that actually challe…", "thumbnail_url": null, "title": "Looking for interesting Go projects beyond the usual beginner stuff", "type": "text", "unknown_fields": [], "url": "https://www.reddit.com/r/golang/comments/1xlsvt6/looking_for_interesting_go_projects_beyond_the/" }, { "approximate_fields": [], "author": { "avatar_url": "https://www.redditstatic.com/avatars/defaults/v2/avatar_default_3.png", "display_name": null, "id": "t2_opw76rkuj", "is_verified": null, "url": "https://www.reddit.com/user/theadamwey/", "username": "theadamwey" }, "coauthors": [], "duration_ms": null, "hashtags": [], "id": "t3_1x7oe1w", "is_nsfw": false, "is_pinned": false, "is_sponsored": false, "language": "en", "media": [], "mentions": [], "metrics": { "comment_count": 46, "like_count": 551, "quote_count": null, "repost_count": null, "save_count": null, "share_count": null, "view_count": null }, "platform": "reddit", "platform_specific": { "reddit": { "award_count": 0, "crosspost_of": null, "domain": "github.com", "flair": "discussion", "is_archived": false, "is_locked": false, "is_spoiler": false, "link_url": "https://github.com/valimised/ivxv", "score": 551, "subreddit": { "id": "t5_2rc7j", "name": "golang", "url": "https://www.reddit.com/r/golang/" }, "upvote_ratio": 0.9910873440285205 } }, "platform_type": "link", "published_at": "2026-10-16T18:42:44Z", "text": null, "thumbnail_url": null, "title": "Estonia's election system is mostly programmed in Go. I came across the open source github repo and wanted to share.", "type": "link", "unknown_fields": [], "url": "https://www.reddit.com/r/golang/comments/1x7oe1w/estonias_election_system_is_mostly_programmed_in/" }, { "approximate_fields": [], "author": { "avatar_url": "https://styles.redditmedia.com/t5_axsmo/styles/profileIcon_x1liwt4w1uba1.jpg?width=64&height=64&frame=1&auto=webp&crop=64%3A64%2Csmart&s=29a9dd5c24114953ada9bdfbc26a3c0049e0f6b7", "display_name": null, "id": "t2_iaoxg", "is_verified": null, "url": "https://www.reddit.com/user/luxurioust/", "username": "luxurioust" }, "coauthors": [], "duration_ms": null, "hashtags": [], "id": "t3_1xlr4rr", "is_nsfw": false, "is_pinned": false, "is_sponsored": false, "language": "und", "media": [], "mentions": [], "metrics": { "comment_count": 1, "like_count": 15, "quote_count": null, "repost_count": null, "save_count": null, "share_count": null, "view_count": null }, "platform": "reddit", "platform_specific": { "reddit": { "award_count": 0, "crosspost_of": null, "domain": "self.golang", "flair": null, "is_archived": false, "is_locked": false, "is_spoiler": false, "link_url": null, "score": 15, "subreddit": { "id": "t5_2rc7j", "name": "golang", "url": "https://www.reddit.com/r/golang/" }, "upvote_ratio": 0.9411764705882353 } }, "platform_type": "multi_media", "published_at": "2026-11-02T07:45:24Z", "text": "Excelize is a library written in pure Go providing a set of functions that allow you to write to and read from XLAM / XLSM / XLSX / XLTM / XLTX files. Supports reading and writing spreadsheet documents generated by Microsoft Excel™ 2007 and later. Supports complex components by h…", "thumbnail_url": null, "title": "Excelize 2.11.1 Released - Open-source library for spreadsheet", "type": "text", "unknown_fields": [], "url": "https://www.reddit.com/r/golang/comments/1xlr4rr/excelize_2111_released_opensource_library_for/" } ], "page": { "has_more": true, "next_cursor": "c1.EXAMPLE_CURSOR", "next_cursor_expires_at": "2026-10-26T12:00:00Z", "end_reason": null }, "meta": { "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f", "platform": "reddit", "source": "page", "is_cached": false, "credits_charged": 1, "latency_ms": 983, "fetched_at": "2026-10-25T12:00:00Z", "input": { "kind": "community", "id": "t5_2rc7j", "url": "https://www.reddit.com/r/golang/" }, "credits_remaining": 9999, "client_request_id": null, "warnings": [] } } ``` Long arrays and strings are shortened here. Real responses are complete. ## One schema on 21 platforms. The [response reference](https://socialtap.dev/docs/reference/reddit/subreddit_posts/index.md#response) lists every field, its type and when it is `null`. [See the full schema](https://socialtap.dev/resources/post/index.md). - ### Null means unknown A field Reddit doesn't show is null, never zero or an empty string, so a real zero always means zero. - ### What it accepts The subreddit: its link on any reddit.com host (www, old, new, np, m, sh), any of its tabs included (/new, /top/?t=week, /about), r/\, or its bare name (golang). - ### Write one parser Reddit, TikTok, Instagram and 18 more platforms answer in these fields, so the code that reads one reads them all. - **`platform`string**: Platform ID (tiktok, youtube, …). - **`id`string**: Platform-native post ID (string; Instagram shortcode, Reddit with its t3_ prefix). - **`url`string**: Canonical post URL. - **`type`string**: Normalized content shape. New values may be added; treat unknown values as other. - **`platform_type`string**: The platform's own product label, lowercase (reel, short, story, live, tweet, …). - **`title`string**: Headline (YouTube title, Reddit title); null on caption-only platforms. - **`text`string**: Caption, description or body as plain text. - **`language`string**: BCP-47 language of text, when the platform states it. Live data from 33 platforms. [TikTok](https://socialtap.dev/apis/tiktok/index.md) · [Instagram](https://socialtap.dev/apis/instagram/index.md) · [Facebook](https://socialtap.dev/apis/facebook/index.md) · [YouTube](https://socialtap.dev/apis/youtube/index.md) · [Reddit](https://socialtap.dev/apis/reddit/index.md) · [Threads](https://socialtap.dev/apis/threads/index.md) · [Spotify](https://socialtap.dev/apis/spotify/index.md) · [Amazon](https://socialtap.dev/apis/amazon/index.md) · [Apple Music](https://socialtap.dev/apis/applemusic/index.md) · [Pinterest](https://socialtap.dev/apis/pinterest/index.md) · [Rumble](https://socialtap.dev/apis/rumble/index.md) · [X](https://socialtap.dev/apis/x/index.md) · [Bluesky](https://socialtap.dev/apis/bluesky/index.md) · [Twitch](https://socialtap.dev/apis/twitch/index.md) · [LinkedIn](https://socialtap.dev/apis/linkedin/index.md) · [Telegram](https://socialtap.dev/apis/telegram/index.md) · [TikTok Shop](https://socialtap.dev/apis/tiktokshop/index.md) · [Kwai](https://socialtap.dev/apis/kwai/index.md) · [Snapchat](https://socialtap.dev/apis/snapchat/index.md) · [SoundCloud](https://socialtap.dev/apis/soundcloud/index.md) · [Truth Social](https://socialtap.dev/apis/truthsocial/index.md) · [Kick](https://socialtap.dev/apis/kick/index.md) · [Komi](https://socialtap.dev/apis/komi/index.md) · [Lnk.Bio](https://socialtap.dev/apis/linkbio/index.md) · [Linkme](https://socialtap.dev/apis/linkme/index.md) · [Linktree](https://socialtap.dev/apis/linktree/index.md) · [Pillar](https://socialtap.dev/apis/pillar/index.md) · [TikTok Ad Library](https://socialtap.dev/apis/tiktok-ad-library/index.md) · [Facebook Ad Library](https://socialtap.dev/apis/facebook-ad-library/index.md) · [Facebook Events](https://socialtap.dev/apis/facebook-events/index.md) · [Facebook Marketplace](https://socialtap.dev/apis/facebook-marketplace/index.md) · [Google Ads Transparency Center](https://socialtap.dev/apis/google-ads-transparency/index.md) · [LinkedIn Ad Library](https://socialtap.dev/apis/linkedin-ad-library/index.md) ## What teams build with the Reddit Subreddit Posts API. - ### Monitor a subreddit for new posts - ### Collect a subreddit's top posts of the month - ### Track what's rising in a community - ### Feed a subreddit into sentiment analysis ## Good to know before you build. - is_pinned is true for posts the subreddit's moderators pinned (Reddit's stickied posts). Best and Hot list them among the others, and since never stops a walk at one. - On popular and controversial, since picks Reddit's time filter (past hour, day, week, month or year, or all time without since), so the ranking counts that span. - Reddit leaves its ads and some removed posts out of a page, so a page can hold fewer posts than the limit while more follow. r/popular's first page holds only a few. - Reddit lists only about the newest 1,000 posts of each order (and, on popular and controversial, of each time filter). A walk that reaches them ends with page.end_reason platform_limit, not end. - On newest, a cursor whose post Reddit no longer lists (removed, or past those 1,000) returns invalid_cursor (reason expired) rather than starting over from the newest posts. - A private, quarantined or members-only subreddit returns private_or_unavailable. A banned or unregistered name returns not_found. - Logged out, Reddit shows r/all as its home page. Use r/popular for posts from across Reddit. ## 1 credit per page. Failed requests are free. Buy credits once and spend them on any endpoint, on any platform. [Plans and packs](https://socialtap.dev/pricing/index.md) · [How this endpoint is priced](https://socialtap.dev/docs/reference/reddit/subreddit_posts/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md) | Source | Price per successful page | Per 1,000 pages | | --- | --- | --- | | Public page `page` | 1 credit | $0.75–$1.97 | - Cache hits are free. - Credits from packs and top-ups never expire. - A monthly plan's credits are spent first, and what is left of them ends at each renewal. - Prices exclude tax: sales tax is added at checkout where it applies. - Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID. ## Questions about the Reddit Subreddit Posts API. More in the [API reference](https://socialtap.dev/docs/reference/reddit/subreddit_posts/index.md). **How much does the Reddit Subreddit Posts API cost?** A page of up to 25 posts costs 1 credit. Every successful page is charged, empty pages included. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack. **How do I get the next page?** Repeat the same request with cursor set to page.next_cursor from the previous response, keeping the other parameters. When page.has_more is false there are no more pages. Cursors expire after 1 hour. Other platforms ## Posts on 20 more platforms. - [TikTok Post API](https://socialtap.dev/apis/tiktok/post/index.md) (1 credit · `GET /v1/tiktok/post`) - [Instagram Post API](https://socialtap.dev/apis/instagram/post/index.md) (1 credit · `GET /v1/instagram/post`) - [Facebook Post API](https://socialtap.dev/apis/facebook/post/index.md) (1 credit · `GET /v1/facebook/post`) - [YouTube Video API](https://socialtap.dev/apis/youtube/post/index.md) (1 credit · `GET /v1/youtube/post`) - [Threads Post API](https://socialtap.dev/apis/threads/post/index.md) (1 credit · `GET /v1/threads/post`) - [Spotify Track API](https://socialtap.dev/apis/spotify/track/index.md) (1 credit · `GET /v1/spotify/track`) - [Amazon Shop Posts API](https://socialtap.dev/apis/amazon/shop_posts/index.md) (1 credit / page · `GET /v1/amazon/shop_posts`) - [Apple Music Track API](https://socialtap.dev/apis/applemusic/track/index.md) (1 credit · `GET /v1/applemusic/track`) - [Pinterest Pin API](https://socialtap.dev/apis/pinterest/pin/index.md) (1 credit · `GET /v1/pinterest/pin`) - [Rumble Video API](https://socialtap.dev/apis/rumble/post/index.md) (1 credit · `GET /v1/rumble/post`) - [X (Twitter) Post API](https://socialtap.dev/apis/x/post/index.md) (1 credit · `GET /v1/x/post`) - [Bluesky Post API](https://socialtap.dev/apis/bluesky/post/index.md) (1 credit · `GET /v1/bluesky/post`) - [Twitch Video and Clip API](https://socialtap.dev/apis/twitch/video/index.md) (1 credit · `GET /v1/twitch/video`) - [LinkedIn Post API](https://socialtap.dev/apis/linkedin/post/index.md) (1 credit · `GET /v1/linkedin/post`) - [Telegram Post API](https://socialtap.dev/apis/telegram/post/index.md) (1 credit · `GET /v1/telegram/post`) - [Kwai Post API](https://socialtap.dev/apis/kwai/post/index.md) (1 credit · `GET /v1/kwai/post`) - [Snapchat Spotlight API](https://socialtap.dev/apis/snapchat/spotlight/index.md) (1 credit · `GET /v1/snapchat/spotlight`) - [SoundCloud Track API](https://socialtap.dev/apis/soundcloud/track/index.md) (1 credit · `GET /v1/soundcloud/track`) - [Truth Social Post API](https://socialtap.dev/apis/truthsocial/post/index.md) (1 credit · `GET /v1/truthsocial/post`) - [Kick Clip API](https://socialtap.dev/apis/kick/post/index.md) (1 credit · `GET /v1/kick/post`) More Reddit ## Reddit API. 13 endpoints, one key. - [Reddit Post API](https://socialtap.dev/apis/reddit/post/index.md) (1 credit · `GET /v1/reddit/post`) - [Reddit Search API](https://socialtap.dev/apis/reddit/search_posts/index.md) (1 credit / page · `GET /v1/reddit/search_posts`) - [Reddit User Posts API](https://socialtap.dev/apis/reddit/posts/index.md) (1 credit / page · `GET /v1/reddit/posts`) - [Reddit Profile API](https://socialtap.dev/apis/reddit/profile/index.md) (1 credit · `GET /v1/reddit/profile`) - [Reddit User Search API](https://socialtap.dev/apis/reddit/search_profiles/index.md) (1 credit / page · `GET /v1/reddit/search_profiles`) - [Reddit Comments API](https://socialtap.dev/apis/reddit/comments/index.md) (1 credit / page · `GET /v1/reddit/comments`) - [Reddit User Comments API](https://socialtap.dev/apis/reddit/profile_comments/index.md) (1 credit / page · `GET /v1/reddit/profile_comments`) - [Reddit Comment Search API](https://socialtap.dev/apis/reddit/search_comments/index.md) (1 credit / page · `GET /v1/reddit/search_comments`) - [Reddit Video Transcript API](https://socialtap.dev/apis/reddit/transcript/index.md) (From 1 credit · `GET /v1/reddit/transcript`) - [Reddit Engagement API](https://socialtap.dev/apis/reddit/engagement/index.md) (1 credit · `GET /v1/reddit/engagement`) - [Reddit Subreddit API](https://socialtap.dev/apis/reddit/subreddit/index.md) (1 credit · `GET /v1/reddit/subreddit`) - [Reddit Subreddit Search API](https://socialtap.dev/apis/reddit/search_subreddits/index.md) (1 credit / page · `GET /v1/reddit/search_subreddits`) ## Try it on a link you already have. Paste it in the playground, or copy the request into your code. 100free credits - No credit card - Failed requests are free - Works on all 218 endpoints [Start for free](https://socialtap.dev/signup/) [Read the docs](https://socialtap.dev/docs/index.md) --- [HTML version](https://socialtap.dev/apis/reddit/subreddit_posts/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)