Search
curl --request GET \
--url https://api.sociavault.com/v1/scrape/instagram/search \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.sociavault.com/v1/scrape/instagram/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/instagram/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/instagram/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/instagram/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/instagram/search")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sociavault.com/v1/scrape/instagram/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,
"credits_charged": 1,
"query": "nike",
"users": {
"0": {
"position": 0,
"id": "13460080",
"username": "nike",
"full_name": "Nike",
"is_verified": true,
"profile_pic_url": "https://instagram.fsac1-2.fna.fbcdn.net/v/t51.82787-19/551608484_18567162979020081_1135468084872726555_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4zOTkuYzIifQ&_nc_ht=instagram.fsac1-2.fna.fbcdn.net&_nc_cat=1&_nc_oc=Q6cZ2gHjBIKaUr_9pd3nINydiFqJv22UgdcCa3XxRGEca4DXxkhcYCq04Xd2WhO2e7Jiu2k&_nc_ohc=jOWQehR8N0kQ7kNvwGnufdQ&_nc_gid=dnxxnK_q5etfB3UQyzX8Iw&edm=APs17CUBAAAA&ccb=7-5&oh=00_AQFc4e1XxH7RdscoCEk_5pOJxbShCpVQIUokJi1ZQleC1Q&oe=6A73707A&_nc_sid=10d13b"
},
"1": {
"position": 1,
"id": "1109960748",
"username": "nikh.pv",
"full_name": "Νίκη Παυλίδου",
"is_verified": false,
"profile_pic_url": "https://instagram.fsac1-2.fna.fbcdn.net/v/t51.82787-19/748812390_18608746684008749_4406504406509178642_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.fsac1-2.fna.fbcdn.net&_nc_cat=105&_nc_oc=Q6cZ2gHjBIKaUr_9pd3nINydiFqJv22UgdcCa3XxRGEca4DXxkhcYCq04Xd2WhO2e7Jiu2k&_nc_ohc=iq7QMFSTbz0Q7kNvwHrIroV&_nc_gid=dnxxnK_q5etfB3UQyzX8Iw&edm=APs17CUBAAAA&ccb=7-5&oh=00_AQH2BMDhZvc35C01y519nwSLXU9igM_0q0Fk_gDJSpThaA&oe=6A73992D&_nc_sid=10d13b"
},
"2": {
"position": 3,
"id": "73862723921",
"username": "nikediits",
"full_name": "𝒩𝒾𝓀𝒶🪽",
"is_verified": false,
"profile_pic_url": "https://instagram.fsac1-2.fna.fbcdn.net/v/t51.82787-19/723557005_17900202573459922_5079670003947395208_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby42OTYuYzIifQ&_nc_ht=instagram.fsac1-2.fna.fbcdn.net&_nc_cat=1&_nc_oc=Q6cZ2gHjBIKaUr_9pd3nINydiFqJv22UgdcCa3XxRGEca4DXxkhcYCq04Xd2WhO2e7Jiu2k&_nc_ohc=YJw7qN3PCgIQ7kNvwEgyFlr&_nc_gid=dnxxnK_q5etfB3UQyzX8Iw&edm=APs17CUBAAAA&ccb=7-5&oh=00_AQHw5RvmhjjR-SuG9G4A2TAEqLC--aw4b82Qpisc40c4cQ&oe=6A73766F&_nc_sid=10d13b"
},
"3": {
"position": 4,
"id": "23678829",
"username": "nikefootball",
"full_name": "Nike Football",
"is_verified": true,
"profile_pic_url": "https://instagram.fsac1-2.fna.fbcdn.net/v/t51.82787-19/703222723_18606776074062830_6301137681281101191_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDAwLmMyIn0&_nc_ht=instagram.fsac1-2.fna.fbcdn.net&_nc_cat=1&_nc_oc=Q6cZ2gHjBIKaUr_9pd3nINydiFqJv22UgdcCa3XxRGEca4DXxkhcYCq04Xd2WhO2e7Jiu2k&_nc_ohc=vc6P1ivnXskQ7kNvwHL5V8x&_nc_gid=dnxxnK_q5etfB3UQyzX8Iw&edm=APs17CUBAAAA&ccb=7-5&oh=00_AQEP-J486Ttu1TGg2Pfs_pi-AFg-jpGz-AKRLah8VWrWgg&oe=6A7392BE&_nc_sid=10d13b"
}
},
"hashtags": {
"0": {
"position": 2,
"id": "17841562978125529",
"name": "nikewomen",
"media_count": 2036708,
"search_result_subtitle": null
},
"1": {
"position": 11,
"id": "17841563764097648",
"name": "nikeairmax",
"media_count": 4906405,
"search_result_subtitle": null
}
},
"places": {
"0": {
"position": 53,
"id": "715603272",
"name": "Nike",
"title": "Nike",
"subtitle": "",
"facebook_places_id": "106068296090172"
}
},
"keywords": {},
"rank_token": "933815c3-4008-42a9-8675-27f667382741"
},
"credits_used": 1,
"endpoint": "instagram/search"
}{
"error": "query is required for Instagram search"
}{
"error": "Invalid API key",
"docs": "https://docs.sociavault.com/authentication"
}{
"error": "Insufficient credits",
"required": 123,
"available": 123
}Instagram
Search
Instagram native search — find users, hashtags, and places. Use this for account or entity lookup. It returns one page and does not return posts.
GET
/
v1
/
scrape
/
instagram
/
search
Search
curl --request GET \
--url https://api.sociavault.com/v1/scrape/instagram/search \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.sociavault.com/v1/scrape/instagram/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/instagram/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/instagram/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/instagram/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/instagram/search")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sociavault.com/v1/scrape/instagram/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,
"credits_charged": 1,
"query": "nike",
"users": {
"0": {
"position": 0,
"id": "13460080",
"username": "nike",
"full_name": "Nike",
"is_verified": true,
"profile_pic_url": "https://instagram.fsac1-2.fna.fbcdn.net/v/t51.82787-19/551608484_18567162979020081_1135468084872726555_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4zOTkuYzIifQ&_nc_ht=instagram.fsac1-2.fna.fbcdn.net&_nc_cat=1&_nc_oc=Q6cZ2gHjBIKaUr_9pd3nINydiFqJv22UgdcCa3XxRGEca4DXxkhcYCq04Xd2WhO2e7Jiu2k&_nc_ohc=jOWQehR8N0kQ7kNvwGnufdQ&_nc_gid=dnxxnK_q5etfB3UQyzX8Iw&edm=APs17CUBAAAA&ccb=7-5&oh=00_AQFc4e1XxH7RdscoCEk_5pOJxbShCpVQIUokJi1ZQleC1Q&oe=6A73707A&_nc_sid=10d13b"
},
"1": {
"position": 1,
"id": "1109960748",
"username": "nikh.pv",
"full_name": "Νίκη Παυλίδου",
"is_verified": false,
"profile_pic_url": "https://instagram.fsac1-2.fna.fbcdn.net/v/t51.82787-19/748812390_18608746684008749_4406504406509178642_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.fsac1-2.fna.fbcdn.net&_nc_cat=105&_nc_oc=Q6cZ2gHjBIKaUr_9pd3nINydiFqJv22UgdcCa3XxRGEca4DXxkhcYCq04Xd2WhO2e7Jiu2k&_nc_ohc=iq7QMFSTbz0Q7kNvwHrIroV&_nc_gid=dnxxnK_q5etfB3UQyzX8Iw&edm=APs17CUBAAAA&ccb=7-5&oh=00_AQH2BMDhZvc35C01y519nwSLXU9igM_0q0Fk_gDJSpThaA&oe=6A73992D&_nc_sid=10d13b"
},
"2": {
"position": 3,
"id": "73862723921",
"username": "nikediits",
"full_name": "𝒩𝒾𝓀𝒶🪽",
"is_verified": false,
"profile_pic_url": "https://instagram.fsac1-2.fna.fbcdn.net/v/t51.82787-19/723557005_17900202573459922_5079670003947395208_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby42OTYuYzIifQ&_nc_ht=instagram.fsac1-2.fna.fbcdn.net&_nc_cat=1&_nc_oc=Q6cZ2gHjBIKaUr_9pd3nINydiFqJv22UgdcCa3XxRGEca4DXxkhcYCq04Xd2WhO2e7Jiu2k&_nc_ohc=YJw7qN3PCgIQ7kNvwEgyFlr&_nc_gid=dnxxnK_q5etfB3UQyzX8Iw&edm=APs17CUBAAAA&ccb=7-5&oh=00_AQHw5RvmhjjR-SuG9G4A2TAEqLC--aw4b82Qpisc40c4cQ&oe=6A73766F&_nc_sid=10d13b"
},
"3": {
"position": 4,
"id": "23678829",
"username": "nikefootball",
"full_name": "Nike Football",
"is_verified": true,
"profile_pic_url": "https://instagram.fsac1-2.fna.fbcdn.net/v/t51.82787-19/703222723_18606776074062830_6301137681281101191_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDAwLmMyIn0&_nc_ht=instagram.fsac1-2.fna.fbcdn.net&_nc_cat=1&_nc_oc=Q6cZ2gHjBIKaUr_9pd3nINydiFqJv22UgdcCa3XxRGEca4DXxkhcYCq04Xd2WhO2e7Jiu2k&_nc_ohc=vc6P1ivnXskQ7kNvwHL5V8x&_nc_gid=dnxxnK_q5etfB3UQyzX8Iw&edm=APs17CUBAAAA&ccb=7-5&oh=00_AQEP-J486Ttu1TGg2Pfs_pi-AFg-jpGz-AKRLah8VWrWgg&oe=6A7392BE&_nc_sid=10d13b"
}
},
"hashtags": {
"0": {
"position": 2,
"id": "17841562978125529",
"name": "nikewomen",
"media_count": 2036708,
"search_result_subtitle": null
},
"1": {
"position": 11,
"id": "17841563764097648",
"name": "nikeairmax",
"media_count": 4906405,
"search_result_subtitle": null
}
},
"places": {
"0": {
"position": 53,
"id": "715603272",
"name": "Nike",
"title": "Nike",
"subtitle": "",
"facebook_places_id": "106068296090172"
}
},
"keywords": {},
"rank_token": "933815c3-4008-42a9-8675-27f667382741"
},
"credits_used": 1,
"endpoint": "instagram/search"
}{
"error": "query is required for Instagram search"
}{
"error": "Invalid API key",
"docs": "https://docs.sociavault.com/authentication"
}{
"error": "Insufficient credits",
"required": 123,
"available": 123
}💳 1 credit per request
Authorizations
Query Parameters
The username, hashtag, place, or keyword to search for
Example:
"nike"
Response
Successful response
Key Response Fields:
data.users: Matched accounts, keyed by index (0, 1, 2, ...)data.users[0].username: Account usernamedata.users[0].full_name: Account display namedata.users[0].id: Numeric user IDdata.users[0].is_verified: Whether the account is verifieddata.users[0].profile_pic_url: Profile picture URLdata.hashtags: Matched hashtags, keyed by indexdata.hashtags[0].name: Hashtag name (without #)data.hashtags[0].media_count: Number of posts using the hashtagdata.places: Matched places, keyed by index (name, title,facebook_places_id)data.keywords: Suggested keyword entities (when present)data.rank_token: Token identifying this search ranking
⌘I