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 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 5.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.

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 /instagram-single returns. Instagram serves reels and carousels from two different endpoints, so this costs one extra lookup per page (run concurrently, so ~no added latency). 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`