API referenceInstagram
Instagram reels search
Keyword reel search.
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 25.1s.
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-reels-search-v4" \ -H "Content-Type: application/json" \ -d '{ "query": "coffee" }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "has_more": true, "page": 1, "query": "coffee", "reels": [ { "__typename": "GraphVideo", "accessibility_caption": "Video by Anto Anto 🇦🇺 on May 25, 2025.", "caption": "Have you visited?\nYes, Brisbane’s Coffee Anthology @coffeeanthology has been recognized as the 8th best coffee shop in the world in the inaugural World’s 100 Best Coffee Shops list, by @theworlds100bestcoffeeshops announced in February 2025. This prestigious ranking was determined through a combination of public votes … (+949 chars)", "clips_music_attribution_info": null, "coauthor_producers": [ { "__typename": "User", "full_name": "WHEREISBRISBANE?", "id": "17841407191940608", "is_unpublished": false, "is_verified": false, "pk": "7044871731", "profile_pic_url": "https://scontent-ord5-2.cdninstagram.com/v/t51.82787-19/651791955_18351898228239732_8974579780215313984_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=110&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy45MzguQzMifQ%3D%3D&_nc_ohc=dqgaIdLdyXcQ7kNvwHzjGxA&_nc_oc=AdqTBvp3lj5vbPNNTOrHxkSjh_O6Wcww1Nwr_Y9oI-Qxqm… (+201 chars)", "username": "whereisbrisbane" }, { "__typename": "User", "full_name": "The Whisk Fine Patisserie", "id": "17841402356225144", "is_unpublished": false, "is_verified": false, "pk": "2361158540", "profile_pic_url": "https://scontent-ord5-1.cdninstagram.com/v/t51.2885-19/12338589_191764204506272_39380613_a.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=108&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4yOTcuQzMifQ%3D%3D&_nc_ohc=FP6cxSXg3IsQ7kNvwEmrpm6&_nc_oc=AdqdcydHayk_SQJah4bR89WWTQhYDubAM-ixgza-k4scTSH16M7nvXRlRdw8z… (+155 chars)", "username": "thewhiskfinepatisserie" }, "… 3 more items in the full response" ], "comment_count": 151, "comments": [], "comments_disabled": null, "dimensions": { "height": 1920, "width": 1080 }, "display_url": "https://scontent-ord5-1.cdninstagram.com/v/t51.71878-15/501427069_2418464945192578_1412063892964502563_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=106&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=ArSCkJ6A3xgQ7kNvwHrqKgg&_nc_oc=AdpRWhOehHhrTEkSQXEQt-ueZDcMq-6M8fMM8Yenmup… (+204 chars)", "has_audio": true, "id": "3640785190693318812", "is_ad": null, "is_affiliate": null, "is_paid_partnership": null, "is_video": true, "like_and_view_counts_disabled": false, "like_count": 3496, "location": null, "owner": { "__typename": "User", "full_name": "Anto Anto 🇦🇺", "id": "43773793", "ig_id": "17841401853790683", "is_private": false, "is_unpublished": false, "is_verified": false, "pk": "43773793", "polaris_ordered_timeline_connection": { "edges": [ { "node": { "__isXIGPolarisMedia": "XIGPolarisVideoMedia", "__typename": "XIGPolarisVideoMedia", "accessibility_caption": "Video by Anto Anto 🇦🇺 on August 20, 2026. May be an image of pool, buildings and text.", "caption": { "text": "A little city escape at @westinbrisbane ✨\n\nThere’s something so nice about having a staycation without actually leaving Brisbane. We spent the night in a Club King Room and really enjoyed slowing down and making the most of everything the hotel has to offer.\n\nFrom afternoon drinks and canapés in the Club Lounge to rela… (+489 chars)" }, "code": "DcQVrVRp5ZY", "display_uri": "https://scontent-ord5-2.cdninstagram.com/v/t51.82787-15/782209340_18620373196061794_148692229929342259_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=104&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=ObZIVEvhTwsQ7kNvwEjcS85&_nc_oc=AdqzC73xWrXgZl3KqSqXLRfNUl9NPYRxmW3OecowYVw… (+204 chars)", "id": "POLARIS_3967766608472413784", "media_type": 2, "pk": "3967766608472413784", "product_type": "clips", "seo_canonical_url": null, "user": { "id": "17841401853790683", "pk": "43773793", "username": "anto_brisbane" } } }, { "node": { "__isXIGPolarisMedia": "XIGPolarisVideoMedia", "__typename": "XIGPolarisVideoMedia", "accessibility_caption": "Video by Anto Anto 🇦🇺 on August 13, 2026. May be an image of roller coaster, carousel and text that says 'EΚKA SKY FLYER FL WITHOUT TRENDING AUDIO'.", "caption": { "text": "POV: you’re seeing the @theekka from a completely different angle 🎡😳\n\nFinally tried the SkyFlyer at EKKA and wow… you really don’t realise how high it goes until you’re up there 😂\n\nA little scary at first, but once you’re flying around, the views over the EKKA and Brisbane are pretty incredible — especially as the sun … (+209 chars)" }, "code": "DcAkhKfsDEY", "display_uri": "https://scontent-ord5-2.cdninstagram.com/v/t51.71878-15/772964714_2859919801037903_6310634388151791567_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=102&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=XNYv9-pdX-4Q7kNvwEhBieX&_nc_oc=AdruAAyceUzOgojqvEwmB66RIfGL5zZcNObeMott7Wt… (+204 chars)", "id": "POLARIS_3963328280772227352", "media_type": 2, "pk": "3963328280772227352", "product_type": "clips", "seo_canonical_url": null, "user": { "id": "17841401853790683", "pk": "43773793", "username": "anto_brisbane" } } }, "… 10 more items in the full response" ] }, "profile_image_uri": "https://scontent-ord5-1.cdninstagram.com/v/t51.2885-19/372938211_973658837273620_2455713298449054706_n.jpg?stp=cp0_dst-jpg_s34x34_tt6&_nc_cat=108&ccb=7-5&_nc_sid=bf7eb4&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy43MjAuQzMifQ%3D%3D&_nc_ohc=I5VaVAY9ddkQ7kNvwGfBS5w&_nc_oc=AdqYjsEx0bzUAghqvAwYjxQ3S1SxlRiHqJVqenbDJj5iwzc… (+169 chars)", "profile_pic_url": "https://scontent-ord5-1.cdninstagram.com/v/t51.2885-19/372938211_973658837273620_2455713298449054706_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=108&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy43MjAuQzMifQ%3D%3D&_nc_ohc=I5VaVAY9ddkQ7kNvwGfBS5w&_nc_oc=AdqYjsEx0bzUAghqvAwYjxQ3S1SxlRiHqJVqenbDJj5iwzcGA… (+167 chars)", "username": "anto_brisbane" }, "product_type": "clips", "shortcode": "DKGqtdaxzCc", "tagged_users": [ { "full_name": "Coffee Anthology", "id": "496733676", "is_verified": false, "profile_pic_url": "https://scontent-ord5-1.cdninstagram.com/v/t51.2885-19/277853052_1768303486871957_8165341057909024900_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=106&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=_3APgluJUEQQ7kNvwHMHX6q&_nc_oc=AdqRusIFrTQ8mP0yCW0n8xhqqNQZ9B7eDWNpOEHkuwQSqI8BbG… (+166 chars)", "username": "coffeeanthology" }, { "full_name": "The Whisk Fine Patisserie", "id": "2361158540", "is_verified": false, "profile_pic_url": "https://scontent-ord5-1.cdninstagram.com/v/t51.2885-19/12338589_191764204506272_39380613_a.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=108&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4yOTcuQzMifQ%3D%3D&_nc_ohc=FP6cxSXg3IsQ7kNvwEmrpm6&_nc_oc=AdqdcydHayk_SQJah4bR89WWTQhYDubAM-ixgza-k4scTSH16M7nvXRlRdw8z… (+155 chars)", "username": "thewhiskfinepatisserie" }, "… 3 more items in the full response" ], "taken_at": 1748235868, "thumbnail_src": "https://scontent-ord5-1.cdninstagram.com/v/t51.71878-15/501427069_2418464945192578_1412063892964502563_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=106&ig_cache_key=MzY0MDc4NTE5MDY5MzMxODgxMjcxMjY5NTMwNDY0NzA5NA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjY0MC5zZHIudmlkZW9fbmZyYW1lX2NvdmVyX2ZyY… (+300 chars)", "url": "https://www.instagram.com/reel/DKGqtdaxzCc/", "video_duration": 15.48771, "video_play_count": null, "video_url": "https://scontent-ord5-2.cdninstagram.com/o1/v/t2/f2/m367/AQM4iKqcbnLHYuRNVzatnBDPDftwISjAnFjWFC0B7lh9Rzg2iF7LVIBks5CQVimIDXUg2moCspdYSgHpmSw0zZ_RUtd2c3NSsv9h1rU.mp4?_nc_cat=105&_nc_sid=5e9851&_nc_ht=scontent-ord5-2.cdninstagram.com&_nc_ohc=Ve1t55RIZx4Q7kNvwHmNQcJ&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdS… (+700 chars)", "video_view_count": null }, { "__typename": "GraphVideo", "accessibility_caption": "Video by Eric D'Alessandro on March 25, 2026.", "caption": "Home Goods & Iced Coffee", "clips_music_attribution_info": null, "coauthor_producers": [], "comment_count": 18542, "comments": [], "comments_disabled": null, "dimensions": { "height": 1920, "width": 1080 }, "display_url": "https://scontent-dfw6-1.cdninstagram.com/v/t51.82787-15/657341769_18573401086018508_2706953671127003586_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=101&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=_abFRBmYGIwQ7kNvwGEwHw0&_nc_oc=AdrzyUhyAkEW1wkrLz_Q4wcHi5FiIY5HL0-DhlmMqg… (+184 chars)", "has_audio": true, "id": "3860908282093754542", "is_ad": null, "is_affiliate": null, "is_paid_partnership": null, "is_video": true, "like_and_view_counts_disabled": false, "like_count": 532012, "location": null, "owner": { "__typename": "User", "full_name": "Eric D'Alessandro", "id": "30034507", "ig_id": "17841400555210469", "is_private": false, "is_unpublished": false, "is_verified": true, "pk": "30034507", "polaris_ordered_timeline_connection": { "edges": [ { "node": { "__isXIGPolarisMedia": "XIGPolarisVideoMedia", "__typename": "XIGPolarisVideoMedia", "accessibility_caption": "Video by Eric D'Alessandro on March 25, 2026.", "caption": { "text": "Home Goods & Iced Coffee" }, "code": "DWUs6Boj9iu", "display_uri": "https://scontent-dfw6-1.cdninstagram.com/v/t51.82787-15/657341769_18573401086018508_2706953671127003586_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=101&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=_abFRBmYGIwQ7kNvwGEwHw0&_nc_oc=AdrzyUhyAkEW1wkrLz_Q4wcHi5FiIY5HL0-DhlmMqg… (+184 chars)", "id": "POLARIS_3860908282093754542", "media_type": 2, "pk": "3860908282093754542", "product_type": "clips", "seo_canonical_url": null, "user": { "id": "17841400555210469", "pk": "30034507", "username": "ericdalessandro" } } }, { "node": { "__isXIGPolarisMedia": "XIGPolarisImageMedia", "__typename": "XIGPolarisImageMedia", "accessibility_caption": "Photo by Eric D'Alessandro on July 09, 2026. May be an image of one or more people, bone, poster, magazine and text that says 'ERIC D'ALESSANDRO IS DAD TO THE BONE JULY JULY17-19 17-19 JULY 23 JULY 24-25 AUG2 WEST NYACK, NY WESTHAMPTON PROV IDENCE, PROVIDENCE, RI BOSTON, MA BEACH, NY OCT29-30 OCT ROCHESTER,NY OCT 16 PO… (+146 chars)", "caption": { "text": "Daddy’s gettin’ back out there! Comment “VIP” if you want first access to future shows. I’ll DM you so you can join my VIP list and get presale codes, added cities, special events, and merch before they’re announced!\n\nTell daddy where else he should come. (Pause)" }, "code": "DalpQKivQBN", "display_uri": "https://scontent-dfw5-1.cdninstagram.com/v/t51.82787-15/741131311_18603891547018508_8479816093695849974_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=106&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiRkVFRC5iZXN0X2ltYWdlX3VybGdlbi5DMyJ9&_nc_ohc=3t3pJprDEbIQ7kNvwG_PC2E&_nc_oc=AdpbydBNLoZIsSoHy_L-96cbxVLKCsrJt400algBJabiIMEEsJ… (+176 chars)", "id": "POLARIS_3937734879944179789", "media_type": 1, "pk": "3937734879944179789", "product_type": "feed", "seo_canonical_url": null, "user": { "id": "17841400555210469", "pk": "30034507", "username": "ericdalessandro" } } }, "… 10 more items in the full response" ] }, "profile_image_uri": "https://scontent-dfw5-2.cdninstagram.com/v/t51.82787-19/727028585_18597775021018508_2581490950816155972_n.jpg?stp=cp0_dst-jpg_s34x34_tt6&_nc_cat=107&ccb=7-5&_nc_sid=bf7eb4&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy43NzEuQzMifQ%3D%3D&_nc_ohc=an3Up2qPzS4Q7kNvwGWq7oY&_nc_oc=Adp5aF7SURTJxQxSvBitOAesdMIqa9d9JXb2FS9Q8Hv4… (+182 chars)", "profile_pic_url": "https://scontent-dfw5-2.cdninstagram.com/v/t51.82787-19/727028585_18597775021018508_2581490950816155972_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=107&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy43NzEuQzMifQ%3D%3D&_nc_ohc=an3Up2qPzS4Q7kNvwGWq7oY&_nc_oc=Adp5aF7SURTJxQxSvBitOAesdMIqa9d9JXb2FS9Q8Hv4l_… (+180 chars)", "username": "ericdalessandro" }, "product_type": "clips", "shortcode": "DWUs6Boj9iu", "tagged_users": [], "taken_at": 1774476281, "thumbnail_src": "https://scontent-dfw6-1.cdninstagram.com/v/t51.82787-15/657341769_18573401086018508_2706953671127003586_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=101&ig_cache_key=Mzg2MDkwODI4MjA5Mzc1NDU0MjE4NTczNDAxMDgzMDE4NTA4.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjEyOTAuc2RyLnZpZGVvX2RlZmF1bHRfY292ZXJfZnJh… (+282 chars)", "url": "https://www.instagram.com/reel/DWUs6Boj9iu/", "video_duration": 48.436825, "video_play_count": null, "video_url": "https://scontent-dfw5-2.cdninstagram.com/o1/v/t2/f2/m86/AQOz0NM6iu_3t_JdqKC4uPzih7UULdQJtT64_uvARRCYjvAOtPSeNRmkoVG1nR47UdDY8LRRcphV85QnzszofqLtgCVuxDB98CySPus.mp4?_nc_cat=107&_nc_sid=5e9851&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_ohc=2cOA-9nhyx4Q7kNvwESUVyJ&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQ… (+734 chars)", "video_view_count": null }, "… 5 more items in the full response" ], "success": true }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "instagram-reels-search-v4", "billable": true, "duration_ms": 23997 }}