Reddit subreddit.posts

POST

subreddit.posts

curl -X POST https://api.socialrouter.io/v1/reddit/subreddit.posts \
  -H "Authorization: Bearer sr_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.reddit.com/r/programming",
    "limit": 50,
    "options": {
      "sort": "hot"
    }
  }'

const response = await fetch(
  "https://api.socialrouter.io/v1/reddit/subreddit.posts",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer sr_live_your_key",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      url: "https://www.reddit.com/r/programming",
      limit: 50,
      options: {
        sort: "hot"
      }
    }),
  },
);

import requests

response = requests.post(
    "https://api.socialrouter.io/v1/reddit/subreddit.posts",
    headers={"Authorization": "Bearer sr_live_your_key"},
    json={
      "url": "https://www.reddit.com/r/programming",
      "limit": 50,
      "options": {
        "sort": "hot"
      }
    },
)

const run = await sr.run("reddit/subreddit.posts", {
  url: "https://www.reddit.com/r/programming",
  limit: 50,
  options: {
    sort: "hot"
  }
});

{
  "id": "ext_a1b2c3d4",
  "status": "completed",
  "platform": "reddit",
  "service": "subreddit.posts",
  "url": "https://www.reddit.com/r/programming",
  "served_by": "apify/trudax",
  "data": [
    {
      "name": "lelanthran",
      "title": "The Difference Between a Button and a Link",
      "profile_url": "https://www.reddit.com/r/programming/comments/1v9lgdk/the_difference_between_a_button_and_a_link/",
      "source": "reddit",
      "extracted_at": "2026-07-29T16:13:10.167Z",
      "post_id": "1v9lgdk",
      "post_url": "https://www.reddit.com/r/programming/comments/1v9lgdk/the_difference_between_a_button_and_a_link/",
      "community_name": "programming",
      "date_posted": "2026-07-29T04:20:35.055Z",
      "num_upvotes": 66,
      "num_comments": 36,
      "upvote_ratio": 0.84375,
      "author_name": "lelanthran",
      "content_type": "link",
      "media_link": "https://unplannedobsolescence.com/blog/buttons-vs-links/",
      "image_urls": [
        "https://styles.redditmedia.com/t5_2fwo/styles/communityIcon_1bqa1ibfp8q11.png?width=96&height=96&frame=1&auto=webp&s=..."
      ]
    }
  ],
  "pagination": {
    "total": 1,
    "returned": 1
  },
  "created_at": "2026-07-30T12:00:00Z",
  "completed_at": "2026-07-30T12:00:03Z"
}

List the posts of a Reddit subreddit. The response is normalized, so it keeps the same shape whichever offer served it. The call is synchronous and comes back completed or failed. Body fields and error codes shared by every service are documented on Run a service.

Body

string[]

required

The URLs to fetch, as urls (array) or url (single string). Each one must match an accepted format below, and a mismatch returns 400 invalid_input_format before any routing or billing.

string

Single-input form of urls.

number

default:"100"

Maximum number of records to return. Integer, 1-250.

string

Pin one offer, as source/name. Serving this service: apify/harshmaur, apify/trudax. Omit it (the default) to let the router walk the failover chain.

object

Typed options for this service. Validation is strict, so an unknown key or an out-of-enum value returns a corrective 400 instead of being dropped.

Hide options

enum

Listing sort. Overrides a sort suffix present in the URL. One of: hot, new, top, rising.

enum

Time window, applied when sort is “top”. One of: hour, day, week, month, year, all.

string (YYYY-MM-DD)

Only posts created on/after this UTC date (offer-dependent).

string (YYYY-MM-DD)

Only posts created before this UTC date (offer-dependent).

Accepted URL formats

Format	Example
`https://www.reddit.com/r/<subreddit>`	`https://www.reddit.com/r/programming`

A sort suffix (/hot, /new, /top, /rising) is accepted too. /r/all and /r/popular work.

Offers

In failover order. The head serves unless you pin another with provider, and served_by in the response names the one that answered.

Offer	Inputs per call
`apify/harshmaur`	10
`apify/trudax`	10

Prices are live in the catalogue: GET /v1/services/reddit/subreddit.posts. See Credits for how a call is billed.

Response

data[] holds the normalized records, served_by names the offer that answered, and credits_used carries the actual charge. The example response is a real run with values shortened for readability. A field is present when Reddit exposes it for that item, so the exact set varies record to record.

curl -X POST https://api.socialrouter.io/v1/reddit/subreddit.posts \
  -H "Authorization: Bearer sr_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.reddit.com/r/programming",
    "limit": 50,
    "options": {
      "sort": "hot"
    }
  }'

const response = await fetch(
  "https://api.socialrouter.io/v1/reddit/subreddit.posts",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer sr_live_your_key",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      url: "https://www.reddit.com/r/programming",
      limit: 50,
      options: {
        sort: "hot"
      }
    }),
  },
);

import requests

response = requests.post(
    "https://api.socialrouter.io/v1/reddit/subreddit.posts",
    headers={"Authorization": "Bearer sr_live_your_key"},
    json={
      "url": "https://www.reddit.com/r/programming",
      "limit": 50,
      "options": {
        "sort": "hot"
      }
    },
)

const run = await sr.run("reddit/subreddit.posts", {
  url: "https://www.reddit.com/r/programming",
  limit: 50,
  options: {
    sort: "hot"
  }
});

{
  "id": "ext_a1b2c3d4",
  "status": "completed",
  "platform": "reddit",
  "service": "subreddit.posts",
  "url": "https://www.reddit.com/r/programming",
  "served_by": "apify/trudax",
  "data": [
    {
      "name": "lelanthran",
      "title": "The Difference Between a Button and a Link",
      "profile_url": "https://www.reddit.com/r/programming/comments/1v9lgdk/the_difference_between_a_button_and_a_link/",
      "source": "reddit",
      "extracted_at": "2026-07-29T16:13:10.167Z",
      "post_id": "1v9lgdk",
      "post_url": "https://www.reddit.com/r/programming/comments/1v9lgdk/the_difference_between_a_button_and_a_link/",
      "community_name": "programming",
      "date_posted": "2026-07-29T04:20:35.055Z",
      "num_upvotes": 66,
      "num_comments": 36,
      "upvote_ratio": 0.84375,
      "author_name": "lelanthran",
      "content_type": "link",
      "media_link": "https://unplannedobsolescence.com/blog/buttons-vs-links/",
      "image_urls": [
        "https://styles.redditmedia.com/t5_2fwo/styles/communityIcon_1bqa1ibfp8q11.png?width=96&height=96&frame=1&auto=webp&s=..."
      ]
    }
  ],
  "pagination": {
    "total": 1,
    "returned": 1
  },
  "created_at": "2026-07-30T12:00:00Z",
  "completed_at": "2026-07-30T12:00:03Z"
}

OverviewEvery Facebook endpoint on SocialRouter: what each one takes, what it returns, and which sources serve it.

curl -X POST https://api.socialrouter.io/v1/reddit/subreddit.posts \
  -H "Authorization: Bearer sr_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.reddit.com/r/programming",
    "limit": 50,
    "options": {
      "sort": "hot"
    }
  }'

const response = await fetch(
  "https://api.socialrouter.io/v1/reddit/subreddit.posts",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer sr_live_your_key",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      url: "https://www.reddit.com/r/programming",
      limit: 50,
      options: {
        sort: "hot"
      }
    }),
  },
);

import requests

response = requests.post(
    "https://api.socialrouter.io/v1/reddit/subreddit.posts",
    headers={"Authorization": "Bearer sr_live_your_key"},
    json={
      "url": "https://www.reddit.com/r/programming",
      "limit": 50,
      "options": {
        "sort": "hot"
      }
    },
)

const run = await sr.run("reddit/subreddit.posts", {
  url: "https://www.reddit.com/r/programming",
  limit: 50,
  options: {
    sort: "hot"
  }
});

{
  "id": "ext_a1b2c3d4",
  "status": "completed",
  "platform": "reddit",
  "service": "subreddit.posts",
  "url": "https://www.reddit.com/r/programming",
  "served_by": "apify/trudax",
  "data": [
    {
      "name": "lelanthran",
      "title": "The Difference Between a Button and a Link",
      "profile_url": "https://www.reddit.com/r/programming/comments/1v9lgdk/the_difference_between_a_button_and_a_link/",
      "source": "reddit",
      "extracted_at": "2026-07-29T16:13:10.167Z",
      "post_id": "1v9lgdk",
      "post_url": "https://www.reddit.com/r/programming/comments/1v9lgdk/the_difference_between_a_button_and_a_link/",
      "community_name": "programming",
      "date_posted": "2026-07-29T04:20:35.055Z",
      "num_upvotes": 66,
      "num_comments": 36,
      "upvote_ratio": 0.84375,
      "author_name": "lelanthran",
      "content_type": "link",
      "media_link": "https://unplannedobsolescence.com/blog/buttons-vs-links/",
      "image_urls": [
        "https://styles.redditmedia.com/t5_2fwo/styles/communityIcon_1bqa1ibfp8q11.png?width=96&height=96&frame=1&auto=webp&s=..."
      ]
    }
  ],
  "pagination": {
    "total": 1,
    "returned": 1
  },
  "created_at": "2026-07-30T12:00:00Z",
  "completed_at": "2026-07-30T12:00:03Z"
}

Services

Catalogue

Account

LinkedIn

Instagram

X

Reddit

Facebook

TikTok

YouTube

Pinterest

Bluesky

Snapchat

Google Maps

Body

Accepted URL formats

Offers

Response

​Body

​Accepted URL formats

​Offers

​Response

Body

Accepted URL formats

Offers

Response