Subreddit Search
curl --request GET \
--url https://api.sociavault.com/v1/scrape/reddit/subreddit/search \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.sociavault.com/v1/scrape/reddit/subreddit/search"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.sociavault.com/v1/scrape/reddit/subreddit/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sociavault.com/v1/scrape/reddit/subreddit/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.sociavault.com/v1/scrape/reddit/subreddit/search"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sociavault.com/v1/scrape/reddit/subreddit/search")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sociavault.com/v1/scrape/reddit/subreddit/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"success": true,
"posts": {
"0": {
"id": "t3_1o09lhe",
"post_id": "t3_1o09lhe",
"title": "Daily Simple Questions Thread - October 07, 2025",
"url": "https://www.reddit.com/r/Fitness/comments/1o09lhe/daily_simple_questions_thread_october_07_2025/",
"permalink": "/r/Fitness/comments/1o09lhe/daily_simple_questions_thread_october_07_2025/",
"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",
"banner": null,
"description": "A place for the pursuit of physical fitness goals.\n\nPlease see the r/Fitness Wiki and FAQ at https://thefitness.wiki for help with common questions.",
"weekly_visitors": 913382,
"weekly_contributions": 2229
},
"votes": 22,
"num_comments": 128,
"created_at": "2025-10-07T09:01:26.103000+0000",
"created_at_iso": "2025-10-07T09:01:26.103Z",
"thumbnail": null,
"thumbnail_blurred": false,
"position": 0,
"relative_position": 0
}
},
"cursor": "eyJjYW5kaWRhdGVzX3JldHVybmVkIjoie1wic2VjdGlvbl8xX3BpcGVsaW5lXzBfZ2xvYmFsX21vZGlmaWVyc1wiOlwiM1wiLFwic2VjdGlvbl8xX3BpcGVsaW5lXzFfbG9jYWxfbW9kaWZpZXJzXCI6XCIzXCIsXCJzZWN0aW9uXzJfcGlwZWxpbmVfN19wb3N0X3NlYXJjaFwiOlwiN1wiLFwic2VjdGlvbl8zX3BpcGVsaW5lXzBfc2lkZWJhcl9jb21tdW5pdHlfaW5mb1wiOlwiMFwifSIsImV4cGVyaWVuY2Vfc2VsZWN0aW9uIjoicG9zdF93aXRoX2NvbW11bml0eV9zaWRlYmFyIiwiZXhwZXJpZW5jZV92ZXJzaW9uIjoiZGVmYXVsdCIsInNlY3Rpb25fMl9waXBlbGluZV83X3Bvc3Rfc2VhcmNoIjoiNyJ9"
},
"credits_used": 1
}{
"success": false,
"error": "Subreddit name is required (e.g. 'Fitness', not 'r/Fitness')"
}{
"success": false,
"error": "Insufficient credits",
"required": 1,
"available": 0
}Reddit
Subreddit Search
Search within a subreddit for posts, comments, or media matching a query
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>'import requests
url = "https://api.sociavault.com/v1/scrape/reddit/subreddit/search"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.sociavault.com/v1/scrape/reddit/subreddit/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sociavault.com/v1/scrape/reddit/subreddit/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.sociavault.com/v1/scrape/reddit/subreddit/search"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sociavault.com/v1/scrape/reddit/subreddit/search")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sociavault.com/v1/scrape/reddit/subreddit/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"success": true,
"posts": {
"0": {
"id": "t3_1o09lhe",
"post_id": "t3_1o09lhe",
"title": "Daily Simple Questions Thread - October 07, 2025",
"url": "https://www.reddit.com/r/Fitness/comments/1o09lhe/daily_simple_questions_thread_october_07_2025/",
"permalink": "/r/Fitness/comments/1o09lhe/daily_simple_questions_thread_october_07_2025/",
"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",
"banner": null,
"description": "A place for the pursuit of physical fitness goals.\n\nPlease see the r/Fitness Wiki and FAQ at https://thefitness.wiki for help with common questions.",
"weekly_visitors": 913382,
"weekly_contributions": 2229
},
"votes": 22,
"num_comments": 128,
"created_at": "2025-10-07T09:01:26.103000+0000",
"created_at_iso": "2025-10-07T09:01:26.103Z",
"thumbnail": null,
"thumbnail_blurred": false,
"position": 0,
"relative_position": 0
}
},
"cursor": "eyJjYW5kaWRhdGVzX3JldHVybmVkIjoie1wic2VjdGlvbl8xX3BpcGVsaW5lXzBfZ2xvYmFsX21vZGlmaWVyc1wiOlwiM1wiLFwic2VjdGlvbl8xX3BpcGVsaW5lXzFfbG9jYWxfbW9kaWZpZXJzXCI6XCIzXCIsXCJzZWN0aW9uXzJfcGlwZWxpbmVfN19wb3N0X3NlYXJjaFwiOlwiN1wiLFwic2VjdGlvbl8zX3BpcGVsaW5lXzBfc2lkZWJhcl9jb21tdW5pdHlfaW5mb1wiOlwiMFwifSIsImV4cGVyaWVuY2Vfc2VsZWN0aW9uIjoicG9zdF93aXRoX2NvbW11bml0eV9zaWRlYmFyIiwiZXhwZXJpZW5jZV92ZXJzaW9uIjoiZGVmYXVsdCIsInNlY3Rpb25fMl9waXBlbGluZV83X3Bvc3Rfc2VhcmNoIjoiNyJ9"
},
"credits_used": 1
}{
"success": false,
"error": "Subreddit name is required (e.g. 'Fitness', not 'r/Fitness')"
}{
"success": false,
"error": "Insufficient credits",
"required": 1,
"available": 0
}💳 1 credit per request
Authorizations
Query Parameters
Subreddit name (e.g. 'Fitness', not 'r/Fitness' or a full URL)
Example:
"Fitness"
Search query to find matching content
Example:
"push ups"
Type of content to search for (default: posts). Response will only include the matching key
Available options:
posts, comments, media Example:
"posts"
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 to filter results
Available options:
all, year, month, week, day, hour Example:
"all"
Cursor for pagination. Get 'cursor' from previous response
Response
Successful response with search results
Key Response Fields:
data.posts[n].id: Reddit fullname of the post (e.g.t3_1o09lhe)data.posts[n].title: Title text of the postdata.posts[n].url: Full URL to the Reddit postdata.posts[n].votes: Net upvote countdata.posts[n].num_comments: Number of comments on the postdata.posts[n].created_at_iso: ISO 8601 creation timestampdata.posts[n].subreddit.name: Name of the subreddit the post belongs todata.cursor: Base64 pagination cursor — pass ascursorparam to retrieve the next page