Instagram — profile search
curl --request POST \
--url https://app.sideshift.app/api/v1/scrape/instagram/profile-search \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"query": "travel blogger"
}
'import requests
url = "https://app.sideshift.app/api/v1/scrape/instagram/profile-search"
payload = { "query": "travel blogger" }
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({query: 'travel blogger'})
};
fetch('https://app.sideshift.app/api/v1/scrape/instagram/profile-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://app.sideshift.app/api/v1/scrape/instagram/profile-search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'query' => 'travel blogger'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.sideshift.app/api/v1/scrape/instagram/profile-search"
payload := strings.NewReader("{\n \"query\": \"travel blogger\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.sideshift.app/api/v1/scrape/instagram/profile-search")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"travel blogger\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.sideshift.app/api/v1/scrape/instagram/profile-search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"query\": \"travel blogger\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"cursor": "2",
"query": "travel blogger",
"has_more": true,
"success": true,
"profiles": [
{
"full_name": "Charu Goyal | Travel Blogger",
"id": "3037325678",
"url": "https://www.instagram.com/travelwithcg/",
"username": "travelwithcg",
"biography": "📍Luxury travel blogger & photographer\n🌍 Sharing beautiful places & hotels\n📸 Photoshoots in Jaipur @jaipurphototour\n📧 [email redacted]\n⤵️ Blog",
"category_name": "Blogger",
"external_url": "https://travelwithcg.com/instagram-links/",
"google_description": "43K Followers, 611 Following, 868 Posts - Charu Goyal | Travel Blogger (@travelwithcg) on Instagram: \"📍Luxury travel blogger & photographer 🌍 Sharing beautiful places & hotels 📸 Photoshoots in Jaipur @jaipurphototour 📧 [email redacted] ⤵️ Blog\"",
"google_title": "Charu Goyal | Travel Blogger (@travelwithcg) - Instagram",
"matched_from": "profile",
"profile_pic_url": "https://scontent-ord5-1.cdninstagram.com/v/t51.2885-19/455699681_498640002858990_5559399076549613325_n.jpg",
"enriched": true,
"follower_count": 43075,
"following_count": 605,
"is_business_account": false,
"is_private": false,
"is_professional_account": true,
"is_verified": true,
"media_count": 868,
"bio_links": [
{
"title": "Shop my outfits👗",
"url": "https://www.nykaafashion.com/nap/charu-goyal-fashion-store/c/70630",
"link_type": "external",
"lynx_url": "https://l.instagram.com/"
}
]
}
]
},
"request_id": "req_8f3c9a2b1d4e6f70",
"upstream_calls": 1,
"meta": {
"credits_charged": 1,
"credits_remaining": 9998
}
}{
"error": "INVALID_INPUT",
"message": "Invalid request body.",
"request_id": "req_8f3c9a2b1d4e6f70"
}{
"error": "UNAUTHORIZED",
"message": "Invalid scraper API key.",
"request_id": "req_8f3c9a2b1d4e6f70"
}{
"error": "INSUFFICIENT_SCRAPER_CREDITS",
"message": "Insufficient scraper credits.",
"request_id": "req_8f3c9a2b1d4e6f70"
}{
"error": "RESOURCE_NOT_FOUND",
"message": "Requested resource not found or unavailable.",
"request_id": "req_8f3c9a2b1d4e6f70"
}{
"error": "PAYLOAD_TOO_LARGE",
"message": "Request body must be 32KB or smaller.",
"request_id": "req_8f3c9a2b1d4e6f70"
}{
"error": "SCRAPER_RATE_LIMITED",
"message": "Scraper API rate limit exceeded.",
"request_id": "req_8f3c9a2b1d4e6f70"
}{
"error": "INTERNAL_ERROR",
"message": "Request failed. Your credits were refunded.",
"request_id": "req_8f3c9a2b1d4e6f70"
}{
"error": "UPSTREAM_ERROR",
"message": "Data source failed. Your credits were refunded.",
"request_id": "req_8f3c9a2b1d4e6f70"
}{
"error": "UPSTREAM_TIMEOUT",
"message": "Data source timed out. Your credits were refunded.",
"request_id": "req_8f3c9a2b1d4e6f70"
}1 credit per request
Creator discovery from bio and caption keywords. Platform field names are preserved inside data.
POST
/
scrape
/
instagram
/
profile-search
Instagram — profile search
curl --request POST \
--url https://app.sideshift.app/api/v1/scrape/instagram/profile-search \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"query": "travel blogger"
}
'import requests
url = "https://app.sideshift.app/api/v1/scrape/instagram/profile-search"
payload = { "query": "travel blogger" }
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({query: 'travel blogger'})
};
fetch('https://app.sideshift.app/api/v1/scrape/instagram/profile-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://app.sideshift.app/api/v1/scrape/instagram/profile-search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'query' => 'travel blogger'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.sideshift.app/api/v1/scrape/instagram/profile-search"
payload := strings.NewReader("{\n \"query\": \"travel blogger\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.sideshift.app/api/v1/scrape/instagram/profile-search")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"travel blogger\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.sideshift.app/api/v1/scrape/instagram/profile-search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"query\": \"travel blogger\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"cursor": "2",
"query": "travel blogger",
"has_more": true,
"success": true,
"profiles": [
{
"full_name": "Charu Goyal | Travel Blogger",
"id": "3037325678",
"url": "https://www.instagram.com/travelwithcg/",
"username": "travelwithcg",
"biography": "📍Luxury travel blogger & photographer\n🌍 Sharing beautiful places & hotels\n📸 Photoshoots in Jaipur @jaipurphototour\n📧 [email redacted]\n⤵️ Blog",
"category_name": "Blogger",
"external_url": "https://travelwithcg.com/instagram-links/",
"google_description": "43K Followers, 611 Following, 868 Posts - Charu Goyal | Travel Blogger (@travelwithcg) on Instagram: \"📍Luxury travel blogger & photographer 🌍 Sharing beautiful places & hotels 📸 Photoshoots in Jaipur @jaipurphototour 📧 [email redacted] ⤵️ Blog\"",
"google_title": "Charu Goyal | Travel Blogger (@travelwithcg) - Instagram",
"matched_from": "profile",
"profile_pic_url": "https://scontent-ord5-1.cdninstagram.com/v/t51.2885-19/455699681_498640002858990_5559399076549613325_n.jpg",
"enriched": true,
"follower_count": 43075,
"following_count": 605,
"is_business_account": false,
"is_private": false,
"is_professional_account": true,
"is_verified": true,
"media_count": 868,
"bio_links": [
{
"title": "Shop my outfits👗",
"url": "https://www.nykaafashion.com/nap/charu-goyal-fashion-store/c/70630",
"link_type": "external",
"lynx_url": "https://l.instagram.com/"
}
]
}
]
},
"request_id": "req_8f3c9a2b1d4e6f70",
"upstream_calls": 1,
"meta": {
"credits_charged": 1,
"credits_remaining": 9998
}
}{
"error": "INVALID_INPUT",
"message": "Invalid request body.",
"request_id": "req_8f3c9a2b1d4e6f70"
}{
"error": "UNAUTHORIZED",
"message": "Invalid scraper API key.",
"request_id": "req_8f3c9a2b1d4e6f70"
}{
"error": "INSUFFICIENT_SCRAPER_CREDITS",
"message": "Insufficient scraper credits.",
"request_id": "req_8f3c9a2b1d4e6f70"
}{
"error": "RESOURCE_NOT_FOUND",
"message": "Requested resource not found or unavailable.",
"request_id": "req_8f3c9a2b1d4e6f70"
}{
"error": "PAYLOAD_TOO_LARGE",
"message": "Request body must be 32KB or smaller.",
"request_id": "req_8f3c9a2b1d4e6f70"
}{
"error": "SCRAPER_RATE_LIMITED",
"message": "Scraper API rate limit exceeded.",
"request_id": "req_8f3c9a2b1d4e6f70"
}{
"error": "INTERNAL_ERROR",
"message": "Request failed. Your credits were refunded.",
"request_id": "req_8f3c9a2b1d4e6f70"
}{
"error": "UPSTREAM_ERROR",
"message": "Data source failed. Your credits were refunded.",
"request_id": "req_8f3c9a2b1d4e6f70"
}{
"error": "UPSTREAM_TIMEOUT",
"message": "Data source timed out. Your credits were refunded.",
"request_id": "req_8f3c9a2b1d4e6f70"
}Authorizations
Independent Scraper API key (scrape_live_*). Generate one in the Scraper dashboard.
Body
application/json
Response
Completed lookup. Standard cost: 1 SideShift credit; account-specific pricing, when present, is shown in the Scraper dashboard and returned in the billing headers.
Instagram platform data payload. Field names and nesting are preserved.
Show child attributes
Show child attributes
SideShift request id. Include it in support requests.
Number of data-source lookups performed.
Available options:
1 Per-request credit accounting (also surfaced in the X-Scraper-Credits-* response headers).
Show child attributes
Show child attributes