Skip to main content
GET
/
v1
/
scrape
/
reddit
/
search
Search
curl --request GET \
  --url https://api.sociavault.com/v1/scrape/reddit/search \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "posts": [
    {
      "subreddit": "webscraping",
      "selftext": "1. Don't try putting scraping tools in Lambda.",
      "author_fullname": "t2_b88jvxe1",
      "saved": false,
      "gilded": 0,
      "clicked": false,
      "title": "After 2 months learning scraping, I'm sharing what I learned!",
      "link_flair_richtext": [
        "<unknown>"
      ],
      "subreddit_name_prefixed": "r/webscraping",
      "hidden": false,
      "pwls": 6,
      "downs": 0,
      "hide_score": false,
      "name": "t3_1flgwup",
      "quarantine": false,
      "link_flair_text_color": "dark",
      "upvote_ratio": 0.99,
      "subreddit_type": "public",
      "ups": 361,
      "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": 361,
      "is_created_from_ads_ui": false,
      "author_premium": false,
      "thumbnail": "self",
      "edited": 1726964065,
      "author_flair_richtext": [
        "<unknown>"
      ],
      "gildings": {},
      "is_self": true,
      "created": 1726851591,
      "link_flair_type": "text",
      "wls": 6,
      "author_flair_type": "text",
      "domain": "self.webscraping",
      "allow_live_comments": false,
      "selftext_html": "&lt;!-- SC_OFF --&gt;&lt;div class=\"md\"&gt;&lt;ol&gt;\n&lt;li&gt;Don&amp;#39;t try putting scraping tools in Lambda.",
      "archived": true,
      "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_318ly",
      "author_is_blocked": false,
      "link_flair_background_color": "",
      "id": "1flgwup",
      "is_robot_indexable": true,
      "author": "Sea_Cardiologist_212",
      "num_comments": 102,
      "send_replies": true,
      "contest_mode": false,
      "mod_reports": [
        "<unknown>"
      ],
      "author_patreon_flair": false,
      "permalink": "/r/webscraping/comments/1flgwup/after_2_months_learning_scraping_im_sharing_what/",
      "stickied": false,
      "url": "https://www.reddit.com/r/webscraping/comments/1flgwup/after_2_months_learning_scraping_im_sharing_what/",
      "subreddit_subscribers": 58838,
      "created_utc": 1726851591,
      "num_crossposts": 0,
      "is_video": false,
      "created_at_iso": "2024-09-20T16:59:51.000Z",
      "approved_at_utc": "<unknown>",
      "mod_reason_title": "<unknown>",
      "link_flair_css_class": "<unknown>",
      "thumbnail_height": "<unknown>",
      "top_awarded_type": "<unknown>",
      "author_flair_background_color": "<unknown>",
      "thumbnail_width": "<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>",
      "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_1ihh437"
}
💳 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

​
query
string
required

Search query

​
sort
enum<string>

Sort by

Available options:
relevance,
new,
top,
comment_count
Example:

"relevance"

​
timeframe
enum<string>

Timeframe

Available options:
all,
day,
week,
month,
year
Example:

"all"

​
after
string

Used to paginate to next page

Example:

"t3_1i8z28z"

​
trim
boolean

Set to true for a trimmed down version of the response

Example:

false

Response

Successful response

​
success
boolean
required
Example:

true

​
posts
object[]
required
​
after
string
required
Example:

"t3_1ihh437"