Reddit Subreddit posts
Fetch posts from a subreddit, with sort and date filters
Endpoint
One endpoint for every offer below. Omit provider and the router picks with automatic failover — the response's served_by tells you which one ran.
https://api.socialrouter.io/v1/reddit/subreddit.postsOffers
Every offer below returns the same normalized output, in failover order — the first one serves unless you pin another with the provider field.
apify/harshmaurvia Apifydefault routeUp to 10 URLs per request
$0.0028per recordapify/trudaxvia ApifyUp to 10 URLs per request
$0.0055per record
Parameters
JSON body of the request. Unknown fields and unknown options are rejected with the valid list, so a wrong guess costs nothing.
| Parameter | Type | Description |
|---|---|---|
urlsRequired | string[] | One URL per record to process. Accepted shapes:https://www.reddit.com/r/<subreddit> — A sort suffix (/hot, /new, /top, /rising) is accepted too. /r/all and /r/popular work.Example: https://www.reddit.com/r/programmingA single url string is accepted too. |
providerOptional | string | Pin one offer, e.g. apify/harshmaur. Omit it and the router picks with failover. |
limitOptional | integer | Max records to return per URL. |
optionsOptional | object | Service-specific options, listed below. |
options.sortOptional | hot | new | top | rising | Listing sort. Overrides a sort suffix present in the URL. |
options.timeOptional | hour | day | week | month | year | all | Time window, applied when sort is "top". |
options.postedAfterOptional | YYYY-MM-DD | Only posts created on/after this UTC date (offer-dependent). |
options.postedBeforeOptional | YYYY-MM-DD | Only posts created before this UTC date (offer-dependent). |
Output
Each record has the fields below, whichever offer serves the request. Offers may include additional platform-specific fields on top.
post_urlurlLink to the post on the subreddit
titlestringPost title
post_textstringSelf-text body of the post (empty for link posts)
author_namestringRedditor who posted (e.g. "u/acme_dev")
upvotesnumberNet upvote score of the post
upvote_rationumberShare of votes that are upvotes (0-1)
comments_countnumberTotal comments
flairstringPost flair (when set)
posted_atiso8601When the post was published
sourcestringPlatform the record was extracted from (e.g. "linkedin")
extracted_atiso8601UTC timestamp when the record was produced
Going further
Auth, error semantics, and every other endpoint live in the API reference — including the machine-readable OpenAPI spec at /v1/openapi.json.
Frequently asked questions
How much does Reddit subreddit posts cost?
Prices start at $0.0028 per record, depending on the offer that serves the request. You are only charged for records actually returned.
Which offers serve reddit/subreddit.posts?
apify/harshmaur, apify/trudax — 2 offers are available behind the same endpoint. Pin one with the optional "provider" field, or omit it and the router picks with automatic failover. The response's "served_by" field names the offer that ran.
What input does it need?
The "urls" field of the JSON body, as an array of strings: https://www.reddit.com/r/<subreddit> — A sort suffix (/hot, /new, /top, /rising) is accepted too. /r/all and /r/popular work.. For example: https://www.reddit.com/r/programming
Is the output format the same for every offer?
Yes. Every offer returns the normalized record schema documented on this page; some add extra platform-specific fields on top, but the documented fields are always present.
How many URLs can I send per request?
Up to 10 URLs in a single request, depending on the offer.
What happens if an offer fails?
SocialRouter automatically fails over to the next offer serving the same service, so a single upstream outage doesn't break your integration.
What options does it take?
sort (hot|new|top|rising): Listing sort. Overrides a sort suffix present in the URL. time (hour|day|week|month|year|all): Time window, applied when sort is "top". postedAfter (string): Only posts created on/after this UTC date (offer-dependent). postedBefore (string): Only posts created before this UTC date (offer-dependent).