Get Subreddit Posts
Retrieve public subreddit metadata and posts using Reddit public JSON or old Reddit HTML extraction. Each successful request costs 1 credit; 404, 422, 502, and 503 responses are not billable.
Run this endpoint
Endpoint
https://scrappa.co/api/reddit/subreddit?subreddit=Laravel&sort=hot&limit=25&extraction_path=public_json
https://scrappa.co/api/reddit/subreddit?subreddit=Laravel&sort=hot&limit=25&extraction_path=public_json
x-api-key
subreddit
= Laravel
{
"source": "public_json",
"data": {
"subreddit": {
"display_name": "Laravel",
"title": "Laravel",
"public_description": "Laravel PHP framework discussion.",
"subscribers": 123456,
"active_user_count": 321,
"over_18": false,
"created_utc": 1200000000,
"lang": "en",
"url": "https://www.reddit.com/r/Laravel/"
},
...
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
5 optional filters available.
string
Required
Required subreddit name without r/. Must be 2-100 letters, numbers, or underscores.
Laravel
string
Optional
Optional sort: hot, new, top, or rising.
hot
string
Optional
Optional top-post timeframe: hour, day, week, month, year, or all.
example
integer
Optional
Optional number of posts from 1 to 100. Defaults to 25.
25
string
Optional
Optional pagination cursor with at most 200 characters.
example
string
Optional
Optional source: public_json or old_reddit. Defaults to public_json.
public_json
Request Examples
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://scrappa.co/api/reddit/subreddit?subreddit=Laravel&sort=hot&limit=25&extraction_path=public_json",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: YOUR_API_KEY_HERE"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
<?php
use Illuminate\Support\Facades\Http;
$response = Http::timeout(30)
->withHeaders(['x-api-key' => 'YOUR_API_KEY_HERE'])
->get('https://scrappa.co/api/reddit/subreddit?subreddit=Laravel&sort=hot&limit=25&extraction_path=public_json');
if ($response->successful()) {
echo $response->body();
} else {
echo "Error: " . $response->status();
}
const options = {
method: 'GET',
headers: {
'x-api-key': 'YOUR_API_KEY_HERE'
}
};
fetch('https://scrappa.co/api/reddit/subreddit?subreddit=Laravel&sort=hot&limit=25&extraction_path=public_json', options)
.then(response => {
if (!response.ok) {
throw new Error(`HTTP error! status: ${response.status}`);
}
return response.text();
})
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
const axios = require('axios');
const options = {
method: 'GET',
url: 'https://scrappa.co/api/reddit/subreddit?subreddit=Laravel&sort=hot&limit=25&extraction_path=public_json',
headers: {
x-api-key: 'YOUR_API_KEY_HERE',
}
};
try {
const response = await axios(options);
console.log(response.data);
} catch (error) {
console.error('Error:', error.message);
}
require 'net/http'
require 'uri'
uri = URI.parse("https://scrappa.co/api/reddit/subreddit?subreddit=Laravel&sort=hot&limit=25&extraction_path=public_json")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == 'https'
request = Net::HTTP::Get.new(uri.request_uri)
request['x-api-key'] = 'YOUR_API_KEY_HERE'
begin
response = http.request(request)
puts response.body
rescue => e
puts "Error: #{e.message}"
end
import http.client
import json
conn = http.client.HTTPSConnection("scrappa.co")
headers = {
'x-api-key': 'YOUR_API_KEY_HERE',
}
try:
conn.request("GET", "/api/reddit/subreddit?subreddit=Laravel&sort=hot&limit=25&extraction_path=public_json", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
except Exception as e:
print(f"Error: {e}")
finally:
conn.close()
import requests
headers = {
'x-api-key': 'YOUR_API_KEY_HERE',
}
try:
response = requests.get('https://scrappa.co/api/reddit/subreddit?subreddit=Laravel&sort=hot&limit=25&extraction_path=public_json', headers=headers)
response.raise_for_status()
print(response.text)
except requests.exceptions.RequestException as e:
print(f"Error: {e}")
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;
import java.io.IOException;
public class ApiExample {
public static void main(String[] args) {
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://scrappa.co/api/reddit/subreddit?subreddit=Laravel&sort=hot&limit=25&extraction_path=public_json")
.addHeader("x-api-key", "YOUR_API_KEY_HERE")
.build();
try (Response response = client.newCall(request).execute()) {
if (response.isSuccessful()) {
System.out.println(response.body().string());
} else {
System.out.println("Error: " + response.code());
}
} catch (IOException e) {
System.out.println("Error: " + e.getMessage());
}
}
}
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
client := &http.Client{}
req, err := http.NewRequest("GET", "https://scrappa.co/api/reddit/subreddit?subreddit=Laravel&sort=hot&limit=25&extraction_path=public_json", nil)
if err != nil {
fmt.Println("Error creating request:", err)
return
}
req.Header.Set("x-api-key", "YOUR_API_KEY_HERE")
resp, err := client.Do(req)
if err != nil {
fmt.Println("Error making request:", err)
return
}
defer resp.Body.Close()
body, err := ioutil.ReadAll(resp.Body)
if err != nil {
fmt.Println("Error reading response:", err)
return
}
fmt.Println(string(body))
}
#!/bin/bash
curl -X GET \
-H "x-api-key: YOUR_API_KEY_HERE" \
"https://scrappa.co/api/reddit/subreddit?subreddit=Laravel&sort=hot&limit=25&extraction_path=public_json"
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
using var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY_HERE");
try
{
var response = await client.SendAsync(new HttpRequestMessage(HttpMethod.Get, "https://scrappa.co/api/reddit/subreddit?subreddit=Laravel&sort=hot&limit=25&extraction_path=public_json"));
var content = await response.Content.ReadAsStringAsync();
Console.WriteLine(content);
}
catch (Exception ex)
{
Console.WriteLine($"Error: {ex.Message}");
}
}
}
import axios from 'axios';
async function run(): Promise<void> {
try {
const response = await axios({
method: 'GET',
url: 'https://scrappa.co/api/reddit/subreddit?subreddit=Laravel&sort=hot&limit=25&extraction_path=public_json',
headers: {
'x-api-key': 'YOUR_API_KEY_HERE',
},
});
console.log(response.data);
} catch (error) {
console.error('Error:', error);
}
}
void run();
use reqwest::Client;
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
let client = Client::new();
let response = client
.get("https://scrappa.co/api/reddit/subreddit?subreddit=Laravel&sort=hot&limit=25&extraction_path=public_json")
.header("x-api-key", "YOUR_API_KEY_HERE")
.send()
.await?;
println!("{}", response.text().await?);
Ok(())
}
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
source
data
{
"source": "public_json",
"data": {
"subreddit": {
"display_name": "Laravel",
"title": "Laravel",
"public_description": "Laravel PHP framework discussion.",
"subscribers": 123456,
"active_user_count": 321,
"over_18": false,
"created_utc": 1200000000,
"lang": "en",
"url": "https://www.reddit.com/r/Laravel/"
},
"posts": [
{
"id": "abc123",
"name": "t3_abc123",
"subreddit": "Laravel",
"title": "Laravel 13 release notes",
"author": "example_user",
"permalink": "https://www.reddit.com/r/Laravel/comments/abc123/laravel_13_release_notes/",
"url": "https://www.reddit.com/r/Laravel/comments/abc123/laravel_13_release_notes/",
"selftext": "A discussion of the latest Laravel release.",
"score": 128,
"upvote_ratio": 0.95,
"num_comments": 36,
"created_utc": 1781900000,
"over_18": false,
"spoiler": false,
"stickied": false,
"flair": "News",
"thumbnail": "self"
}
],
"after": "t3_next",
"before": null,
"dist": 1
}
}
Errors
Handle these documented responses before retrying or showing customer-facing failures.
Reddit Content Not Found
Reddit returned unavailable content. The post or subreddit may be private, removed, quarantined, NSFW-gated, or blocked upstream.
{
"ok": false,
"error": "reddit_unavailable",
"message": "Reddit returned unavailable content. The post or subreddit may be private, removed, quarantined, NSFW-gated, or blocked upstream.",
"upstream_status": 404
}
Validation Error
One or more query parameters are invalid.
{
"message": "The subreddit field is required.",
"errors": {
"subreddit": [
"The subreddit field is required."
]
}
}
Reddit Upstream Error
Reddit returned an unexpected response or a response that could not be normalized.
{
"ok": false,
"error": "reddit_upstream_error",
"message": "Reddit returned an unexpected upstream response.",
"upstream_status": 500,
"retryable": true
}
Reddit Temporarily Unavailable
Reddit did not return a successful response through the approved proxy pool.
{
"ok": false,
"error": "reddit_upstream_unavailable",
"message": "Reddit did not return a successful response through the approved proxy pool.",
"retryable": true,
"upstream_status": 403
}
Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.