# Reddit User Posts API. Submissions, page by page. Submissions sorted New, Top or Hot, with scores. We handle the proxies, blocks and platform changes. [Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dreddit.posts) ## Reddit User Posts API at a glance Returns the public posts a Reddit user submitted, a page at a time, from their username or profile link. Each has its title, text, subreddit, score, upvote ratio, comment and award counts, flair, images, gallery or video, and whether it is pinned to the profile, NSFW, a spoiler, locked or archived. Sort by New, Top, Hot or Controversial, and set since to stop at a date. GET `/v1/reddit/posts` [Read the API reference](https://socialtap.dev/docs/reference/reddit/posts/index.md) - **1 credit** per page, $0.75–$1.97 per 1,000 pages - **22 typed fields** null when unknown - **25** submissions per page, newest first - **`handle`** is all it needs, e.g. `spez` ## Send one request. Get up to 25 submissions 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` `handle = spez` [Open in playground](https://socialtap.dev/playground/?endpoint=reddit.posts) cURL: ```shell curl -G 'https://socialtap.dev/v1/reddit/posts' \ --data-urlencode 'handle=https://www.reddit.com/user/spez/' \ -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.posts.list({ handle: "https://www.reddit.com/user/spez/" }); console.log(res.data); console.log(res.credits.charged, res.meta.request_id); ``` Node.js (fetch): ```javascript const params = new URLSearchParams({ handle: "https://www.reddit.com/user/spez/", }); const res = await fetch(`https://socialtap.dev/v1/reddit/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/posts", params={"handle": "https://www.reddit.com/user/spez/"}, 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("handle", "https://www.reddit.com/user/spez/") req, err := http.NewRequest("GET", "https://socialtap.dev/v1/reddit/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_3k30p/styles/profileIcon_uj015iwx9s7g1.png?width=48&height=48&frame=1&auto=webp&crop=48%3A48%2Csmart&s=f4940ed370a17a813fda1db1cdefc8d12b3a53a7", "display_name": null, "id": "t2_1w72", "is_verified": null, "url": "https://www.reddit.com/user/spez/", "username": "spez" }, "coauthors": [], "duration_ms": null, "hashtags": [], "id": "t3_1xiupm0", "is_nsfw": false, "is_pinned": false, "is_sponsored": false, "language": null, "media": [], "mentions": [], "metrics": { "comment_count": 478, "like_count": null, "quote_count": null, "repost_count": null, "save_count": null, "share_count": null, "view_count": null }, "platform": "reddit", "platform_specific": { "reddit": { "award_count": 10, "crosspost_of": null, "domain": "self.spez", "flair": null, "is_archived": false, "is_locked": false, "is_spoiler": false, "link_url": null, "score": null, "subreddit": { "id": "t5_3k30p", "name": "u_spez", "url": "https://www.reddit.com/r/u_spez/" }, "upvote_ratio": 0.26542056074766357 } }, "platform_type": "text", "published_at": "2026-10-29T20:08:37Z", "text": "I want to talk about a big change we're making on Reddit: we're going to evolve Reddit to being a primarily logged-in experience.\n\nThis is a big change for Reddit, where we've allowed logged-out access to basically all of Reddit for the last two decades. And I don’t know about yo…", "thumbnail_url": null, "title": "About that login screen", "type": "text", "unknown_fields": [], "url": "https://www.reddit.com/user/spez/comments/1xiupm0/about_that_login_screen/" }, { "approximate_fields": [], "author": { "avatar_url": "https://styles.redditmedia.com/t5_3k30p/styles/profileIcon_uj015iwx9s7g1.png?width=48&height=48&frame=1&auto=webp&crop=48%3A48%2Csmart&s=f4940ed370a17a813fda1db1cdefc8d12b3a53a7", "display_name": null, "id": "t2_1w72", "is_verified": null, "url": "https://www.reddit.com/user/spez/", "username": "spez" }, "coauthors": [], "duration_ms": null, "hashtags": [], "id": "t3_1vgbkge", "is_nsfw": false, "is_pinned": false, "is_sponsored": false, "language": null, "media": [], "mentions": [ "keysersosa", "Go_JasonWaterfalls", "spez" ], "metrics": { "comment_count": 491, "like_count": 371, "quote_count": null, "repost_count": null, "save_count": null, "share_count": null, "view_count": null }, "platform": "reddit", "platform_specific": { "reddit": { "award_count": 2, "crosspost_of": null, "domain": "self.spez", "flair": null, "is_archived": false, "is_locked": false, "is_spoiler": false, "link_url": null, "score": 371, "subreddit": { "id": "t5_3k30p", "name": "u_spez", "url": "https://www.reddit.com/r/u_spez/" }, "upvote_ratio": 0.8480300187617261 } }, "platform_type": "multi_media", "published_at": "2026-08-05T16:03:56Z", "text": "Hi everyone,\n\nLast May, I shared how we were building Reddit for its next chapter. I owe you an update, including a few changes I know some people will have strong opinions about.\n\nWhile we’ve made upgrades to the platform over the last 21 years, we need to continually evolve to …", "thumbnail_url": null, "title": "Modernizing Reddit’s infrastructure with you", "type": "text", "unknown_fields": [], "url": "https://www.reddit.com/user/spez/comments/1vgbkge/modernizing_reddits_infrastructure_with_you/" }, { "approximate_fields": [], "author": { "avatar_url": "https://styles.redditmedia.com/t5_3k30p/styles/profileIcon_uj015iwx9s7g1.png?width=48&height=48&frame=1&auto=webp&crop=48%3A48%2Csmart&s=f4940ed370a17a813fda1db1cdefc8d12b3a53a7", "display_name": null, "id": "t2_1w72", "is_verified": null, "url": "https://www.reddit.com/user/spez/", "username": "spez" }, "coauthors": [], "duration_ms": null, "hashtags": [], "id": "t3_1u7hraf", "is_nsfw": false, "is_pinned": false, "is_sponsored": false, "language": null, "media": [], "mentions": [ "spez" ], "metrics": { "comment_count": 310, "like_count": 942, "quote_count": null, "repost_count": null, "save_count": null, "share_count": null, "view_count": null }, "platform": "reddit", "platform_specific": { "reddit": { "award_count": 28, "crosspost_of": null, "domain": "self.spez", "flair": null, "is_archived": false, "is_locked": false, "is_spoiler": false, "link_url": null, "score": 942, "subreddit": { "id": "t5_3k30p", "name": "u_spez", "url": "https://www.reddit.com/r/u_spez/" }, "upvote_ratio": 0.914612676056338 } }, "platform_type": "multi_media", "published_at": "2026-06-16T16:04:27Z", "text": "Hi everyone,\n\nReddit turns 21 next week. Funny enough, it’s the same age I was when we started it. Save your jokes about r/13or30, I’ve already heard them.\n\nThat’s a long time in human years and an even longer time in internet years.\n\nWhen a few of us started Reddit back in 2005,…", "thumbnail_url": null, "title": "21 years of Reddit", "type": "text", "unknown_fields": [], "url": "https://www.reddit.com/user/spez/comments/1u7hraf/21_years_of_reddit/" } ], "page": { "has_more": false, "next_cursor": null, "next_cursor_expires_at": null, "end_reason": "end" }, "meta": { "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f", "platform": "reddit", "source": "page", "is_cached": false, "credits_charged": 1, "latency_ms": 676, "fetched_at": "2026-10-25T12:00:00Z", "input": { "kind": "profile", "id": "t2_1w72", "url": "https://www.reddit.com/user/spez/" }, "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/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 Reddit username, with or without u/ (spez, u/spez, /u/spez), or a profile link on any reddit.com host (www, old, new, np, m: reddit.com/user/spez, reddit.com/u/spez, with a tab such as /submitted or /comments), or the user's profile subreddit (reddit.com/r/u_spez). - ### 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 User Posts API. - ### Monitor what an account posts - ### Find a user's most upvoted posts - ### See which subreddits a user posts in - ### Archive a brand's Reddit submissions ## Good to know before you build. - Posts the user pinned to the profile (is_pinned true) come first on every sort, then the rest in the sort's order, as the profile's Posts tab shows them. - For some users Reddit's Top order hides the posts New lists. sort=popular then returns private_or_unavailable saying so, and sort=newest lists them. - metrics.like_count is the post's score (upvotes minus downvotes) when it isn't negative. platform_specific.reddit.score has it either way, with upvote_ratio and award_count. - language is null: Reddit's feed doesn't state it. - A user who hides their posts and a suspended account return private_or_unavailable. A deleted account or a name nobody has returns not_found. A user with no posts yet returns an empty page. - NSFW posts are included, with is_nsfw true. ## 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/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 User Posts API. More in the [API reference](https://socialtap.dev/docs/reference/reddit/posts/index.md). **How much does the Reddit User Posts API cost?** A page of up to 25 submissions 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 24 hours. Other platforms ## Posts on 20 more platforms. - [TikTok Posts API](https://socialtap.dev/apis/tiktok/posts/index.md) (1 credit / page · `GET /v1/tiktok/posts`) - [Instagram Posts API](https://socialtap.dev/apis/instagram/posts/index.md) (1 credit / page · `GET /v1/instagram/posts`) - [Facebook Profile Posts API](https://socialtap.dev/apis/facebook/posts/index.md) (1 credit / page · `GET /v1/facebook/posts`) - [YouTube Channel Videos API](https://socialtap.dev/apis/youtube/posts/index.md) (1 credit / page · `GET /v1/youtube/posts`) - [Threads Posts API](https://socialtap.dev/apis/threads/posts/index.md) (1 credit / page · `GET /v1/threads/posts`) - [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 Channel Videos API](https://socialtap.dev/apis/rumble/posts/index.md) (1 credit / page · `GET /v1/rumble/posts`) - [X (Twitter) Post API](https://socialtap.dev/apis/x/post/index.md) (1 credit · `GET /v1/x/post`) - [Bluesky User Posts API](https://socialtap.dev/apis/bluesky/posts/index.md) (1 credit / page · `GET /v1/bluesky/posts`) - [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 User Posts API](https://socialtap.dev/apis/kwai/posts/index.md) (1 credit / page · `GET /v1/kwai/posts`) - [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 Posts API](https://socialtap.dev/apis/truthsocial/posts/index.md) (1 credit / page · `GET /v1/truthsocial/posts`) - [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 Subreddit Posts API](https://socialtap.dev/apis/reddit/subreddit_posts/index.md) (1 credit / page · `GET /v1/reddit/subreddit_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 an account you know. Paste its handle or link 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/posts/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)