API referenceInstagram
Instagram profile (v3)
An Instagram profile with a richer set of fields.
The same target as instagram-profile, with more of the profile detail
filled in. Takes a username and pages through posts with a cursor.
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 21.7s.
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-profile-v3" \ -H "Content-Type: application/json" \ -d '{ "username": "natgeo" }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "pagination": { "cursor": "eyJjdXJzb3IiOiAiMzk2NzkzMjI2NDc5NzY2MzU0MV83ODcxMzIiLCAidXNlcl9pZCI6ICI3ODcxMzIifQ==", "has_more": true }, "posts": [ { "accessibility_description": null, "advertisement_status": false, "author_id": "787132", "author_name": "National Geographic", "author_username": "natgeo", "caption": "This young cub could be king… he’s just got some growing up to do first.\n\nWitness Kio's real-life journey from cub to king in #NatGeoLION, a new National Geographic documentary series from executive producers Jon Favreau and Mike Gunton, premiering Wednesday, August 19 at 9/8c on National Geographic. Streaming on @Disn… (+17 chars)", "child_content": null, "collaborators": [ { "full_name": "Hulu", "is_verified": true, "profile_image": "https://instagram.fagc3-1.fna.fbcdn.net/v/t51.82787-19/574400438_18538966897034610_4563057389814688225_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDc5LmMyIn0&_nc_ht=instagram.fagc3-1.fna.fbcdn.net&_nc_cat=1&_nc_oc=Q6cZ2gH5SWqbSw04yHpb4ubyL77TXeNa_t3UVjpV_-aSqg23bJMURN0h9v1oUQm… (+176 chars)", "user_id": "191074609", "username": "hulu" }, { "full_name": "Disney", "is_verified": true, "profile_image": "https://instagram.fagc3-1.fna.fbcdn.net/v/t51.82787-19/681692858_18587843602026735_8030287207233432804_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby44MDAuYzIifQ&_nc_ht=instagram.fagc3-1.fna.fbcdn.net&_nc_cat=1&_nc_oc=Q6cZ2gH5SWqbSw04yHpb4ubyL77TXeNa_t3UVjpV_-aSqg23bJMURN0h9v1oUQmJ… (+175 chars)", "user_id": "284634734", "username": "disney" }, "… 3 more items in the full response" ], "comment_count": 1411, "commenting_status": "disabled", "content_code": "Dbru79IAdH-", "content_id": "3957463127796339198", "content_language": null, "content_link": "https://www.instagram.com/reel/Dbru79IAdH-/", "content_type": "reel", "first_comment": null, "has_audio": true, "hashtags": [ "NatGeoLION" ], "images": [], "like_count": 206284, "location": null, "media_height": 1280, "media_links": { "high": "https://instagram.fagc3-2.fna.fbcdn.net/o1/v/t2/f2/m86/AQMIgrJKbqOmUon_sgZkkOa0Kcfrruc2VJBj-KZOee_sruT965YiNkJbRdgBOHpfegWGEWy4wY8chFaeC0IXIpe5dmA5i5QhxKoqYJc.mp4?_nc_cat=108&_nc_oc=AdpGIegb5X_OppNT_do8-pfSYJ-lSr0XKeW3oawvVZsVOPYXkwehquSl933UX7da0w0&_nc_sid=5e9851&_nc_ht=instagram.fagc3-2.fna.fbcdn.net&_nc_ohc=P5rfjjY_… (+835 chars)", "low": "https://instagram.fagc3-2.fna.fbcdn.net/o1/v/t2/f2/m86/AQMIgrJKbqOmUon_sgZkkOa0Kcfrruc2VJBj-KZOee_sruT965YiNkJbRdgBOHpfegWGEWy4wY8chFaeC0IXIpe5dmA5i5QhxKoqYJc.mp4?_nc_cat=108&_nc_oc=AdpGIegb5X_OppNT_do8-pfSYJ-lSr0XKeW3oawvVZsVOPYXkwehquSl933UX7da0w0&_nc_sid=5e9851&_nc_ht=instagram.fagc3-2.fna.fbcdn.net&_nc_ohc=P5rfjjY_… (+835 chars)", "medium": "https://instagram.fagc3-2.fna.fbcdn.net/o1/v/t2/f2/m86/AQMIgrJKbqOmUon_sgZkkOa0Kcfrruc2VJBj-KZOee_sruT965YiNkJbRdgBOHpfegWGEWy4wY8chFaeC0IXIpe5dmA5i5QhxKoqYJc.mp4?_nc_cat=108&_nc_oc=AdpGIegb5X_OppNT_do8-pfSYJ-lSr0XKeW3oawvVZsVOPYXkwehquSl933UX7da0w0&_nc_sid=5e9851&_nc_ht=instagram.fagc3-2.fna.fbcdn.net&_nc_ohc=P5rfjjY_… (+835 chars)", "watermarked": null }, "media_width": 720, "mentions": [ "DisneyPlus", "hulu" ], "music_information": { "artist": "natgeo", "audio_id": "28139527835659346", "cover_url": null, "duration_seconds": 62.062, "is_original": true, "title": "Original audio" }, "pinned_status": true, "play_count": 4621625, "published_date": 1786024802, "slideshow_status": false, "sponsorship_status": false, "tagged_users": [ { "full_name": "National Geographic TV", "is_verified": true, "profile_image": "https://instagram.fagc3-1.fna.fbcdn.net/v/t51.82787-19/682751368_18589194847043047_4545394067639262942_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby40MDAuYzIifQ&_nc_ht=instagram.fagc3-1.fna.fbcdn.net&_nc_cat=1&_nc_oc=Q6cZ2gH5SWqbSw04yHpb4ubyL77TXeNa_t3UVjpV_-aSqg23bJMURN0h9v1oUQmJ… (+175 chars)", "user_id": "18091046", "username": "natgeotv" }, { "full_name": "Hulu", "is_verified": true, "profile_image": "https://instagram.fagc3-1.fna.fbcdn.net/v/t51.82787-19/574400438_18538966897034610_4563057389814688225_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDc5LmMyIn0&_nc_ht=instagram.fagc3-1.fna.fbcdn.net&_nc_cat=1&_nc_oc=Q6cZ2gH5SWqbSw04yHpb4ubyL77TXeNa_t3UVjpV_-aSqg23bJMURN0h9v1oUQm… (+176 chars)", "user_id": "191074609", "username": "hulu" }, "… 3 more items in the full response" ], "thumbnail_image": "https://instagram.fagc3-1.fna.fbcdn.net/v/t51.82787-15/766074324_18683503753019133_3711038265165025656_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=101&_nc_map=urlgen_bucketless&ig_cache_key=Mzk1NzQ2MzEyNzc5NjMzOTE5ODE4NjgzNTAzNzUwMDE5MTMz.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjEwODAuc2RyLnZpZGV… (+317 chars)", "video_duration_seconds": 62.08000183105469, "video_link": "https://instagram.fagc3-2.fna.fbcdn.net/o1/v/t2/f2/m86/AQMIgrJKbqOmUon_sgZkkOa0Kcfrruc2VJBj-KZOee_sruT965YiNkJbRdgBOHpfegWGEWy4wY8chFaeC0IXIpe5dmA5i5QhxKoqYJc.mp4?_nc_cat=108&_nc_oc=AdpGIegb5X_OppNT_do8-pfSYJ-lSr0XKeW3oawvVZsVOPYXkwehquSl933UX7da0w0&_nc_sid=5e9851&_nc_ht=instagram.fagc3-2.fna.fbcdn.net&_nc_ohc=P5rfjjY_… (+835 chars)", "view_count": 4621625 }, { "accessibility_description": null, "advertisement_status": false, "author_id": "787132", "author_name": "National Geographic", "author_username": "natgeo", "caption": "Describe Pompeii: Out of Time in 3 words? It's Now Streaming.\n\n#PompeiiOutOfTime with @twhiddleston is now streaming on @DisneyPlus and @hulu.", "child_content": null, "collaborators": [ { "full_name": "Disney+", "is_verified": true, "profile_image": "https://instagram.fagc3-1.fna.fbcdn.net/v/t51.82787-19/703110892_18344888794253468_7849965211262610293_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby41NDAuYzIifQ&_nc_ht=instagram.fagc3-1.fna.fbcdn.net&_nc_cat=1&_nc_oc=Q6cZ2gH5SWqbSw04yHpb4ubyL77TXeNa_t3UVjpV_-aSqg23bJMURN0h9v1oUQmJ… (+175 chars)", "user_id": "7522677467", "username": "disneyplus" }, { "full_name": "Hulu", "is_verified": true, "profile_image": "https://instagram.fagc3-1.fna.fbcdn.net/v/t51.82787-19/574400438_18538966897034610_4563057389814688225_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDc5LmMyIn0&_nc_ht=instagram.fagc3-1.fna.fbcdn.net&_nc_cat=1&_nc_oc=Q6cZ2gH5SWqbSw04yHpb4ubyL77TXeNa_t3UVjpV_-aSqg23bJMURN0h9v1oUQm… (+176 chars)", "user_id": "191074609", "username": "hulu" }, "… 1 more item in the full response" ], "comment_count": 263, "commenting_status": "disabled", "content_code": "DbIdlf0j6uA", "content_id": "3947535193527528320", "content_language": "en", "content_link": "https://www.instagram.com/reel/DbIdlf0j6uA/", "content_type": "reel", "first_comment": null, "has_audio": true, "hashtags": [ "PompeiiOutOfTime" ], "images": [], "like_count": 25221, "location": null, "media_height": 1920, "media_links": { "high": "https://instagram.fagc3-1.fna.fbcdn.net/o1/v/t2/f2/m86/AQOvM90zPTwW0N4CDD39RzvglWYHp-iJeLZwN99oLQCPSXXSvMBvmrxrAPpyQT3kP8bZd5Bg55bReyqubnmyVfuNRMqla8GLx8vvGKw.mp4?_nc_cat=103&_nc_oc=AdpzgHRVelgKoDFhB15hyDiElUudYRkiAaBCWd7gbb82ALUvOH6NwV16oBK7wD__fw8&_nc_sid=5e9851&_nc_ht=instagram.fagc3-1.fna.fbcdn.net&_nc_ohc=yrqCLgIn… (+835 chars)", "low": "https://instagram.fagc3-1.fna.fbcdn.net/o1/v/t2/f2/m86/AQOvM90zPTwW0N4CDD39RzvglWYHp-iJeLZwN99oLQCPSXXSvMBvmrxrAPpyQT3kP8bZd5Bg55bReyqubnmyVfuNRMqla8GLx8vvGKw.mp4?_nc_cat=103&_nc_oc=AdpzgHRVelgKoDFhB15hyDiElUudYRkiAaBCWd7gbb82ALUvOH6NwV16oBK7wD__fw8&_nc_sid=5e9851&_nc_ht=instagram.fagc3-1.fna.fbcdn.net&_nc_ohc=yrqCLgIn… (+835 chars)", "medium": "https://instagram.fagc3-1.fna.fbcdn.net/o1/v/t2/f2/m86/AQOvM90zPTwW0N4CDD39RzvglWYHp-iJeLZwN99oLQCPSXXSvMBvmrxrAPpyQT3kP8bZd5Bg55bReyqubnmyVfuNRMqla8GLx8vvGKw.mp4?_nc_cat=103&_nc_oc=AdpzgHRVelgKoDFhB15hyDiElUudYRkiAaBCWd7gbb82ALUvOH6NwV16oBK7wD__fw8&_nc_sid=5e9851&_nc_ht=instagram.fagc3-1.fna.fbcdn.net&_nc_ohc=yrqCLgIn… (+835 chars)", "watermarked": null }, "media_width": 1080, "mentions": [ "twhiddleston", "DisneyPlus", "… 1 more item in the full response" ], "music_information": { "artist": "natgeo", "audio_id": "27556914760669733", "cover_url": null, "duration_seconds": 36.2, "is_original": true, "title": "Original audio" }, "pinned_status": true, "play_count": 1999783, "published_date": 1784811603, "slideshow_status": false, "sponsorship_status": false, "tagged_users": [ { "full_name": "Hulu", "is_verified": true, "profile_image": "https://instagram.fagc3-1.fna.fbcdn.net/v/t51.82787-19/574400438_18538966897034610_4563057389814688225_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDc5LmMyIn0&_nc_ht=instagram.fagc3-1.fna.fbcdn.net&_nc_cat=1&_nc_oc=Q6cZ2gH5SWqbSw04yHpb4ubyL77TXeNa_t3UVjpV_-aSqg23bJMURN0h9v1oUQm… (+176 chars)", "user_id": "191074609", "username": "hulu" }, { "full_name": "Hulu", "is_verified": true, "profile_image": "https://instagram.fagc3-1.fna.fbcdn.net/v/t51.82787-19/574400438_18538966897034610_4563057389814688225_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDc5LmMyIn0&_nc_ht=instagram.fagc3-1.fna.fbcdn.net&_nc_cat=1&_nc_oc=Q6cZ2gH5SWqbSw04yHpb4ubyL77TXeNa_t3UVjpV_-aSqg23bJMURN0h9v1oUQm… (+176 chars)", "user_id": "191074609", "username": "hulu" }, "… 4 more items in the full response" ], "thumbnail_image": "https://instagram.fagc3-2.fna.fbcdn.net/v/t51.82787-15/752808040_18678898645019133_4153257147870540953_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=106&_nc_map=urlgen_bucketless&ig_cache_key=Mzk0NzUzNTE5MzUyNzUyODMyMDE4Njc4ODk4NjM5MDE5MTMz.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjEwODAuc2RyLnZpZGV… (+317 chars)", "video_duration_seconds": 36.20199966430664, "video_link": "https://instagram.fagc3-1.fna.fbcdn.net/o1/v/t2/f2/m86/AQOvM90zPTwW0N4CDD39RzvglWYHp-iJeLZwN99oLQCPSXXSvMBvmrxrAPpyQT3kP8bZd5Bg55bReyqubnmyVfuNRMqla8GLx8vvGKw.mp4?_nc_cat=103&_nc_oc=AdpzgHRVelgKoDFhB15hyDiElUudYRkiAaBCWd7gbb82ALUvOH6NwV16oBK7wD__fw8&_nc_sid=5e9851&_nc_ht=instagram.fagc3-1.fna.fbcdn.net&_nc_ohc=yrqCLgIn… (+835 chars)", "view_count": 1999783 }, "… 10 more items in the full response" ], "profile": { "biography": null, "business_account_status": null, "business_address": null, "business_category": null, "business_email": null, "business_phone_number": null, "category_name": null, "content_count": null, "display_name": "National Geographic", "external_links": [], "fbid": null, "follower_count": null, "following_count": null, "highlight_count": null, "is_professional_account": null, "is_regulated_c18": null, "is_supervised_user": null, "privacy_status": null, "profile_id": "787132", "profile_image": "https://instagram.fagc3-1.fna.fbcdn.net/v/t51.82787-19/683576066_18653628823019133_9051036240972105113_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby40MDAuYzIifQ&_nc_ht=instagram.fagc3-1.fna.fbcdn.net&_nc_cat=1&_nc_oc=Q6cZ2gH5SWqbSw04yHpb4ubyL77TXeNa_t3UVjpV_-aSqg23bJMURN0h9v1oUQmJ… (+175 chars)", "profile_link": "https://www.instagram.com/natgeo/", "pronouns": null, "recently_joined_status": null, "username": "natgeo", "verification_status": true } }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "instagram-profile-v3", "billable": true, "duration_ms": 20633 }}