Reddit Subreddit Posts API

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/<name> or its name; r/popular works too.

GET /v1/reddit/subreddit_posts

Read the API reference

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

GET /v1/reddit/subreddit_postsTry in

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

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

require "json"
require "net/http"

uri = URI("https://socialtap.dev/v1/reddit/subreddit_posts")
uri.query = URI.encode_www_form('sort' => 'best', 'url' => 'https://www.reddit.com/r/golang/')
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([
    'sort' => 'best',
    'url' => 'https://www.reddit.com/r/golang/',
]);
$ch = curl_init('https://socialtap.dev/v1/reddit/subreddit_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("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"])
}

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"

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

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

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 = "sort=" + encode("best")
            + "&url=" + encode("https://www.reddit.com/r/golang/");
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://socialtap.dev/v1/reddit/subreddit_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("&",
    "sort=" + Uri.EscapeDataString("best"),
    "url=" + Uri.EscapeDataString("https://www.reddit.com/r/golang/"));
var res = await http.GetAsync("https://socialtap.dev/v1/reddit/subreddit_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/subreddit_posts")
        .query(&[("sort", "best"), ("url", "https://www.reddit.com/r/golang/")])
        .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/subreddit_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
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/<name>, 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.

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 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 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 Subreddit Posts API.

Try it on a link you already have.

Paste it 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 Subreddit Posts API. Posts, page by page.