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,
  "data": {
    "success": true,
    "posts": {
      "0": {
        "approved_at_utc": null,
        "subreddit": "oddlysatisfying",
        "selftext": "",
        "author_fullname": "t2_1ylfum5t",
        "saved": false,
        "mod_reason_title": null,
        "gilded": 0,
        "clicked": false,
        "title": "Some super clean football!",
        "link_flair_richtext": {},
        "subreddit_name_prefixed": "r/oddlysatisfying",
        "hidden": false,
        "pwls": 6,
        "link_flair_css_class": null,
        "downs": 0,
        "thumbnail_height": 140,
        "top_awarded_type": null,
        "hide_score": false,
        "name": "t3_1ps03s7",
        "quarantine": false,
        "link_flair_text_color": "dark",
        "upvote_ratio": 0.97,
        "author_flair_background_color": null,
        "subreddit_type": "public",
        "ups": 15906,
        "total_awards_received": 0,
        "media_embed": {},
        "thumbnail_width": 140,
        "author_flair_template_id": null,
        "is_original_content": false,
        "user_reports": {},
        "secure_media": {
          "reddit_video": {
            "bitrate_kbps": 1200,
            "fallback_url": "https://v.redd.it/bvpbu93m7i8g1/CMAF_480.mp4?source=fallback",
            "has_audio": true,
            "height": 600,
            "width": 480,
            "scrubber_media_url": "https://v.redd.it/bvpbu93m7i8g1/CMAF_96.mp4",
            "dash_url": "https://v.redd.it/bvpbu93m7i8g1/DASHPlaylist.mpd?a=1773194318%2COGI4NzUyMGQ4N2I4MzNmM2Y4ZjI4ZDZkYzk0MTA1NTExY2VlMTkwZTJiZDVlNzBhZjM1MWQ2ZTI1ZTBiM2NlYw%3D%3D&amp;v=1&amp;f=sd",
            "duration": 17,
            "hls_url": "https://v.redd.it/bvpbu93m7i8g1/HLSPlaylist.m3u8?a=1773194318%2CM2Y2NjdmYWUzMDc0NTYxNmFiNDNjNTU0Y2VhMDIzMDRkNzRkZTRmMWEzODVlZDk4MTExNWFlODVkYzdkYjZlMg%3D%3D&amp;v=1&amp;f=sd",
            "is_gif": false,
            "transcoding_status": "completed"
          }
        },
        "is_reddit_media_domain": true,
        "is_meta": false,
        "category": null,
        "secure_media_embed": {},
        "link_flair_text": null,
        "can_mod_post": false,
        "score": 15906,
        "approved_by": null,
        "is_created_from_ads_ui": false,
        "author_premium": false,
        "thumbnail": "https://external-preview.redd.it/ZWN4M2IyNW03aThnMdZxmJ1-G4b_V-TKjp1CWu9UD7XK6zupItxG6S8VRE1E.png?width=140&amp;height=140&amp;crop=1:1,smart&amp;format=jpg&amp;auto=webp&amp;s=3932cc3a7c6b47a49fbcbc29b4df5b27efa8b906",
        "edited": false,
        "author_flair_css_class": null,
        "author_flair_richtext": {},
        "gildings": {},
        "post_hint": "hosted:video",
        "content_categories": null,
        "is_self": false,
        "mod_note": null,
        "created": 1766299621,
        "link_flair_type": "text",
        "wls": 6,
        "removed_by_category": null,
        "banned_by": null,
        "author_flair_type": "text",
        "domain": "v.redd.it",
        "allow_live_comments": false,
        "selftext_html": null,
        "likes": null,
        "suggested_sort": null,
        "banned_at_utc": null,
        "url_overridden_by_dest": "https://v.redd.it/bvpbu93m7i8g1",
        "view_count": null,
        "archived": false,
        "no_follow": false,
        "is_crosspostable": false,
        "pinned": false,
        "over_18": false,
        "preview": {
          "images": {
            "0": {
              "source": {
                "url": "https://external-preview.redd.it/ZWN4M2IyNW03aThnMdZxmJ1-G4b_V-TKjp1CWu9UD7XK6zupItxG6S8VRE1E.png?format=pjpg&amp;auto=webp&amp;s=56a3425b2e47c6b51a41e05be929ffc8591726e8",
                "width": 1440,
                "height": 1800
              },
              "resolutions": {
                "0": {
                  "url": "https://external-preview.redd.it/ZWN4M2IyNW03aThnMdZxmJ1-G4b_V-TKjp1CWu9UD7XK6zupItxG6S8VRE1E.png?width=108&amp;crop=smart&amp;format=pjpg&amp;auto=webp&amp;s=0490b5b161abd1153dd7ab7570fda758a393219f",
                  "width": 108,
                  "height": 135
                },
                "1": {
                  "url": "https://external-preview.redd.it/ZWN4M2IyNW03aThnMdZxmJ1-G4b_V-TKjp1CWu9UD7XK6zupItxG6S8VRE1E.png?width=216&amp;crop=smart&amp;format=pjpg&amp;auto=webp&amp;s=cd250ce37a5be797841061d7fcbafa697cdd31f3",
                  "width": 216,
                  "height": 270
                },
                "2": {
                  "url": "https://external-preview.redd.it/ZWN4M2IyNW03aThnMdZxmJ1-G4b_V-TKjp1CWu9UD7XK6zupItxG6S8VRE1E.png?width=320&amp;crop=smart&amp;format=pjpg&amp;auto=webp&amp;s=213bed307e4781a00aa14f8113e5396e2eea85e6",
                  "width": 320,
                  "height": 400
                },
                "3": {
                  "url": "https://external-preview.redd.it/ZWN4M2IyNW03aThnMdZxmJ1-G4b_V-TKjp1CWu9UD7XK6zupItxG6S8VRE1E.png?width=640&amp;crop=smart&amp;format=pjpg&amp;auto=webp&amp;s=eee57393351802bac50f28d55546f894d7684669",
                  "width": 640,
                  "height": 800
                },
                "4": {
                  "url": "https://external-preview.redd.it/ZWN4M2IyNW03aThnMdZxmJ1-G4b_V-TKjp1CWu9UD7XK6zupItxG6S8VRE1E.png?width=960&amp;crop=smart&amp;format=pjpg&amp;auto=webp&amp;s=553205d24aa893992866dae9eeb7741d75ed77de",
                  "width": 960,
                  "height": 1200
                },
                "5": {
                  "url": "https://external-preview.redd.it/ZWN4M2IyNW03aThnMdZxmJ1-G4b_V-TKjp1CWu9UD7XK6zupItxG6S8VRE1E.png?width=1080&amp;crop=smart&amp;format=pjpg&amp;auto=webp&amp;s=0e1bc476d16291595cc92cf2c2addc6c2ff0ce5b",
                  "width": 1080,
                  "height": 1350
                }
              },
              "variants": {},
              "id": "ZWN4M2IyNW03aThnMdZxmJ1-G4b_V-TKjp1CWu9UD7XK6zupItxG6S8VRE1E"
            }
          },
          "enabled": false
        },
        "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_2x93b",
        "author_is_blocked": false,
        "mod_reason_by": null,
        "removal_reason": null,
        "link_flair_background_color": "",
        "id": "1ps03s7",
        "is_robot_indexable": true,
        "report_reasons": null,
        "author": "HassanMoRiT",
        "discussion_type": null,
        "num_comments": 226,
        "send_replies": true,
        "contest_mode": false,
        "mod_reports": {},
        "author_patreon_flair": false,
        "author_flair_text_color": null,
        "permalink": "/r/oddlysatisfying/comments/1ps03s7/some_super_clean_football/",
        "stickied": false,
        "url": "https://www.reddit.com/r/oddlysatisfying/comments/1ps03s7/some_super_clean_football/",
        "subreddit_subscribers": 12384607,
        "created_utc": 1766299621,
        "num_crossposts": 0,
        "media": {
          "reddit_video": {
            "bitrate_kbps": 1200,
            "fallback_url": "https://v.redd.it/bvpbu93m7i8g1/CMAF_480.mp4?source=fallback",
            "has_audio": true,
            "height": 600,
            "width": 480,
            "scrubber_media_url": "https://v.redd.it/bvpbu93m7i8g1/CMAF_96.mp4",
            "dash_url": "https://v.redd.it/bvpbu93m7i8g1/DASHPlaylist.mpd?a=1773194318%2COGI4NzUyMGQ4N2I4MzNmM2Y4ZjI4ZDZkYzk0MTA1NTExY2VlMTkwZTJiZDVlNzBhZjM1MWQ2ZTI1ZTBiM2NlYw%3D%3D&amp;v=1&amp;f=sd",
            "duration": 17,
            "hls_url": "https://v.redd.it/bvpbu93m7i8g1/HLSPlaylist.m3u8?a=1773194318%2CM2Y2NjdmYWUzMDc0NTYxNmFiNDNjNTU0Y2VhMDIzMDRkNzRkZTRmMWEzODVlZDk4MTExNWFlODVkYzdkYjZlMg%3D%3D&amp;v=1&amp;f=sd",
            "is_gif": false,
            "transcoding_status": "completed"
          }
        },
        "is_video": true,
        "created_at_iso": "2025-12-21T06:47:01.000Z"
      }
    },
    "after": "t3_1qcqb77"
  },
  "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

​
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

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 where the post appears
  • data.posts[n].score: Net upvote score
  • data.posts[n].upvote_ratio: Ratio of upvotes to total votes (0–1)
  • data.posts[n].num_comments: Comment count
  • data.posts[n].url: Full URL to the post
  • data.posts[n].is_video: Whether the post contains native Reddit video
  • data.after: Pagination token — pass as after param for the next page