Crawlzodocs
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 not public on Instagram, so they are not returned.

POST
/v1/scrapers/instagram-search-hashtag-v4

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  }}