Reddit Subreddit Posts
Read public posts from a subreddit with pagination.
GET/api/v1/reddit/subreddit-posts
Costs 1 credit per request; failed requests are refunded. Authentication, the search_metadata envelope and error codes are the same as for every endpoint (see the API reference). Try it in the playground.
Parameters
Request parameters
| Parameter | Type | Description |
|---|---|---|
limit | integer | Maximum public entries to return, from 1 to 100.Default: 25.Range: 1 to 100. |
after | string | next_page_token from the previous response. |
subredditrequired | string | Subreddit name without r/. |
sort | "hot" | "new" | "top" | "rising" | Post order.Default: hot. |
time | "all" | "hour" | "day" | "week" | "month" | "year" | Time range when sorting top posts.Default: all. |
Response
A JSON object with search_metadata (request id, credits used and remaining) and the result groups the page returns. Groups and fields depend on the content of each page, so treat every field as optional.
Examples
cURL
curl "https://serpfast.com/api/v1/reddit/subreddit-posts?subreddit=python&limit=3" \
-H "Authorization: Bearer $SERPFAST_KEY"Node.js 18+
const params = new URLSearchParams({
"subreddit": "python",
"limit": 3
});
const res = await fetch(`https://serpfast.com/api/v1/reddit/subreddit-posts?${params}`, {
headers: { Authorization: `Bearer ${process.env.SERPFAST_KEY}` },
});
const data = await res.json();
console.log(data);Python
import os, requests
params = {
"subreddit": "python",
"limit": 3
}
res = requests.get(
"https://serpfast.com/api/v1/reddit/subreddit-posts",
params=params,
headers={"Authorization": f"Bearer {os.environ['SERPFAST_KEY']}"},
timeout=120,
)
print(res.json())