API referenceInstagram
Instagram search hashtag
Public posts (or reels only) carrying an exact hashtag.
Instagram publishes a post's view count only for video. Photo and carousel posts return null rather than zero, because zero would be a claim we cannot support.
Share and save counts are visible only to the account that owns a post. No public surface carries them, so we never populate them.
The example response below is real output from this endpoint, not an illustration. Long lists and long strings are shortened to keep the page readable, and each place that happens is marked. This example took 29.8s.
Authorization
ApiKeyAuth X-API-Key<token>
Your API key. Sent on every request.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/scrapers/instagram-search-hashtag-v4" \ -H "Content-Type: application/json" \ -d '{ "hashtag": "sunset" }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "cursor": "2", "has_more": true, "hashtag": "sunset", "media_type": "all", "posts": [ { "__typename": "GraphVideo", "accessibility_caption": "Video by ✨ on August 10, 2026. May be an image of cloud, horizon, twilight, telephone pole and text that says 'metimes,youJustneedtos standwiththeviewandbrea withtheviewandbreathe and adbreathe with theview'.", "caption": "☀️\n\n#trendingreels #skyphotography #sunset", "clips_music_attribution_info": null, "coauthor_producers": [], "comment_count": 2, "comments": [], "comments_disabled": null, "dimensions": { "height": 1920, "width": 1080 }, "display_url": "https://scontent-dfw6-2.cdninstagram.com/v/t51.71878-15/772021539_1332383558885752_4697286493619638493_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=108&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=rEzaHS-nbasQ7kNvwEqb4Js&_nc_oc=Adq2Wn2EjBc3cHSBvxE1Ev5_Z8P1-P1yJZcvgs-ArMs… (+183 chars)", "has_audio": true, "id": "3960765334721015507", "is_ad": null, "is_affiliate": null, "is_paid_partnership": null, "is_video": true, "like_and_view_counts_disabled": false, "like_count": 111, "location": null, "owner": { "__typename": "User", "full_name": "✨", "id": "16342201074", "ig_id": "17841416352222775", "is_private": false, "is_unpublished": false, "is_verified": false, "pk": "16342201074", "polaris_ordered_timeline_connection": { "edges": [ { "node": { "__isXIGPolarisMedia": "XIGPolarisVideoMedia", "__typename": "XIGPolarisVideoMedia", "accessibility_caption": "Video by ✨ on May 07, 2026.", "caption": { "text": "শুধু তোমাকে ভালোবেসে!🥺" }, "code": "DYC3PC6OS_r", "display_uri": "https://scontent-dfw5-1.cdninstagram.com/v/t51.71878-15/685321024_2464606974045140_1250146709566279183_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=106&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=LQkoE_XeOdAQ7kNvwHYkUh4&_nc_oc=Adqp7w8UHLwt4A9cUXayEVwyIhlI5YRkpPyrl1vY1-K… (+183 chars)", "id": "POLARIS_3891915954476101611", "media_type": 2, "pk": "3891915954476101611", "product_type": "clips", "seo_canonical_url": null, "user": { "id": "17841416352222775", "pk": "16342201074", "username": "_nature_holic10" } } }, { "node": { "__isXIGPolarisMedia": "XIGPolarisVideoMedia", "__typename": "XIGPolarisVideoMedia", "accessibility_caption": "Video by ✨ on August 20, 2026. May be an image of Adenium, rose and text.", "caption": { "text": "🌸\n\n#explorepage #trendingreels #viral #flowers" }, "code": "DcROklCOaUk", "display_uri": "https://scontent-dfw6-2.cdninstagram.com/v/t51.71878-15/779084741_1388858429695336_275031638087279632_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=108&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=tdO9IO9vi7sQ7kNvwG_-g3s&_nc_oc=AdroI0G4636XoApJuco4yEZSekB-m-HbytNxf6T70xfY… (+182 chars)", "id": "POLARIS_3968016833008215332", "media_type": 2, "pk": "3968016833008215332", "product_type": "clips", "seo_canonical_url": null, "user": { "id": "17841416352222775", "pk": "16342201074", "username": "_nature_holic10" } } }, "… 10 more items in the full response" ] }, "profile_image_uri": "https://scontent-dfw5-1.cdninstagram.com/v/t51.82787-19/684587714_18125040631545075_640655219800007984_n.jpg?stp=cp0_dst-jpg_s34x34_tt6&_nc_cat=106&ccb=7-5&_nc_sid=bf7eb4&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=PBjTiMiijWMQ7kNvwGqw_Ff&_nc_oc=AdrWAtGKFxmmUu0ff7niNVRJ2QS9pKilkT79PDyWu0bzup8… (+179 chars)", "profile_pic_url": "https://scontent-dfw5-1.cdninstagram.com/v/t51.82787-19/684587714_18125040631545075_640655219800007984_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=106&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=PBjTiMiijWMQ7kNvwGqw_Ff&_nc_oc=AdrWAtGKFxmmUu0ff7niNVRJ2QS9pKilkT79PDyWu0bzup8K1… (+177 chars)", "username": "_nature_holic10" }, "product_type": "clips", "shortcode": "Db3dxY-ui7T", "tagged_users": [], "taken_at": 1786380068, "thumbnail_src": "https://scontent-dfw6-2.cdninstagram.com/v/t51.71878-15/772021539_1332383558885752_4697286493619638493_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=108&ig_cache_key=Mzk2MDc2NTMzNDcyMTAxNTUwNw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjY0MC5zZHIudmlkZW9fZGVmYXVsdF9jb3Zlcl9mcmFtZS5DMyJ9&_nc_ohc=… (+257 chars)", "url": "https://www.instagram.com/reel/Db3dxY-ui7T/", "video_duration": 12.1, "video_play_count": null, "video_url": "https://scontent-dfw6-1.cdninstagram.com/o1/v/t2/f2/m86/AQNkpT4UmS8qNX-P7N_ZPT6iON2eXFZm1RMiWFjx2GkO2ApmL8x9QY64eS9iI2hTMoXzh5aYet1-3LsbpFD6gVOkPftE9L6U8lOokdY.mp4?_nc_cat=101&_nc_sid=5e9851&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_ohc=OLeFg5C5IhoQ7kNvwE25ra2&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQ… (+738 chars)", "video_view_count": null }, { "__typename": "GraphVideo", "accessibility_caption": "Video by liz_6 on June 07, 2026. May be an image of temple, crowd, twilight and outdoors.", "caption": "sunset>everything✨\n#sunset #fyp", "clips_music_attribution_info": null, "coauthor_producers": [], "comment_count": 1060, "comments": [], "comments_disabled": null, "dimensions": { "height": 1920, "width": 1080 }, "display_url": "https://scontent-den2-1.cdninstagram.com/v/t51.71878-15/718980863_2286797025189739_3169560600325628181_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=102&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=N2VpmZHpuvIQ7kNvwGaoLlg&_nc_oc=Adq306e6038jQSLmdPeJgYu0sLaKYIplVMeCFfK6k5n… (+183 chars)", "has_audio": true, "id": "3914403367974746013", "is_ad": null, "is_affiliate": null, "is_paid_partnership": null, "is_video": true, "like_and_view_counts_disabled": false, "like_count": 355915, "location": null, "owner": { "__typename": "User", "full_name": "liz_6", "id": "60246466876", "ig_id": "17841460326280808", "is_private": false, "is_unpublished": false, "is_verified": false, "pk": "60246466876", "polaris_ordered_timeline_connection": { "edges": [ { "node": { "__isXIGPolarisMedia": "XIGPolarisVideoMedia", "__typename": "XIGPolarisVideoMedia", "accessibility_caption": "Video by liz_6 on August 22, 2026. May be an image of arctic and text.", "caption": { "text": "Let the sunset heal your day✨\n#sunset #fyp" }, "code": "DcWIlkEOFBh", "display_uri": "https://scontent-den2-1.cdninstagram.com/v/t51.82787-15/777299029_17991485577010877_8488362157638935985_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=100&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=1oEnBTk6xPcQ7kNvwH7s0Vg&_nc_oc=AdpfTngeDJVZwJIfm_53UZ1rn8Y4ShEdG6lnMnj49r… (+184 chars)", "id": "POLARIS_3969397887291904097", "media_type": 2, "pk": "3969397887291904097", "product_type": "clips", "seo_canonical_url": null, "user": { "id": "17841460326280808", "pk": "60246466876", "username": "jiangzhibin24" } } }, { "node": { "__isXIGPolarisMedia": "XIGPolarisVideoMedia", "__typename": "XIGPolarisVideoMedia", "accessibility_caption": "Video by liz_6 on August 16, 2026. May be an image of nature, horizon, twilight, road, palm trees and text.", "caption": { "text": "The sunset is so beautiful, you are so beautiful✨\n#sunset #fyp" }, "code": "DcGfky5OHWg", "display_uri": "https://scontent-den2-1.cdninstagram.com/v/t51.82787-15/775727208_17990601729010877_7221118950930799270_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=101&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=9rgGz53Ok1cQ7kNvwEbu0Qc&_nc_oc=AdpvKDoz4DwQttZIOQYZz9s7vk0gJBEKdEDTFXMh5G… (+184 chars)", "id": "POLARIS_3964995389936399776", "media_type": 2, "pk": "3964995389936399776", "product_type": "clips", "seo_canonical_url": null, "user": { "id": "17841460326280808", "pk": "60246466876", "username": "jiangzhibin24" } } }, "… 10 more items in the full response" ] }, "profile_image_uri": "https://scontent-den2-1.cdninstagram.com/v/t51.2885-19/351773047_584104953851422_5238682599566786808_n.jpg?stp=cp0_dst-jpg_s34x34_tt6&_nc_cat=100&ccb=7-5&_nc_sid=bf7eb4&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=dZA8GJxxRAEQ7kNvwGKqsIH&_nc_oc=Adqs5A_-kLXGgl88Qy6S3Vncqir5raQtnm06rCOYsv5s29fyA… (+146 chars)", "profile_pic_url": "https://scontent-den2-1.cdninstagram.com/v/t51.2885-19/351773047_584104953851422_5238682599566786808_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=100&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=dZA8GJxxRAEQ7kNvwGKqsIH&_nc_oc=Adqs5A_-kLXGgl88Qy6S3Vncqir5raQtnm06rCOYsv5s29fyAf-… (+144 chars)", "username": "jiangzhibin24" }, "product_type": "clips", "shortcode": "DZSwR-vujed", "tagged_users": [], "taken_at": 1780853394, "thumbnail_src": "https://scontent-den2-1.cdninstagram.com/v/t51.71878-15/718980863_2286797025189739_3169560600325628181_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=102&ig_cache_key=MzkxNDQwMzM2Nzk3NDc0NjAxMzE0OTI4NDA4MTU5MDgzNzI%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjY0MC5zZHIudmlkZW9fbmZyYW1lX2NvdmVyX2ZyYW1… (+277 chars)", "url": "https://www.instagram.com/reel/DZSwR-vujed/", "video_duration": 7.034195, "video_play_count": null, "video_url": "https://scontent-den2-1.cdninstagram.com/o1/v/t2/f2/m86/AQOJuUoQvU584-ggGIXBNyGE4GuIyLVPftpzUdv9P1ctWTwFbbTGX1rTxu0RHYOC3xuqenaHgsfBDNhNjN1-SCrSYJZCXYtxV9H2WWw.mp4?_nc_cat=100&_nc_sid=5e9851&_nc_ht=scontent-den2-1.cdninstagram.com&_nc_ohc=OWNSFdJj8O4Q7kNvwFO2rfk&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQ… (+730 chars)", "video_view_count": null }, "… 8 more items in the full response" ], "success": true }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "instagram-search-hashtag-v4", "billable": true, "duration_ms": 28694 }}