Instagram profile (v1)

The profile header plus a page of posts.

Address it by username or by numeric user_id. The numeric id is the cheaper path, since a username has to be resolved first.

Set include_carousels to have carousel posts return each of their slides rather than just the cover image.

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.

count?integer

Number of posts to fetch (values below 1 are clamped to 1; Instagram caps the upper end itself)

Default12

cursor?string

Cursor for pagination

include_carousels?boolean

Also return the profile's carousel (multi-slide) posts, with every slide under child_content, the same carousel shape the Instagram details endpoint returns. Instagram serves reels and carousels from two different endpoints, so this is slower. Off by default: the response is unchanged when omitted or false.

Defaultfalse

user_id?string

Numeric Instagram user id, accepted in place of username. Instagram's reels surface keys on this id and never on the handle, so supplying it skips the handle->id resolve the username path pays for and adds no call of its own: one request for the page instead of three. Send both and the id is used as-is, with no resolve. The reels are identical either way; what the id alone cannot buy is anything ABOUT the creator, so additional.profile_demographics (biography, follower counts, category) comes back empty, pass username when you need it. Private, deleted and restricted accounts still answer with the same 404/403 and profile_status the username path returns, never a silently empty page.

username?string

Creator's username/handle without @. Either this or user_id.

Response Body

`application/json`

curl -X POST "https://example.com/v1/scrapers/instagram-profile" \  -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": "➕✖️",          "blocked_by_viewer": false,          "business_contact_method": "UNKNOWN",          "country_block": false,          "eimu_id": "104094827655955",          "fbid": "17841400010500476",          "followed_by_viewer": false,          "follower_count": 15312082,          "following_count": 3722,          "follows_viewer": false,          "full_name": "Martin Garrix",          "has_ar_effects": false,          "has_blocked_viewer": false,          "has_channel": false,          "has_clips": true,          "has_guides": false,          "has_onboarded_to_text_post_app": false,          "has_requested_viewer": false,          "hide_like_and_view_counts": false,          "highlight_reel_count": 3,          "id": "30464350",          "is_business_account": false,          "is_embeds_disabled": false,          "is_guardian_of_viewer": false,          "is_joined_recently": false,          "is_private": false,          "is_professional_account": true,          "is_regulated_c18": false,          "is_supervised_by_viewer": false,          "is_supervised_user": false,          "is_supervision_enabled": false,          "is_verified": true,          "is_verified_by_mv4b": false,          "pinned_channels_list_count": 0,          "profile_pic_url": "https://scontent-iad3-2.cdninstagram.com/v/t51.82787-19/751713274_18623563387000351_2217450144032847054_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-iad3-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2gEvupND5kLzIOS6JnIhv-UhH6QeiK_HE5_oijnD_R3X8YuRfLPbyjm4b… (+178 chars)",          "profile_pic_url_hd": "https://scontent-iad3-2.cdninstagram.com/v/t51.82787-19/751713274_18623563387000351_2217450144032847054_n.jpg?stp=dst-jpg_s320x320_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-iad3-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2gEvupND5kLzIOS6JnIhv-UhH6QeiK_HE5_oijnD_R3X8YuRfLPbyjm4bIvL… (+175 chars)",          "remove_message_entrypoint": false,          "requested_by_viewer": false,          "should_show_category": false,          "should_show_public_contacts": false,          "show_account_transparency_details": true,          "show_text_post_app_badge": false,          "username": "martingarrix"        }      },      "main": [        {          "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,          "post_id": "3968670134879654132",          "post_url": "https://instagram.com/reel/DcTjHX0NBD0/",          "profile_picture_url": "https://scontent-iad3-2.cdninstagram.com/v/t51.82787-19/751713274_18623563387000351_2217450144032847054_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-iad3-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2gESOHmM5TGNJ9djlawq5k_nBuddyvnE4k_ag9h2yCTGcSHh19zuB0q1V… (+178 chars)",          "save_count": null,          "share_count": null,          "thumbnail_url": "https://scontent-iad6-1.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… (+304 chars)",          "upload_timestamp": 1787322424,          "video_duration_seconds": 61.84000015258789,          "video_url": "https://scontent-iad6-1.cdninstagram.com/o1/v/t2/f2/m86/AQNlvjCFPJDNI16ZcYxGsFk-bRGUUR7ZmI6JELKOlF4xc9wPpa3cmAenVV2Ye-AjC9CIPDEd-NFp63dBP5FNfoOfi5EeNuzzKRQAEGA.mp4?_nc_cat=102&_nc_sid=5e9851&_nc_ht=scontent-iad6-1.cdninstagram.com&_nc_ohc=cgHhpzv2eYkQ7kNvwEFQAMM&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQ… (+738 chars)",          "video_urls_by_quality": {            "high": "https://scontent-iad6-1.cdninstagram.com/o1/v/t2/f2/m86/AQNlvjCFPJDNI16ZcYxGsFk-bRGUUR7ZmI6JELKOlF4xc9wPpa3cmAenVV2Ye-AjC9CIPDEd-NFp63dBP5FNfoOfi5EeNuzzKRQAEGA.mp4?_nc_cat=102&_nc_sid=5e9851&_nc_ht=scontent-iad6-1.cdninstagram.com&_nc_ohc=cgHhpzv2eYkQ7kNvwEFQAMM&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQ… (+738 chars)",            "low": "https://scontent-iad6-1.cdninstagram.com/o1/v/t2/f2/m86/AQNlvjCFPJDNI16ZcYxGsFk-bRGUUR7ZmI6JELKOlF4xc9wPpa3cmAenVV2Ye-AjC9CIPDEd-NFp63dBP5FNfoOfi5EeNuzzKRQAEGA.mp4?_nc_cat=102&_nc_sid=5e9851&_nc_ht=scontent-iad6-1.cdninstagram.com&_nc_ohc=cgHhpzv2eYkQ7kNvwEFQAMM&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQ… (+738 chars)",            "medium": "https://scontent-iad6-1.cdninstagram.com/o1/v/t2/f2/m86/AQNlvjCFPJDNI16ZcYxGsFk-bRGUUR7ZmI6JELKOlF4xc9wPpa3cmAenVV2Ye-AjC9CIPDEd-NFp63dBP5FNfoOfi5EeNuzzKRQAEGA.mp4?_nc_cat=102&_nc_sid=5e9851&_nc_ht=scontent-iad6-1.cdninstagram.com&_nc_ohc=cgHhpzv2eYkQ7kNvwEFQAMM&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQ… (+738 chars)",            "watermarked": null          },          "view_count": 1209039        },        {          "caption": "Fireflies in Romania!! ❤️❤️❤️",          "comment_count": 572,          "creator_handle": "martingarrix",          "hashtags": [],          "is_ad": false,          "is_paid_partnership": false,          "is_video": true,          "like_count": 46849,          "post_id": "3959972677165767838",          "post_url": "https://instagram.com/reel/Db0pitGt9ye/",          "profile_picture_url": "https://scontent-iad3-2.cdninstagram.com/v/t51.82787-19/751713274_18623563387000351_2217450144032847054_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-iad3-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2gESOHmM5TGNJ9djlawq5k_nBuddyvnE4k_ag9h2yCTGcSHh19zuB0q1V… (+178 chars)",          "save_count": null,          "share_count": null,          "thumbnail_url": "https://scontent-iad6-1.cdninstagram.com/v/t51.82787-15/771998518_18630053989000351_1655616608433649162_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=106&ig_cache_key=Mzk1OTk3MjY3NzE2NTc2NzgzODE4NjMwMDUzOTg2MDAwMzUx.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&_nc_aid=0&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjcyMC5zZHIudmlkZW9fZGVmYXVsdF9jb3… (+305 chars)",          "upload_timestamp": 1786285778,          "video_duration_seconds": 67.24299621582031,          "video_url": "https://scontent-iad3-2.cdninstagram.com/o1/v/t2/f2/m86/AQM7sQwlQd-35GLJFuUUMpofs1sOpzfKqROz7H5tfC91A1dOToCvx-O3y6CKDcVinGI7OnICQONYBrFh5dr7n0FK5MP6H5_7CmUvwLE.mp4?_nc_cat=105&_nc_sid=5e9851&_nc_ht=scontent-iad3-2.cdninstagram.com&_nc_ohc=GHn3Rzim5RwQ7kNvwH09I6W&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQ… (+738 chars)",          "video_urls_by_quality": {            "high": "https://scontent-iad3-2.cdninstagram.com/o1/v/t2/f2/m86/AQM7sQwlQd-35GLJFuUUMpofs1sOpzfKqROz7H5tfC91A1dOToCvx-O3y6CKDcVinGI7OnICQONYBrFh5dr7n0FK5MP6H5_7CmUvwLE.mp4?_nc_cat=105&_nc_sid=5e9851&_nc_ht=scontent-iad3-2.cdninstagram.com&_nc_ohc=GHn3Rzim5RwQ7kNvwH09I6W&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQ… (+738 chars)",            "low": "https://scontent-iad3-2.cdninstagram.com/o1/v/t2/f2/m86/AQM7sQwlQd-35GLJFuUUMpofs1sOpzfKqROz7H5tfC91A1dOToCvx-O3y6CKDcVinGI7OnICQONYBrFh5dr7n0FK5MP6H5_7CmUvwLE.mp4?_nc_cat=105&_nc_sid=5e9851&_nc_ht=scontent-iad3-2.cdninstagram.com&_nc_ohc=GHn3Rzim5RwQ7kNvwH09I6W&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQ… (+738 chars)",            "medium": "https://scontent-iad3-2.cdninstagram.com/o1/v/t2/f2/m86/AQM7sQwlQd-35GLJFuUUMpofs1sOpzfKqROz7H5tfC91A1dOToCvx-O3y6CKDcVinGI7OnICQONYBrFh5dr7n0FK5MP6H5_7CmUvwLE.mp4?_nc_cat=105&_nc_sid=5e9851&_nc_ht=scontent-iad3-2.cdninstagram.com&_nc_ohc=GHn3Rzim5RwQ7kNvwH09I6W&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQ… (+738 chars)",            "watermarked": null          },          "view_count": 779382        },        "… 10 more items in the full response"      ]    },    "pagination": {      "cursor": "eyJjdXJzb3IiOiAiUVZGQk5VZzRVSGx5UzBFdGRESm1Na0pQU2xSbVlVWjBVVzFCTFZGS1NVaHVhVFJ1UzBJeFgwZEVWVnBmU0RoMU0zbGlTMGhtUlhsVFNYQjRVa00xWjJaNWVESXlUMUkyV1ZCRFJrTlNRV3BXUld4ZlRtYzRWZz09IiwgInVzZXJfaWQiOiAiMzA0NjQzNTAifQ=="    }  },  "error": null,  "meta": {    "client_id": "client_abc123",    "scraper": "instagram-profile",    "billable": true,    "duration_ms": 4854  }}

Authorization

Request Body

Response Body

200application/json

404application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`