Reddit User Posts API

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

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

GET /v1/reddit/postsTry in

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);

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"])

require "json"
require "net/http"

uri = URI("https://socialtap.dev/v1/reddit/posts")
uri.query = URI.encode_www_form('handle' => 'https://www.reddit.com/user/spez/')
req = Net::HTTP::Get.new(uri)
req["x-api-key"] = ENV.fetch("SOCIALTAP_API_KEY")
res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(req) }
body = JSON.parse(res.body)
raise "#{body["error"]["code"]}: #{body["error"]["message"]}" unless res.is_a?(Net::HTTPSuccess)
pp body["data"]
puts body["meta"]["credits_charged"]

<?php

$query = http_build_query([
    'handle' => 'https://www.reddit.com/user/spez/',
]);
$ch = curl_init('https://socialtap.dev/v1/reddit/posts?' . $query);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-api-key: ' . getenv('SOCIALTAP_API_KEY')],
]);
$body = json_decode(curl_exec($ch), true);
if (curl_getinfo($ch, CURLINFO_RESPONSE_CODE) >= 400) {
    throw new RuntimeException($body['error']['code'] . ': ' . $body['error']['message']);
}
print_r($body['data']);
echo $body['meta']['credits_charged'], PHP_EOL;

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"])
}

curl -G 'https://socialtap.dev/v1/reddit/posts' \
  --data-urlencode 'handle=https://www.reddit.com/user/spez/' \
  -H "x-api-key: $SOCIALTAP_API_KEY"

{
  "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": []
  }
}

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);

import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;

public class Main {
    public static void main(String[] args) throws Exception {
        String query = "handle=" + encode("https://www.reddit.com/user/spez/");
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://socialtap.dev/v1/reddit/posts?" + query))
            .header("x-api-key", System.getenv("SOCIALTAP_API_KEY"))
            .GET()
            .build();
        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        // An error is {"error": {"code", "message", ...}}; success is {data, meta}, meta.credits_charged its price.
        if (response.statusCode() >= 400) throw new RuntimeException(response.body());
        System.out.println(response.body());
    }

    static String encode(String value) {
        return URLEncoder.encode(value, StandardCharsets.UTF_8);
    }
}

using System.Text.Json;

using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", Environment.GetEnvironmentVariable("SOCIALTAP_API_KEY"));

var query = string.Join("&",
    "handle=" + Uri.EscapeDataString("https://www.reddit.com/user/spez/"));
var res = await http.GetAsync("https://socialtap.dev/v1/reddit/posts?" + query);
using var body = JsonDocument.Parse(await res.Content.ReadAsStringAsync());
if (!res.IsSuccessStatusCode)
{
    var error = body.RootElement.GetProperty("error");
    throw new Exception($"{error.GetProperty("code")}: {error.GetProperty("message")}");
}
Console.WriteLine(body.RootElement.GetProperty("data"));
Console.WriteLine(body.RootElement.GetProperty("meta").GetProperty("credits_charged"));

// Cargo.toml: reqwest = { version = "0.12", features = ["blocking", "json"] }, serde_json = "1"
use std::env;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = reqwest::blocking::Client::new()
        .get("https://socialtap.dev/v1/reddit/posts")
        .query(&[("handle", "https://www.reddit.com/user/spez/")])
        .header("x-api-key", env::var("SOCIALTAP_API_KEY")?)
        .send()?;
    let ok = res.status().is_success();
    let body: serde_json::Value = res.json()?;
    if !ok {
        return Err(format!("{}: {}", body["error"]["code"], body["error"]["message"]).into());
    }
    println!("{} {}", body["data"], body["meta"]["credits_charged"]);
    Ok(())
}

200 OK · GET https://socialtap.dev/v1/reddit/postsLong arrays and strings are shortened here. Real responses are complete.Docs

One schema on 21 platforms.

The response reference lists every field, its type and when it is null. See the full schema.

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.

platformstring: Platform ID (tiktok, youtube, …).
idstring: Platform-native post ID (string; Instagram shortcode, Reddit with its t3_ prefix).
urlstring: Canonical post URL.
typestring: Normalized content shape. New values may be added; treat unknown values as other.
platform_typestring: The platform's own product label, lowercase (reel, short, story, live, tweet, …).
titlestring: Headline (YouTube title, Reddit title); null on caption-only platforms.
textstring: Caption, description or body as plain text.
languagestring: BCP-47 language of text, when the platform states it.

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 How this endpoint is priced How credits work

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.

Try it on an account you know.

Paste its handle or link in the playground, or copy the request into your code.

free credits

No credit card
Failed requests are free
Works on all 218 endpoints

Start for free Read the docs

Reddit User Posts API. Submissions, page by page.