curl --request POST \
--url https://app.sideshift.app/api/v1/scrape/instagram/hashtag-search \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"hashtag": "sunset"
}
'import requests
url = "https://app.sideshift.app/api/v1/scrape/instagram/hashtag-search"
payload = { "hashtag": "sunset" }
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({hashtag: 'sunset'})
};
fetch('https://app.sideshift.app/api/v1/scrape/instagram/hashtag-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/hashtag-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([
'hashtag' => 'sunset'
]),
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/hashtag-search"
payload := strings.NewReader("{\n \"hashtag\": \"sunset\"\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/hashtag-search")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"hashtag\": \"sunset\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.sideshift.app/api/v1/scrape/instagram/hashtag-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 \"hashtag\": \"sunset\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"cursor": "2",
"hashtag": "sunset",
"media_type": "all",
"has_more": true,
"success": true,
"posts": [
{
"caption": "Admiring a beautiful sunset is what we all do right?\n.\n.\n.\n.\n.\n#reels #fyp #relatable #thenightwemet #sunset",
"id": "3951747646594785336",
"shortcode": "DbXbYwdRKA4",
"url": "https://www.instagram.com/reel/DbXbYwdRKA4/",
"video_url": "https://instagram.fmqy1-1.fna.fbcdn.net/o1/v/t16/f2/m84/AQM1vuQbgtzVV4O7DZWsc5ehg8qF9m_F0lZdD5WeY6Lw2xlB3uT91ZRx9nEERCnn4qA2Y3GXcD3mQ897jKeMhTKq0JDFFPcmsq7pgrA.mp4",
"comment_count": 1,
"like_count": 27,
"taken_at": 1785305105,
"video_play_count": 247,
"video_view_count": 68,
"owner": {
"full_name": "Varun📸",
"id": "19080253599",
"username": "throughvarun",
"profile_pic_url": "https://instagram.fmqy1-1.fna.fbcdn.net/v/t51.82787-19/731614958_18127475488637600_8255037588937436294_n.jpg",
"blocked_by_viewer": false,
"followed_by_viewer": false,
"has_blocked_viewer": false,
"is_embeds_disabled": false,
"is_private": false,
"is_unpublished": false,
"is_verified": false,
"pass_tiering_recommendation": true,
"requested_by_viewer": false,
"edge_followed_by": {
"count": 265
}
},
"__typename": "XDTGraphVideo",
"display_url": "https://instagram.fmqy1-1.fna.fbcdn.net/v/t15.5256-10/757128185_1800446577795580_8709505534581724995_n.jpg",
"product_type": "clips",
"thumbnail_src": "https://instagram.fmqy1-1.fna.fbcdn.net/v/t15.5256-10/757128185_1800446577795580_8709505534581724995_n.jpg",
"comments_disabled": false,
"has_audio": true,
"is_ad": false,
"is_affiliate": false,
"is_paid_partnership": false,
"is_video": true,
"like_and_view_counts_disabled": false,
"video_duration": 11.655,
"clips_music_attribution_info": {
"artist_name": "Lord Huron",
"audio_id": "495072987594427",
"song_name": "The Night We Met",
"should_mute_audio": false,
"uses_original_audio": false
}
}
]
},
"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"
}Public posts carrying an exact hashtag. Platform field names are preserved inside data.
curl --request POST \
--url https://app.sideshift.app/api/v1/scrape/instagram/hashtag-search \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"hashtag": "sunset"
}
'import requests
url = "https://app.sideshift.app/api/v1/scrape/instagram/hashtag-search"
payload = { "hashtag": "sunset" }
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({hashtag: 'sunset'})
};
fetch('https://app.sideshift.app/api/v1/scrape/instagram/hashtag-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/hashtag-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([
'hashtag' => 'sunset'
]),
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/hashtag-search"
payload := strings.NewReader("{\n \"hashtag\": \"sunset\"\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/hashtag-search")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"hashtag\": \"sunset\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.sideshift.app/api/v1/scrape/instagram/hashtag-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 \"hashtag\": \"sunset\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"cursor": "2",
"hashtag": "sunset",
"media_type": "all",
"has_more": true,
"success": true,
"posts": [
{
"caption": "Admiring a beautiful sunset is what we all do right?\n.\n.\n.\n.\n.\n#reels #fyp #relatable #thenightwemet #sunset",
"id": "3951747646594785336",
"shortcode": "DbXbYwdRKA4",
"url": "https://www.instagram.com/reel/DbXbYwdRKA4/",
"video_url": "https://instagram.fmqy1-1.fna.fbcdn.net/o1/v/t16/f2/m84/AQM1vuQbgtzVV4O7DZWsc5ehg8qF9m_F0lZdD5WeY6Lw2xlB3uT91ZRx9nEERCnn4qA2Y3GXcD3mQ897jKeMhTKq0JDFFPcmsq7pgrA.mp4",
"comment_count": 1,
"like_count": 27,
"taken_at": 1785305105,
"video_play_count": 247,
"video_view_count": 68,
"owner": {
"full_name": "Varun📸",
"id": "19080253599",
"username": "throughvarun",
"profile_pic_url": "https://instagram.fmqy1-1.fna.fbcdn.net/v/t51.82787-19/731614958_18127475488637600_8255037588937436294_n.jpg",
"blocked_by_viewer": false,
"followed_by_viewer": false,
"has_blocked_viewer": false,
"is_embeds_disabled": false,
"is_private": false,
"is_unpublished": false,
"is_verified": false,
"pass_tiering_recommendation": true,
"requested_by_viewer": false,
"edge_followed_by": {
"count": 265
}
},
"__typename": "XDTGraphVideo",
"display_url": "https://instagram.fmqy1-1.fna.fbcdn.net/v/t15.5256-10/757128185_1800446577795580_8709505534581724995_n.jpg",
"product_type": "clips",
"thumbnail_src": "https://instagram.fmqy1-1.fna.fbcdn.net/v/t15.5256-10/757128185_1800446577795580_8709505534581724995_n.jpg",
"comments_disabled": false,
"has_audio": true,
"is_ad": false,
"is_affiliate": false,
"is_paid_partnership": false,
"is_video": true,
"like_and_view_counts_disabled": false,
"video_duration": 11.655,
"clips_music_attribution_info": {
"artist_name": "Lord Huron",
"audio_id": "495072987594427",
"song_name": "The Night We Met",
"should_mute_audio": false,
"uses_original_audio": false
}
}
]
},
"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
Topic tag with or without #.
Recency window.
last-hour, last-day, last-week, last-month, last-year Media filter.
all, reels Page-number token, capped at page 10 (up to page 40 on accounts with deep-page access).
32768^[1-9][0-9]*$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.
1 Per-request credit accounting (also surfaced in the X-Scraper-Credits-* response headers).
Show child attributes
Show child attributes