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