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>'
{ "success": true, "data": { "success": true, "posts": { "0": { "approved_at_utc": null, "subreddit": "AskReddit", "selftext": "", "author_fullname": "t2_hopuf4nq9", "saved": false, "mod_reason_title": null, "gilded": 0, "clicked": false, "title": "Women: What blowjob tips would you give other women?", "link_flair_richtext": {}, "subreddit_name_prefixed": "r/AskReddit", "hidden": false, "pwls": 6, "link_flair_css_class": null, "downs": 0, "top_awarded_type": null, "hide_score": false, "name": "t3_1qzdptk", "quarantine": false, "link_flair_text_color": "dark", "upvote_ratio": 0.81, "author_flair_background_color": null, "subreddit_type": "public", "ups": 4708, "total_awards_received": 0, "media_embed": {}, "author_flair_template_id": null, "is_original_content": false, "user_reports": {}, "secure_media": null, "is_reddit_media_domain": false, "is_meta": false, "category": null, "secure_media_embed": {}, "link_flair_text": null, "can_mod_post": false, "score": 4708, "approved_by": null, "is_created_from_ads_ui": false, "author_premium": false, "thumbnail": "", "edited": 1770571371, "author_flair_css_class": null, "author_flair_richtext": {}, "gildings": {}, "content_categories": null, "is_self": true, "mod_note": null, "created": 1770568900, "link_flair_type": "text", "wls": 6, "removed_by_category": null, "banned_by": null, "author_flair_type": "text", "domain": "self.AskReddit", "allow_live_comments": false, "selftext_html": null, "likes": null, "suggested_sort": null, "banned_at_utc": null, "view_count": null, "archived": false, "no_follow": false, "is_crosspostable": false, "pinned": false, "over_18": true, "all_awardings": {}, "awarders": {}, "media_only": false, "can_gild": false, "spoiler": false, "locked": false, "author_flair_text": null, "treatment_tags": {}, "visited": false, "removed_by": null, "num_reports": null, "distinguished": null, "subreddit_id": "t5_2qh1i", "author_is_blocked": false, "mod_reason_by": null, "removal_reason": null, "link_flair_background_color": "", "id": "1qzdptk", "is_robot_indexable": true, "report_reasons": null, "author": "workethic290", "discussion_type": null, "num_comments": 1774, "send_replies": true, "contest_mode": false, "mod_reports": {}, "author_patreon_flair": false, "author_flair_text_color": null, "permalink": "/r/AskReddit/comments/1qzdptk/women_what_blowjob_tips_would_you_give_other_women/", "stickied": false, "url": "https://www.reddit.com/r/AskReddit/comments/1qzdptk/women_what_blowjob_tips_would_you_give_other_women/", "subreddit_subscribers": 57727945, "created_utc": 1770568900, "num_crossposts": 0, "media": null, "is_video": false } }, "after": "t3_1qzkwjb" }, "creditsUsed": 1 }
💳 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

Key Response Fields:

  • data.posts[n].id: Short Reddit post ID
  • data.posts[n].title: Post title text
  • data.posts[n].author: Reddit username of the poster
  • data.posts[n].subreddit: Name of the subreddit
  • data.posts[n].score: Net upvote score
  • data.posts[n].upvote_ratio: Ratio of upvotes vs total votes (0–1)
  • data.posts[n].num_comments: Comment count
  • data.posts[n].url: Full URL to the post
  • data.posts[n].created_utc: Unix timestamp of post creation
  • data.posts[n].is_video: Whether the post contains a video
  • data.after: Pagination cursor — pass as after param for the next page