Hashtag Search
GET/v1/instagram/search/hashtag1 credit
Finds public posts and reels that use a hashtag, each returned with its full post details.
01Query parameters
| Name | Type | Description |
|---|---|---|
| hashtagrequired | string | Hashtag to search, with or without the leading `#`. |
| date_postedoptional | string | Only posts from this period. No filter by default.Accepted values:last-hourlast-daylast-weeklast-monthlast-year |
| media_typeoptional | string | `reels` returns only reels; `all` returns every post type.Default: allAccepted values:allreels |
| cursoroptional | integer | Page number to fetch, from the `cursor` of the previous answer (1 to 11).Default: 1 |
02Request
curl "https://api.scrapesocial.ai/v1/instagram/search/hashtag?hashtag=nature" \ -H "x-api-key: $SCRAPESOCIAL_KEY"
03Responses
Real answers from the API. Lists are shortened to 2 items.
GET /v1/instagram/search/hashtag?hashtag=nature
{
"success": true,
"credits_remaining": 4980,
"credits_charged": 1,
"hashtag": "nature",
"media_type": "all",
"posts": [
{
"id": "4007802920743738311",
"__typename": "XDTGraphVideo",
"shortcode": "Deek4WstBvH",
"url": "https://www.instagram.com/reel/Deek4WstBvH/",
"caption": "nature and entertainment 🌲\n\n#nature\n#survivor",
"thumbnail_src": "https://instagram.fank1-1.fna.fbcdn.net/v/t51.82787-15/848271034_18340813375257027_4921309403439689980_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=106&_nc_map=urlgen_bucketless&ig_cache_key=NDAwNzgwMjkyMDc0MzczODMxMTE4MzQwODEzMzcyMjU3MDI3.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjcyMC5zZHIudmlkZW9fZGVmYXVsdF9jb3Zlcl9mcmFtZS5DMyJ9&_nc_ohc=BzBFG0uyJPQQ7kNvwEFRLy-&_nc_oc=AdrOpGQ…",
"display_url": "https://instagram.fank1-1.fna.fbcdn.net/v/t51.82787-15/848271034_18340813375257027_4921309403439689980_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=106&_nc_map=urlgen_bucketless&ig_cache_key=NDAwNzgwMjkyMDc0MzczODMxMTE4MzQwODEzMzcyMjU3MDI3.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjcyMC5zZHIudmlkZW9fZGVmYXVsdF9jb3Zlcl9mcmFtZS5DMyJ9&_nc_ohc=BzBFG0uyJPQQ7kNvwEFRLy-&_nc_oc=AdrOpGQ…",
"video_url": "https://instagram.fank1-1.fna.fbcdn.net/o1/v/t2/f2/m86/AQP7M6aLOO6xC4MJgS4QLDGJB1PQqyLDO48x-4XzkPqjJ5Ezow3fne4KRqwDrO_vx8WnW0oKfs-EAYT5DA0PXXOJs416NuyZN691n3o.mp4?_nc_cat=109&_nc_oc=AdpViaqtY-qxwEzu2pnLJ6Y58U483viwpICivsClrpnTvngM2JsdbsLQwYSyOf3bMpw&_nc_sid=5e9851&_nc_ht=instagram.fank1-1.fna.fbcdn.net&_nc_ohc=b6uSU66TSq8Q7kNvwHiurem&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJ…",
"has_audio": true,
"video_view_count": 38441,
"product_type": "clips",
"video_duration": 32.133,
"clips_music_attribution_info": {
"artist_name": "sercanyildirim9official",
"song_name": "Original audio",
"uses_original_audio": true,
"should_mute_audio": false,
"should_mute_audio_reason": "",
"audio_id": "28628724210117226"
},
"is_video": true,
"owner": {
"id": "7914681026",
"username": "sercanyildirim9official",
"is_verified": true,
"profile_pic_url": "https://scontent.cdninstagram.com/v/t51.82787-19/825277231_18338602807257027_467039815259747833_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=110&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=qlv4NhhgyBEQ7kNvwEJsT7m&_nc_oc=Adq6Uq-VqbPgRyk9VJUG49kI0nDZr94P3QX__hhGG-lKb7W-Mjbkmgi5loDBulrcCpo&_nc_zt=24&_nc_ht=scontent.cdninstagram.com&_nc_gid=CLkfvUDcneKC1_ahg…",
"full_name": "Sercan Yıldırım"
},
"taken_at": "2026-10-14T14:18:11.000Z",
"is_ad": false,
"like_count": 1108,
"is_paid_partnership": false,
"location": {
"__typename": "XDTLocationDict",
"pk": 434139129999014,
"lat": 40.070411663239,
"lng": 29.221991300583,
"name": "Uludağ",
"profile_pic_url": null
},
"comment_count": 39,
"comments": [
{
"id": "17964729399219319",
"text": "Kolay gelsin sana hemşerim🫡🫡",
"owner": {
"id": "68542810402",
"username": "deniz_grgn16",
"is_verified": false,
"profile_pic_url": "https://scontent.cdninstagram.com/v/t51.82787-19/753007326_17938633965282403_7813151934714218118_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=107&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=fC0Q_64bKTEQ7kNvwGm1mRd&_nc_oc=Adqvb4dJeiMkoryCQcX79wbBIrMZKIyi_wRDvveCG4F4rWL5f6lqtNVrNDHq9J0sLYo&_nc_zt=24&_nc_ht=scontent.cdninstagram.com&_nc_gid=CLkfvUDcneKC1_ah…",
"full_name": ""
},
"like_count": 0,
"created_at": "2026-10-25T10:04:55.000Z"
},
{
"id": "17889554583469262",
"text": "Bence tek yaşanacak yaşanması gereken yerler hayat buralar işte 🙂↕️🙂↕️ @sercanyildirim9official",
"owner": {
"id": "1395340064",
"username": "rimaseray_krl",
"is_verified": false,
"profile_pic_url": "https://scontent.cdninstagram.com/v/t51.82787-19/859762504_18639084544012065_8069698525609123626_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=103&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=3QniAj0mcloQ7kNvwEDO5xM&_nc_oc=AdqXqFqGzovj3906cNYbD7FnayL3o5203LSoY-oU8dpWSnZee_3aO27_LOT06rdyCt4&_nc_zt=24&_nc_ht=scontent.cdninstagram.com&_nc_gid=CLkfvUDcneKC1_ah…",
"full_name": ""
},
"like_count": 0,
"created_at": "2026-10-18T21:30:07.000Z"
}
]
},
{
"id": "3854978376381803703",
"__typename": "XDTGraphImage",
"shortcode": "DV_omilDKy3",
"url": "https://www.instagram.com/p/DV_omilDKy3/",
"caption": "Cozy Cabin in the Maggia valley. \n.\n.\n#tessin #switzerland #mountains #nature",
"thumbnail_src": "https://instagram.fteq3-4.fna.fbcdn.net/v/t51.82787-15/654593049_18598924960016271_2774815443710587216_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=108&_nc_map=urlgen_bucketless&ig_cache_key=Mzg1NDk3ODM3NjM4MTgwMzcwMw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHMuMTQ0MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=ejeDgMG8I2gQ7kNvwFDZKWC&_nc_oc=AdoVbU54YbTl2F7i-7G20m02w0hsPiMItx2R6EN…",
"display_url": "https://instagram.fteq3-4.fna.fbcdn.net/v/t51.82787-15/654593049_18598924960016271_2774815443710587216_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=108&_nc_map=urlgen_bucketless&ig_cache_key=Mzg1NDk3ODM3NjM4MTgwMzcwMw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHMuMTQ0MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=ejeDgMG8I2gQ7kNvwFDZKWC&_nc_oc=AdoVbU54YbTl2F7i-7G20m02w0hsPiMItx2R6EN…",
"video_url": null,
"has_audio": false,
"product_type": "feed",
"video_duration": null,
"clips_music_attribution_info": null,
"is_video": false,
"owner": {
"id": "611984270",
"username": "ibdansch",
"is_verified": false,
"profile_pic_url": "https://scontent.cdninstagram.com/v/t51.82787-19/515519302_18537811117016271_7641717572660494634_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=110&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=_owVovs9UhoQ7kNvwFOkrRq&_nc_oc=AdprMEO8xkJ2OYH13wpLfk5yW9DKJ1S9zCwGgOzVejmV77SpKtSn3vUpGUyNntKkQCU&_nc_zt=24&_nc_ht=scontent.cdninstagram.com&_nc_gid=0FavnGCoFMffFa8N…",
"full_name": "Daniel Schumacher"
},
"taken_at": "2026-03-17T17:40:00.000Z",
"is_ad": false,
"like_count": 3,
"is_paid_partnership": false,
"location": {
"__typename": "XDTLocationDict",
"pk": 449437983,
"lat": 47.5580299,
"lng": 7.5874018,
"name": "Switzerland, Schweiz",
"profile_pic_url": null
},
"comment_count": 57,
"comments": [
{
"id": "18114943885735828",
"text": "Cozy it certainly is 🔥",
"owner": {
"id": "4455980927",
"username": "bram.codes",
"is_verified": false,
"profile_pic_url": "https://scontent.cdninstagram.com/v/t51.75761-19/503536397_18357319840148928_5123755521022443456_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=104&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=39cxWn-lYTsQ7kNvwESwrp9&_nc_oc=AdrH2fytoU0IQ2khWv2oeRp62allGfN3OhM75EBG5W3HTbD5jOoyeMeXrVAImRgEvFg&_nc_zt=24&_nc_ht=scontent.cdninstagram.com&_nc_gid=0FavnGCoFMffFa8N…",
"full_name": ""
},
"like_count": 0,
"created_at": "2026-03-28T13:56:06.000Z"
},
{
"id": "18084314798359904",
"text": "Klasse Location 🙌",
"owner": {
"id": "51631882449",
"username": "t.k._f_o_t_o",
"is_verified": false,
"profile_pic_url": "https://scontent.cdninstagram.com/v/t51.82787-19/708102259_18055973726722450_8628479411891608501_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=104&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=1rbg9iyAwloQ7kNvwGa2cQF&_nc_oc=Adrq-48yzOZ3OLfvS8-YKVHbXZcMOmbB3hHDo_L9HSwEVnNuljDRTeE-vbKR7cMQbKM&_nc_zt=24&_nc_ht=scontent.cdninstagram.com&_nc_gid=0FavnGCoFMffFa8N…",
"full_name": ""
},
"like_count": 0,
"created_at": "2026-03-19T20:04:35.000Z"
}
]
}
],
"cursor": "2"
}Common to every endpoint
Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.
GET /v1/cosmos/profile?handle=design
{
"success": false,
"message": "Invalid API key"
}04Notes
Up to 10 posts per page in `posts`. The next page number is in `cursor` (a string); send it back as `cursor`, up to page 11. On page 11 or on an empty page `cursor` is null. No match is an empty list for 0 credits. An invalid `date_posted`, `media_type` or `cursor` is a free 400. Web search engines also answer loosely related pages when nothing matches, so only results that name the hashtag (in their title, snippet or URL) are kept: a query nothing matches answers the empty list for 0 credits.
05Errors & credits
Every error has success: false, a real HTTP status and costs no credits.
400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.