Skip to main content
GET
/
v1
/
scrape
/
reddit
/
subreddit
Subreddit Posts
curl --request GET \
  --url https://api.sociavault.com/v1/scrape/reddit/subreddit \
  --header 'X-API-Key: <api-key>'
{
  "posts": [
    {
      "subreddit": "AskReddit",
      "selftext": "",
      "author_fullname": "t2_aelahp9al",
      "saved": false,
      "gilded": 0,
      "clicked": false,
      "title": "What are your thoughts on California’s bill that would ban most law enforcement officers from wearing face masks while on duty?",
      "link_flair_richtext": [
        "<unknown>"
      ],
      "subreddit_name_prefixed": "r/AskReddit",
      "hidden": false,
      "pwls": 6,
      "downs": 0,
      "hide_score": false,
      "name": "t3_1ldr6b9",
      "quarantine": false,
      "link_flair_text_color": "dark",
      "upvote_ratio": 0.93,
      "subreddit_type": "public",
      "ups": 12606,
      "total_awards_received": 0,
      "media_embed": {},
      "is_original_content": false,
      "user_reports": [
        "<unknown>"
      ],
      "is_reddit_media_domain": false,
      "is_meta": false,
      "secure_media_embed": {},
      "can_mod_post": false,
      "score": 12606,
      "is_created_from_ads_ui": false,
      "author_premium": false,
      "thumbnail": "",
      "edited": false,
      "author_flair_richtext": [
        "<unknown>"
      ],
      "gildings": {},
      "is_self": true,
      "created": 1750176516,
      "link_flair_type": "text",
      "wls": 6,
      "author_flair_type": "text",
      "domain": "self.AskReddit",
      "allow_live_comments": false,
      "archived": false,
      "no_follow": false,
      "is_crosspostable": false,
      "pinned": false,
      "over_18": false,
      "all_awardings": [
        "<unknown>"
      ],
      "awarders": [
        "<unknown>"
      ],
      "media_only": false,
      "can_gild": false,
      "spoiler": false,
      "locked": false,
      "treatment_tags": [
        "<unknown>"
      ],
      "visited": false,
      "subreddit_id": "t5_2qh1i",
      "author_is_blocked": false,
      "link_flair_background_color": "",
      "id": "1ldr6b9",
      "is_robot_indexable": true,
      "author": "Ecstatic-Medium-6320",
      "num_comments": 1921,
      "send_replies": false,
      "contest_mode": false,
      "mod_reports": [
        "<unknown>"
      ],
      "author_patreon_flair": false,
      "permalink": "/r/AskReddit/comments/1ldr6b9/what_are_your_thoughts_on_californias_bill_that/",
      "stickied": false,
      "url": "https://www.reddit.com/r/AskReddit/comments/1ldr6b9/what_are_your_thoughts_on_californias_bill_that/",
      "subreddit_subscribers": 56098571,
      "created_utc": 1750176516,
      "num_crossposts": 1,
      "is_video": false,
      "approved_at_utc": "<unknown>",
      "mod_reason_title": "<unknown>",
      "link_flair_css_class": "<unknown>",
      "top_awarded_type": "<unknown>",
      "author_flair_background_color": "<unknown>",
      "author_flair_template_id": "<unknown>",
      "secure_media": "<unknown>",
      "category": "<unknown>",
      "link_flair_text": "<unknown>",
      "approved_by": "<unknown>",
      "author_flair_css_class": "<unknown>",
      "content_categories": "<unknown>",
      "mod_note": "<unknown>",
      "removed_by_category": "<unknown>",
      "banned_by": "<unknown>",
      "selftext_html": "<unknown>",
      "likes": "<unknown>",
      "suggested_sort": "<unknown>",
      "banned_at_utc": "<unknown>",
      "view_count": "<unknown>",
      "author_flair_text": "<unknown>",
      "removed_by": "<unknown>",
      "num_reports": "<unknown>",
      "distinguished": "<unknown>",
      "mod_reason_by": "<unknown>",
      "removal_reason": "<unknown>",
      "report_reasons": "<unknown>",
      "discussion_type": "<unknown>",
      "author_flair_text_color": "<unknown>",
      "media": "<unknown>"
    }
  ],
  "after": "t3_1ld8q7h"
}
💳 1 credit per request

Authorizations

X-API-Key
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

Query Parameters

subreddit
string
required

Subreddit name

timeframe
enum<string>

Timeframe to get posts from.

Available options:
all,
day,
week,
month,
year
sort
enum<string>

Sort order.

Available options:
best,
hot,
new,
top,
rising
after
string

After to get more posts. Get 'after' from previous response.

Example:

"t3_1234567890"

trim
boolean

Set to true for a trimmed down version of the response

Example:

false

Response

Successful response

posts
object[]
required
after
string
required
Example:

"t3_1ld8q7h"