API referenceInstagram
Instagram feed
A profile's posts, paged with a cursor.
Pages through a profile's posts. Use this when you want the feed on its
own; instagram-profile returns the profile header and its posts
together.
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 11.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-feed" \ -H "Content-Type: application/json" \ -d '{ "username": "martingarrix" }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "data": { "additional": { "profile_demographics": { "biography": "" } }, "main": [ { "caption": "electric nights in IBIZAAAA @burnaboygram 🔥🔥❤️❤️⚡️⚡️", "carousel_media": [ { "is_video": false, "thumbnail_url": "https://scontent-ord5-2.cdninstagram.com/v/t51.82787-15/784351029_18635172130000351_4403825278449934403_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=1&ig_cache_key=Mzk2OTU2Nzc0MzI4MjUyMzk5MQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&_nc_aid=0&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMzA3Mi5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc… (+309 chars)", "video_url": null }, { "is_video": false, "thumbnail_url": "https://scontent-ord5-2.cdninstagram.com/v/t51.82787-15/781459630_18635172121000351_725487255392061174_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=1&ig_cache_key=Mzk2OTU2Nzc1MjE3NDU2NzExNg%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&_nc_aid=0&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMzA3Mi5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_… (+308 chars)", "video_url": null }, "… 10 more items in the full response" ], "comment_count": 261, "creator_handle": "martingarrix", "hashtags": [], "is_ad": false, "is_paid_partnership": false, "is_video": false, "like_count": 41341, "media_type": 8, "post_id": "3969568659978653432", "post_url": "https://instagram.com/p/DcWvaohjQ74/", "profile_picture_url": "https://scontent-ord5-2.cdninstagram.com/v/t51.82787-19/751713274_18623563387000351_2217450144032847054_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-ord5-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2gGnLnUQ8ZHJ757oOns4qF1eQdnVn3PEYQRpRFl1G-nGN0mf_5IYQVztW… (+199 chars)", "save_count": null, "share_count": null, "shortcode": "DcWvaohjQ74", "thumbnail_url": "https://scontent-ord5-2.cdninstagram.com/v/t51.82787-15/784351029_18635172130000351_4403825278449934403_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=1&ig_cache_key=Mzk2OTU2Nzc0MzI4MjUyMzk5MQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&_nc_aid=0&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMzA3Mi5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc… (+309 chars)", "upload_timestamp": 1787429481, "video_duration_seconds": null, "video_url": null, "video_urls_by_quality": { "high": null, "low": null, "medium": null, "watermarked": null }, "view_count": 0 }, { "caption": "official Fireflies video will be out today on YouTube!! very excited to finally share this @u2 ✨❤️", "comment_count": 982, "creator_handle": "martingarrix", "hashtags": [], "is_ad": false, "is_paid_partnership": false, "is_video": true, "like_count": 65644, "media_type": 2, "post_id": "3968670134879654132", "post_url": "https://instagram.com/p/DcTjHX0NBD0/", "profile_picture_url": "https://scontent-ord5-2.cdninstagram.com/v/t51.82787-19/751713274_18623563387000351_2217450144032847054_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-ord5-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2gGnLnUQ8ZHJ757oOns4qF1eQdnVn3PEYQRpRFl1G-nGN0mf_5IYQVztW… (+199 chars)", "save_count": null, "share_count": null, "shortcode": "DcTjHX0NBD0", "thumbnail_url": "https://scontent-ord5-2.cdninstagram.com/v/t51.82787-15/779944551_18634713955000351_121128383938375191_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=107&ig_cache_key=Mzk2ODY3MDEzNDg3OTY1NDEzMjE4NjM0NzEzOTUyMDAwMzUx.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&_nc_aid=0&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjcyMC5zZHIudmlkZW9fZGVmYXVsdF9jb3Z… (+325 chars)", "upload_timestamp": 1787322424, "video_duration_seconds": 61.84000015258789, "video_url": "https://scontent-ord5-2.cdninstagram.com/o1/v/t2/f2/m86/AQNlvjCFPJDNI16ZcYxGsFk-bRGUUR7ZmI6JELKOlF4xc9wPpa3cmAenVV2Ye-AjC9CIPDEd-NFp63dBP5FNfoOfi5EeNuzzKRQAEGA.mp4?_nc_cat=102&_nc_sid=5e9851&_nc_ht=scontent-ord5-2.cdninstagram.com&_nc_ohc=cgHhpzv2eYkQ7kNvwGNa75v&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQ… (+738 chars)", "video_urls_by_quality": { "high": "https://scontent-ord5-2.cdninstagram.com/o1/v/t2/f2/m86/AQNlvjCFPJDNI16ZcYxGsFk-bRGUUR7ZmI6JELKOlF4xc9wPpa3cmAenVV2Ye-AjC9CIPDEd-NFp63dBP5FNfoOfi5EeNuzzKRQAEGA.mp4?_nc_cat=102&_nc_sid=5e9851&_nc_ht=scontent-ord5-2.cdninstagram.com&_nc_ohc=cgHhpzv2eYkQ7kNvwGNa75v&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQ… (+738 chars)", "low": "https://scontent-ord5-2.cdninstagram.com/o1/v/t2/f2/m86/AQNlvjCFPJDNI16ZcYxGsFk-bRGUUR7ZmI6JELKOlF4xc9wPpa3cmAenVV2Ye-AjC9CIPDEd-NFp63dBP5FNfoOfi5EeNuzzKRQAEGA.mp4?_nc_cat=102&_nc_sid=5e9851&_nc_ht=scontent-ord5-2.cdninstagram.com&_nc_ohc=cgHhpzv2eYkQ7kNvwGNa75v&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQ… (+738 chars)", "medium": "https://scontent-ord5-2.cdninstagram.com/o1/v/t2/f2/m86/AQNlvjCFPJDNI16ZcYxGsFk-bRGUUR7ZmI6JELKOlF4xc9wPpa3cmAenVV2Ye-AjC9CIPDEd-NFp63dBP5FNfoOfi5EeNuzzKRQAEGA.mp4?_nc_cat=102&_nc_sid=5e9851&_nc_ht=scontent-ord5-2.cdninstagram.com&_nc_ohc=cgHhpzv2eYkQ7kNvwGNa75v&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQ… (+738 chars)", "watermarked": null }, "view_count": 1209019 }, "… 10 more items in the full response" ] }, "pagination": { "cursor": "eyJjdXJzb3IiOiAiMzk0NjI1Nzk5Mzc5MjYwMzQwOV8zMDQ2NDM1MCIsICJ1c2VyX2lkIjogIjMwNDY0MzUwIn0=" } }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "instagram-feed", "billable": true, "duration_ms": 10950 }}