POST/api/v1/community-postsCommunity

Community Posts

Retrieve a feed of posts from any public subreddit. You can sort by hot, new, top, rising, or controversial, just like browsing Reddit natively.

Ready to try it?

Create a free account — 30 requests included, no credit card.

Get free API key →

Request Parameters

Send as a JSON body in your POST request.

Parameter	Type	Required	Description
subreddit	string	Yes	The name of the subreddit (without the 'r/').
sort	string	No	Sort order: 'hot', 'new', 'top', 'rising', 'controversial'. Default: 'hot'.
time	string	No	Time filter (only applies to 'top' or 'controversial'): 'hour', 'day', 'week', 'month', 'year', 'all'. Default: 'day'.
limit	number	No	Number of posts to return (max 100). Default: 25.
after	string	No	Pagination cursor (the 'name' of the last post, e.g., 't3_abc123').

Code Examples

curl

curl -X POST https://subscraper.dev/api/v1/community-posts \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "subreddit": "MachineLearning",
    "sort": "top",
    "time": "week",
    "limit": 10
  }'

TypeScript SDK

const feed = await client.getCommunityPosts({
  subreddit: "MachineLearning",
  sort: "top",
  time: "week",
  limit: 10
});

Install the SDK →

Sample Response

{
  "posts": [
    {
      "id": "t3_xyz789",
      "title": "New Paper: Attention Is All You Need (Revisited)",
      "author": "researcher_1",
      "score": 850,
      "numComments": 234,
      "url": "https://arxiv.org/abs/...",
      "createdAt": "2023-10-20T09:00:00Z"
    }
  ],
  "after": "t3_xyz789"
}