Skip to main content
GET
/
v1
/
scrape
/
reddit
/
subreddit
/
search
Subreddit Search
curl --request GET \
  --url https://api.sociavault.com/v1/scrape/reddit/subreddit/search \
  --header 'X-API-Key: <api-key>'
{
  "posts": [
    {
      "id": "t3_8gmjrb",
      "post_id": "t3_8gmjrb",
      "title": "Is doing 50-100 pushups a day doing anything?",
      "url": "https://www.reddit.com/r/Fitness/comments/8gmjrb/is_doing_50100_pushups_a_day_doing_anything/",
      "permalink": "/r/Fitness/comments/8gmjrb/is_doing_50100_pushups_a_day_doing_anything/",
      "nsfw": false,
      "spoiler": false,
      "is_crosspost": false,
      "subreddit": {
        "id": "t5_2qhx4",
        "name": "Fitness",
        "nsfw": false,
        "quarantined": false,
        "icon": "https://b.thumbs.redditmedia.com/Ted4KOMuRbaCYlDS55cTqjpVVZ2ENHKtYFbBFjI1i2o.png",
        "description": "A place for the pursuit of physical fitness goals.",
        "weekly_visitors": 898726,
        "weekly_contributions": 1827
      },
      "votes": 1414,
      "num_comments": 582,
      "created_at": "2018-05-03T01:09:17.620000+0000",
      "created_at_iso": "2018-05-03T01:09:17.620Z",
      "position": 0
    }
  ],
  "comments": [
    {
      "id": "t1_nxf7p27",
      "post_id": "t3_1q2p898",
      "author": "Philser23",
      "body": "On the 30th my girlfriend out of the blue decided her new year's resolution would be to start going to the gym.",
      "body_html": "<p>On the 30th my girlfriend out of the blue decided...</p>",
      "votes": 123,
      "url": "https://www.reddit.com/r/Fitness/comments/1q2p898/gym_story_saturday/nxf7p27/",
      "created_at": "2026-01-03T11:26:02.434000+0000",
      "post": {
        "id": "t3_1q2p898",
        "title": "Gym Story Saturday",
        "url": "https://www.reddit.com/r/Fitness/comments/1q2p898/gym_story_saturday/"
      },
      "subreddit": {
        "id": "t5_2qhx4",
        "name": "Fitness"
      },
      "position": 0
    }
  ],
  "media": [
    {
      "id": "t3_geo4x",
      "title": "Bodyweight training for really strong people",
      "url": "https://www.reddit.com/r/Fitness/comments/geo4x/bodyweight_training_for_really_strong_people_see/",
      "media_type": "image",
      "image": {
        "src": "https://external-preview.redd.it/X6lz5yGIzqVA5LcI9w-FsQJJHhXoCugDhsXgWW3I404.jpg",
        "width": 480,
        "height": 360
      },
      "nsfw": false,
      "subreddit": {
        "id": "t5_2qhx4",
        "name": "Fitness"
      },
      "position": 0
    }
  ],
  "cursor": "eyJjYW5kaWRhdGVzX3JldHVybmVkIjoie1wic2VjdGlvbl8xX3BpcGVsaW5lXzBfZ2xvYmFsX21vZGlmaWVyc1wiOlwiM1wiLFwic2VjdGlvbl8xX3BpcGVsaW5lXzFfbG9jYWxfbW9kaWZpZXJzXCI6XCIzXCJ9\""
}
💳 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 (e.g. 'Fitness', not 'r/Fitness' or a full URL)

Example:

"Fitness"

query
string

Search query to find matching content

Example:

"push ups"

filter
enum<string>

Type of content to search for (default: posts). Response will only include the matching key

Available options:
posts,
comments,
media
Example:

"posts"

sort
enum<string>

Sort order. For posts/media: relevance, hot, top, new, comments. For comments: relevance, top, new

Available options:
relevance,
hot,
top,
new,
comments
Example:

"relevance"

timeframe
enum<string>

Timeframe to filter results

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

"all"

cursor
string

Cursor for pagination. Get 'cursor' from previous response

Response

Successful response with search results

posts
object[]

Posts matching the search query (when filter=posts or no filter)

comments
object[]

Comments matching the search query (when filter=comments)

media
object[]

Media posts matching the search query (when filter=media)

cursor
string

Cursor for pagination. Use this in the next request to get more results

Example:

"eyJjYW5kaWRhdGVzX3JldHVybmVkIjoie1wic2VjdGlvbl8xX3BpcGVsaW5lXzBfZ2xvYmFsX21vZGlmaWVyc1wiOlwiM1wiLFwic2VjdGlvbl8xX3BpcGVsaW5lXzFfbG9jYWxfbW9kaWZpZXJzXCI6XCIzXCJ9\""