Instagram Highlights API Reference
Highlight trays on a profile — IDs, titles and covers.
Maintained by the InScrape API team · Last reviewed 2026-09-19
GET /v1/instagram/highlights0.95 credits per requestRequest examples
Choose your language
All examples call the same REST endpoint.
curl "https://api.inscrape.dev/v1/instagram/highlights?handle=iamsydneythomas" \
-H "x-api-key: $INSCRAPE_KEY"Response examples
Explore the response
Switch tabs to inspect representative payloads.
Include
{ "success": true, "credits_charged": 0.95, "credits_remaining": 843, "processing_time_ms": 1842, "requested_at": "2026-09-13T14:32:18Z", "query": { "username": "iamsydneythomas", "include_profile": true, "include_posts": true }, "data": { "highlights": [ { "position": "1", "id": "17901234567890123", "title": "Wildlife", "coverUrl": "https://cdn.example.com/highlights/1.jpg" }, { "position": "2", "id": "17901234567890124", "title": "Travel", "coverUrl": "https://cdn.example.com/highlights/2.jpg" }, { "position": "3", "id": "17901234567890125", "title": "Behind the scenes", "coverUrl": "https://cdn.example.com/highlights/3.jpg" }, { "position": "4", "id": "17901234567890126", "title": "Favorites", "coverUrl": "https://cdn.example.com/highlights/4.jpg" }, { "position": "5", "id": "17901234567890127", "title": "Events", "coverUrl": "https://cdn.example.com/highlights/5.jpg" }, { "position": "6", "id": "17901234567890128", "title": "Studio", "coverUrl": "https://cdn.example.com/highlights/6.jpg" }, { "position": "7", "id": "17901234567890129", "title": "Q&A", "coverUrl": "https://cdn.example.com/highlights/7.jpg" } ], "profile": { "pk": "1751818088", "username": "iamsydneythomas", "full_name": "Sydney Thomas", "biography": "sports + comedy · barstool sports", "follower_count": 1284331, "following_count": 612, "media_count": 1847, "is_verified": true, "is_business_account": true, "category": "Digital creator", "threads_badge_label": "@iamsydneythomas", "threads_badge": true, "latest_story_media": 0, "profile_pic_url": "https://cdn.example.com/iamsydneythomas.jpg", "profile_pic_url_hd": "https://cdn.example.com/iamsydneythomas-hd.jpg", "bio_links": [ { "title": "Official links", "url": "https://example.com/iamsydneythomas", "link_type": "external", "is_pinned": false } ] }, "posts": [ { "post_index": "1", "id": "18058122345678901", "shortCode": "C8QltIdyB01", "postLink": "https://www.instagram.com/p/C8QltIdyB01/", "post_timestamp": 1724176991, "is_pinned": false, "likes": 84112, "comments": 902, "reposts": 164, "fb_like_count": null, "fb_comment_count": null, "mediaType": 2, "product_type": "clips", "caption": "Inside one of the planet's most remote landscapes. #explore", "accessibility_caption": null, "firstMedia": [ { "url": "https://cdn.example.com/posts/C8QltIdyB01.jpg", "width": 1080, "height": 1350 } ], "carouselMedia": [], "location": null, "owner": { "pk": "1751818088", "username": "iamsydneythomas", "full_name": "Sydney Thomas", "is_verified": true, "profile_pic_url": "https://cdn.example.com/iamsydneythomas.jpg" }, "coauthors": [], "usertags": [ { "pk": "25025320", "id": "25025320", "username": "instagram", "full_name": "Instagram", "profile_pic_url": "https://cdn.example.com/instagram.jpg", "is_verified": true, "position": [ 0.51, 0.44 ] } ], "mentions": [ "instagram" ], "hashtag": [ "#explore" ], "caption_is_edited": false, "is_paid_partnership": false, "sponsor_tags": null, "aigm_account_label_info": { "attribution_label_text": null, "is_auto_detected": false, "is_enabled": false, "is_manually_enabled": false }, "latest_story_media": 0, "like_and_view_counts_disabled": false, "comments_disabled": false, "commenting_disabled_for_viewer": false, "can_viewer_reshare": true, "ig_media_sharing_disabled": false, "can_see_insights_as_brand": false, "hasAudio": true, "clips_metadata": { "audio_type": "original_sounds", "music_canonical_id": null, "music_info": null, "original_sound_info": { "original_audio_title": "Original audio", "should_mute_audio": false, "audio_asset_id": "18401234567890123", "consumption_info": { "is_trending_in_clips": false, "should_mute_audio_reason": "", "should_mute_audio_reason_type": null }, "ig_artist": { "id": "1751818088", "username": "iamsydneythomas", "profile_pic_url": "https://cdn.example.com/iamsydneythomas.jpg" }, "is_explicit": false, "audio_filter_infos": null } }, "ai_agent_owner_username": null, "ai_label_info": null, "post_date": "2024-08-20 18:03:11 UTC+0" }, { "post_index": "2", "id": "18058122345678902", "shortCode": "C8QltIdyB02", "postLink": "https://www.instagram.com/p/C8QltIdyB02/", "post_timestamp": 1724090591, "is_pinned": false, "likes": 84112, "comments": 902, "reposts": 164, "fb_like_count": null, "fb_comment_count": null, "mediaType": 2, "product_type": "clips", "caption": "Inside one of the planet's most remote landscapes. #explore", "accessibility_caption": null, "firstMedia": [ { "url": "https://cdn.example.com/posts/C8QltIdyB02.jpg", "width": 1080, "height": 1350 } ], "carouselMedia": [], "location": null, "owner": { "pk": "1751818088", "username": "iamsydneythomas", "full_name": "Sydney Thomas", "is_verified": true, "profile_pic_url": "https://cdn.example.com/iamsydneythomas.jpg" }, "coauthors": [], "usertags": [ { "pk": "25025320", "id": "25025320", "username": "instagram", "full_name": "Instagram", "profile_pic_url": "https://cdn.example.com/instagram.jpg", "is_verified": true, "position": [ 0.51, 0.44 ] } ], "mentions": [ "instagram" ], "hashtag": [ "#explore" ], "caption_is_edited": false, "is_paid_partnership": false, "sponsor_tags": null, "aigm_account_label_info": { "attribution_label_text": null, "is_auto_detected": false, "is_enabled": false, "is_manually_enabled": false }, "latest_story_media": 0, "like_and_view_counts_disabled": false, "comments_disabled": false, "commenting_disabled_for_viewer": false, "can_viewer_reshare": true, "ig_media_sharing_disabled": false, "can_see_insights_as_brand": false, "hasAudio": true, "clips_metadata": { "audio_type": "original_sounds", "music_canonical_id": null, "music_info": null, "original_sound_info": { "original_audio_title": "Original audio", "should_mute_audio": false, "audio_asset_id": "18401234567890123", "consumption_info": { "is_trending_in_clips": false, "should_mute_audio_reason": "", "should_mute_audio_reason_type": null }, "ig_artist": { "id": "1751818088", "username": "iamsydneythomas", "profile_pic_url": "https://cdn.example.com/iamsydneythomas.jpg" }, "is_explicit": false, "audio_filter_infos": null } }, "ai_agent_owner_username": null, "ai_label_info": null, "post_date": "2024-08-19 18:03:11 UTC+0" }, { "post_index": "3", "id": "18058122345678903", "shortCode": "C8QltIdyB03", "postLink": "https://www.instagram.com/p/C8QltIdyB03/", "post_timestamp": 1724004191, "is_pinned": false, "likes": 84112, "comments": 902, "reposts": 164, "fb_like_count": null, "fb_comment_count": null, "mediaType": 2, "product_type": "clips", "caption": "Inside one of the planet's most remote landscapes. #explore", "accessibility_caption": null, "firstMedia": [ { "url": "https://cdn.example.com/posts/C8QltIdyB03.jpg", "width": 1080, "height": 1350 } ], "carouselMedia": [], "location": null, "owner": { "pk": "1751818088", "username": "iamsydneythomas", "full_name": "Sydney Thomas", "is_verified": true, "profile_pic_url": "https://cdn.example.com/iamsydneythomas.jpg" }, "coauthors": [], "usertags": [ { "pk": "25025320", "id": "25025320", "username": "instagram", "full_name": "Instagram", "profile_pic_url": "https://cdn.example.com/instagram.jpg", "is_verified": true, "position": [ 0.51, 0.44 ] } ], "mentions": [ "instagram" ], "hashtag": [ "#explore" ], "caption_is_edited": false, "is_paid_partnership": false, "sponsor_tags": null, "aigm_account_label_info": { "attribution_label_text": null, "is_auto_detected": false, "is_enabled": false, "is_manually_enabled": false }, "latest_story_media": 0, "like_and_view_counts_disabled": false, "comments_disabled": false, "commenting_disabled_for_viewer": false, "can_viewer_reshare": true, "ig_media_sharing_disabled": false, "can_see_insights_as_brand": false, "hasAudio": true, "clips_metadata": { "audio_type": "original_sounds", "music_canonical_id": null, "music_info": null, "original_sound_info": { "original_audio_title": "Original audio", "should_mute_audio": false, "audio_asset_id": "18401234567890123", "consumption_info": { "is_trending_in_clips": false, "should_mute_audio_reason": "", "should_mute_audio_reason_type": null }, "ig_artist": { "id": "1751818088", "username": "iamsydneythomas", "profile_pic_url": "https://cdn.example.com/iamsydneythomas.jpg" }, "is_explicit": false, "audio_filter_infos": null } }, "ai_agent_owner_username": null, "ai_label_info": null, "post_date": "2024-08-18 18:03:11 UTC+0" }, { "post_index": "4", "id": "18058122345678904", "shortCode": "C8QltIdyB04", "postLink": "https://www.instagram.com/p/C8QltIdyB04/", "post_timestamp": 1723917791, "is_pinned": false, "likes": 84112, "comments": 902, "reposts": 164, "fb_like_count": null, "fb_comment_count": null, "mediaType": 2, "product_type": "clips", "caption": "Inside one of the planet's most remote landscapes. #explore", "accessibility_caption": null, "firstMedia": [ { "url": "https://cdn.example.com/posts/C8QltIdyB04.jpg", "width": 1080, "height": 1350 } ], "carouselMedia": [], "location": null, "owner": { "pk": "1751818088", "username": "iamsydneythomas", "full_name": "Sydney Thomas", "is_verified": true, "profile_pic_url": "https://cdn.example.com/iamsydneythomas.jpg" }, "coauthors": [], "usertags": [ { "pk": "25025320", "id": "25025320", "username": "instagram", "full_name": "Instagram", "profile_pic_url": "https://cdn.example.com/instagram.jpg", "is_verified": true, "position": [ 0.51, 0.44 ] } ], "mentions": [ "instagram" ], "hashtag": [ "#explore" ], "caption_is_edited": false, "is_paid_partnership": false, "sponsor_tags": null, "aigm_account_label_info": { "attribution_label_text": null, "is_auto_detected": false, "is_enabled": false, "is_manually_enabled": false }, "latest_story_media": 0, "like_and_view_counts_disabled": false, "comments_disabled": false, "commenting_disabled_for_viewer": false, "can_viewer_reshare": true, "ig_media_sharing_disabled": false, "can_see_insights_as_brand": false, "hasAudio": true, "clips_metadata": { "audio_type": "original_sounds", "music_canonical_id": null, "music_info": null, "original_sound_info": { "original_audio_title": "Original audio", "should_mute_audio": false, "audio_asset_id": "18401234567890123", "consumption_info": { "is_trending_in_clips": false, "should_mute_audio_reason": "", "should_mute_audio_reason_type": null }, "ig_artist": { "id": "1751818088", "username": "iamsydneythomas", "profile_pic_url": "https://cdn.example.com/iamsydneythomas.jpg" }, "is_explicit": false, "audio_filter_infos": null } }, "ai_agent_owner_username": null, "ai_label_info": null, "post_date": "2024-08-17 18:03:11 UTC+0" }, { "post_index": "5", "id": "18058122345678905", "shortCode": "C8QltIdyB05", "postLink": "https://www.instagram.com/p/C8QltIdyB05/", "post_timestamp": 1723831391, "is_pinned": false, "likes": 84112, "comments": 902, "reposts": 164, "fb_like_count": null, "fb_comment_count": null, "mediaType": 2, "product_type": "clips", "caption": "Inside one of the planet's most remote landscapes. #explore", "accessibility_caption": null, "firstMedia": [ { "url": "https://cdn.example.com/posts/C8QltIdyB05.jpg", "width": 1080, "height": 1350 } ], "carouselMedia": [], "location": null, "owner": { "pk": "1751818088", "username": "iamsydneythomas", "full_name": "Sydney Thomas", "is_verified": true, "profile_pic_url": "https://cdn.example.com/iamsydneythomas.jpg" }, "coauthors": [], "usertags": [ { "pk": "25025320", "id": "25025320", "username": "instagram", "full_name": "Instagram", "profile_pic_url": "https://cdn.example.com/instagram.jpg", "is_verified": true, "position": [ 0.51, 0.44 ] } ], "mentions": [ "instagram" ], "hashtag": [ "#explore" ], "caption_is_edited": false, "is_paid_partnership": false, "sponsor_tags": null, "aigm_account_label_info": { "attribution_label_text": null, "is_auto_detected": false, "is_enabled": false, "is_manually_enabled": false }, "latest_story_media": 0, "like_and_view_counts_disabled": false, "comments_disabled": false, "commenting_disabled_for_viewer": false, "can_viewer_reshare": true, "ig_media_sharing_disabled": false, "can_see_insights_as_brand": false, "hasAudio": true, "clips_metadata": { "audio_type": "original_sounds", "music_canonical_id": null, "music_info": null, "original_sound_info": { "original_audio_title": "Original audio", "should_mute_audio": false, "audio_asset_id": "18401234567890123", "consumption_info": { "is_trending_in_clips": false, "should_mute_audio_reason": "", "should_mute_audio_reason_type": null }, "ig_artist": { "id": "1751818088", "username": "iamsydneythomas", "profile_pic_url": "https://cdn.example.com/iamsydneythomas.jpg" }, "is_explicit": false, "audio_filter_infos": null } }, "ai_agent_owner_username": null, "ai_label_info": null, "post_date": "2024-08-16 18:03:11 UTC+0" }, { "post_index": "6", "id": "18058122345678906", "shortCode": "C8QltIdyB06", "postLink": "https://www.instagram.com/p/C8QltIdyB06/", "post_timestamp": 1723744991, "is_pinned": false, "likes": 84112, "comments": 902, "reposts": 164, "fb_like_count": null, "fb_comment_count": null, "mediaType": 2, "product_type": "clips", "caption": "Inside one of the planet's most remote landscapes. #explore", "accessibility_caption": null, "firstMedia": [ { "url": "https://cdn.example.com/posts/C8QltIdyB06.jpg", "width": 1080, "height": 1350 } ], "carouselMedia": [], "location": null, "owner": { "pk": "1751818088", "username": "iamsydneythomas", "full_name": "Sydney Thomas", "is_verified": true, "profile_pic_url": "https://cdn.example.com/iamsydneythomas.jpg" }, "coauthors": [], "usertags": [ { "pk": "25025320", "id": "25025320", "username": "instagram", "full_name": "Instagram", "profile_pic_url": "https://cdn.example.com/instagram.jpg", "is_verified": true, "position": [ 0.51, 0.44 ] } ], "mentions": [ "instagram" ], "hashtag": [ "#explore" ], "caption_is_edited": false, "is_paid_partnership": false, "sponsor_tags": null, "aigm_account_label_info": { "attribution_label_text": null, "is_auto_detected": false, "is_enabled": false, "is_manually_enabled": false }, "latest_story_media": 0, "like_and_view_counts_disabled": false, "comments_disabled": false, "commenting_disabled_for_viewer": false, "can_viewer_reshare": true, "ig_media_sharing_disabled": false, "can_see_insights_as_brand": false, "hasAudio": true, "clips_metadata": { "audio_type": "original_sounds", "music_canonical_id": null, "music_info": null, "original_sound_info": { "original_audio_title": "Original audio", "should_mute_audio": false, "audio_asset_id": "18401234567890123", "consumption_info": { "is_trending_in_clips": false, "should_mute_audio_reason": "", "should_mute_audio_reason_type": null }, "ig_artist": { "id": "1751818088", "username": "iamsydneythomas", "profile_pic_url": "https://cdn.example.com/iamsydneythomas.jpg" }, "is_explicit": false, "audio_filter_infos": null } }, "ai_agent_owner_username": null, "ai_label_info": null, "post_date": "2024-08-15 18:03:11 UTC+0" }, { "post_index": "7", "id": "18058122345678907", "shortCode": "C8QltIdyB07", "postLink": "https://www.instagram.com/p/C8QltIdyB07/", "post_timestamp": 1723658591, "is_pinned": false, "likes": 84112, "comments": 902, "reposts": 164, "fb_like_count": null, "fb_comment_count": null, "mediaType": 2, "product_type": "clips", "caption": "Inside one of the planet's most remote landscapes. #explore", "accessibility_caption": null, "firstMedia": [ { "url": "https://cdn.example.com/posts/C8QltIdyB07.jpg", "width": 1080, "height": 1350 } ], "carouselMedia": [], "location": null, "owner": { "pk": "1751818088", "username": "iamsydneythomas", "full_name": "Sydney Thomas", "is_verified": true, "profile_pic_url": "https://cdn.example.com/iamsydneythomas.jpg" }, "coauthors": [], "usertags": [ { "pk": "25025320", "id": "25025320", "username": "instagram", "full_name": "Instagram", "profile_pic_url": "https://cdn.example.com/instagram.jpg", "is_verified": true, "position": [ 0.51, 0.44 ] } ], "mentions": [ "instagram" ], "hashtag": [ "#explore" ], "caption_is_edited": false, "is_paid_partnership": false, "sponsor_tags": null, "aigm_account_label_info": { "attribution_label_text": null, "is_auto_detected": false, "is_enabled": false, "is_manually_enabled": false }, "latest_story_media": 0, "like_and_view_counts_disabled": false, "comments_disabled": false, "commenting_disabled_for_viewer": false, "can_viewer_reshare": true, "ig_media_sharing_disabled": false, "can_see_insights_as_brand": false, "hasAudio": true, "clips_metadata": { "audio_type": "original_sounds", "music_canonical_id": null, "music_info": null, "original_sound_info": { "original_audio_title": "Original audio", "should_mute_audio": false, "audio_asset_id": "18401234567890123", "consumption_info": { "is_trending_in_clips": false, "should_mute_audio_reason": "", "should_mute_audio_reason_type": null }, "ig_artist": { "id": "1751818088", "username": "iamsydneythomas", "profile_pic_url": "https://cdn.example.com/iamsydneythomas.jpg" }, "is_explicit": false, "audio_filter_infos": null } }, "ai_agent_owner_username": null, "ai_label_info": null, "post_date": "2024-08-14 18:03:11 UTC+0" }, { "post_index": "8", "id": "18058122345678908", "shortCode": "C8QltIdyB08", "postLink": "https://www.instagram.com/p/C8QltIdyB08/", "post_timestamp": 1723572191, "is_pinned": false, "likes": 84112, "comments": 902, "reposts": 164, "fb_like_count": null, "fb_comment_count": null, "mediaType": 2, "product_type": "clips", "caption": "Inside one of the planet's most remote landscapes. #explore", "accessibility_caption": null, "firstMedia": [ { "url": "https://cdn.example.com/posts/C8QltIdyB08.jpg", "width": 1080, "height": 1350 } ], "carouselMedia": [], "location": null, "owner": { "pk": "1751818088", "username": "iamsydneythomas", "full_name": "Sydney Thomas", "is_verified": true, "profile_pic_url": "https://cdn.example.com/iamsydneythomas.jpg" }, "coauthors": [], "usertags": [ { "pk": "25025320", "id": "25025320", "username": "instagram", "full_name": "Instagram", "profile_pic_url": "https://cdn.example.com/instagram.jpg", "is_verified": true, "position": [ 0.51, 0.44 ] } ], "mentions": [ "instagram" ], "hashtag": [ "#explore" ], "caption_is_edited": false, "is_paid_partnership": false, "sponsor_tags": null, "aigm_account_label_info": { "attribution_label_text": null, "is_auto_detected": false, "is_enabled": false, "is_manually_enabled": false }, "latest_story_media": 0, "like_and_view_counts_disabled": false, "comments_disabled": false, "commenting_disabled_for_viewer": false, "can_viewer_reshare": true, "ig_media_sharing_disabled": false, "can_see_insights_as_brand": false, "hasAudio": true, "clips_metadata": { "audio_type": "original_sounds", "music_canonical_id": null, "music_info": null, "original_sound_info": { "original_audio_title": "Original audio", "should_mute_audio": false, "audio_asset_id": "18401234567890123", "consumption_info": { "is_trending_in_clips": false, "should_mute_audio_reason": "", "should_mute_audio_reason_type": null }, "ig_artist": { "id": "1751818088", "username": "iamsydneythomas", "profile_pic_url": "https://cdn.example.com/iamsydneythomas.jpg" }, "is_explicit": false, "audio_filter_infos": null } }, "ai_agent_owner_username": null, "ai_label_info": null, "post_date": "2024-08-13 18:03:11 UTC+0" }, { "post_index": "9", "id": "18058122345678909", "shortCode": "C8QltIdyB09", "postLink": "https://www.instagram.com/p/C8QltIdyB09/", "post_timestamp": 1723485791, "is_pinned": false, "likes": 84112, "comments": 902, "reposts": 164, "fb_like_count": null, "fb_comment_count": null, "mediaType": 2, "product_type": "clips", "caption": "Inside one of the planet's most remote landscapes. #explore", "accessibility_caption": null, "firstMedia": [ { "url": "https://cdn.example.com/posts/C8QltIdyB09.jpg", "width": 1080, "height": 1350 } ], "carouselMedia": [], "location": null, "owner": { "pk": "1751818088", "username": "iamsydneythomas", "full_name": "Sydney Thomas", "is_verified": true, "profile_pic_url": "https://cdn.example.com/iamsydneythomas.jpg" }, "coauthors": [], "usertags": [ { "pk": "25025320", "id": "25025320", "username": "instagram", "full_name": "Instagram", "profile_pic_url": "https://cdn.example.com/instagram.jpg", "is_verified": true, "position": [ 0.51, 0.44 ] } ], "mentions": [ "instagram" ], "hashtag": [ "#explore" ], "caption_is_edited": false, "is_paid_partnership": false, "sponsor_tags": null, "aigm_account_label_info": { "attribution_label_text": null, "is_auto_detected": false, "is_enabled": false, "is_manually_enabled": false }, "latest_story_media": 0, "like_and_view_counts_disabled": false, "comments_disabled": false, "commenting_disabled_for_viewer": false, "can_viewer_reshare": true, "ig_media_sharing_disabled": false, "can_see_insights_as_brand": false, "hasAudio": true, "clips_metadata": { "audio_type": "original_sounds", "music_canonical_id": null, "music_info": null, "original_sound_info": { "original_audio_title": "Original audio", "should_mute_audio": false, "audio_asset_id": "18401234567890123", "consumption_info": { "is_trending_in_clips": false, "should_mute_audio_reason": "", "should_mute_audio_reason_type": null }, "ig_artist": { "id": "1751818088", "username": "iamsydneythomas", "profile_pic_url": "https://cdn.example.com/iamsydneythomas.jpg" }, "is_explicit": false, "audio_filter_infos": null } }, "ai_agent_owner_username": null, "ai_label_info": null, "post_date": "2024-08-12 18:03:11 UTC+0" }, { "post_index": "10", "id": "18058122345678910", "shortCode": "C8QltIdyB10", "postLink": "https://www.instagram.com/p/C8QltIdyB10/", "post_timestamp": 1723399391, "is_pinned": false, "likes": 84112, "comments": 902, "reposts": 164, "fb_like_count": null, "fb_comment_count": null, "mediaType": 2, "product_type": "clips", "caption": "Inside one of the planet's most remote landscapes. #explore", "accessibility_caption": null, "firstMedia": [ { "url": "https://cdn.example.com/posts/C8QltIdyB10.jpg", "width": 1080, "height": 1350 } ], "carouselMedia": [], "location": null, "owner": { "pk": "1751818088", "username": "iamsydneythomas", "full_name": "Sydney Thomas", "is_verified": true, "profile_pic_url": "https://cdn.example.com/iamsydneythomas.jpg" }, "coauthors": [], "usertags": [ { "pk": "25025320", "id": "25025320", "username": "instagram", "full_name": "Instagram", "profile_pic_url": "https://cdn.example.com/instagram.jpg", "is_verified": true, "position": [ 0.51, 0.44 ] } ], "mentions": [ "instagram" ], "hashtag": [ "#explore" ], "caption_is_edited": false, "is_paid_partnership": false, "sponsor_tags": null, "aigm_account_label_info": { "attribution_label_text": null, "is_auto_detected": false, "is_enabled": false, "is_manually_enabled": false }, "latest_story_media": 0, "like_and_view_counts_disabled": false, "comments_disabled": false, "commenting_disabled_for_viewer": false, "can_viewer_reshare": true, "ig_media_sharing_disabled": false, "can_see_insights_as_brand": false, "hasAudio": true, "clips_metadata": { "audio_type": "original_sounds", "music_canonical_id": null, "music_info": null, "original_sound_info": { "original_audio_title": "Original audio", "should_mute_audio": false, "audio_asset_id": "18401234567890123", "consumption_info": { "is_trending_in_clips": false, "should_mute_audio_reason": "", "should_mute_audio_reason_type": null }, "ig_artist": { "id": "1751818088", "username": "iamsydneythomas", "profile_pic_url": "https://cdn.example.com/iamsydneythomas.jpg" }, "is_explicit": false, "audio_filter_infos": null } }, "ai_agent_owner_username": null, "ai_label_info": null, "post_date": "2024-08-11 18:03:11 UTC+0" }, { "post_index": "11", "id": "18058122345678911", "shortCode": "C8QltIdyB11", "postLink": "https://www.instagram.com/p/C8QltIdyB11/", "post_timestamp": 1723312991, "is_pinned": false, "likes": 84112, "comments": 902, "reposts": 164, "fb_like_count": null, "fb_comment_count": null, "mediaType": 2, "product_type": "clips", "caption": "Inside one of the planet's most remote landscapes. #explore", "accessibility_caption": null, "firstMedia": [ { "url": "https://cdn.example.com/posts/C8QltIdyB11.jpg", "width": 1080, "height": 1350 } ], "carouselMedia": [], "location": null, "owner": { "pk": "1751818088", "username": "iamsydneythomas", "full_name": "Sydney Thomas", "is_verified": true, "profile_pic_url": "https://cdn.example.com/iamsydneythomas.jpg" }, "coauthors": [], "usertags": [ { "pk": "25025320", "id": "25025320", "username": "instagram", "full_name": "Instagram", "profile_pic_url": "https://cdn.example.com/instagram.jpg", "is_verified": true, "position": [ 0.51, 0.44 ] } ], "mentions": [ "instagram" ], "hashtag": [ "#explore" ], "caption_is_edited": false, "is_paid_partnership": false, "sponsor_tags": null, "aigm_account_label_info": { "attribution_label_text": null, "is_auto_detected": false, "is_enabled": false, "is_manually_enabled": false }, "latest_story_media": 0, "like_and_view_counts_disabled": false, "comments_disabled": false, "commenting_disabled_for_viewer": false, "can_viewer_reshare": true, "ig_media_sharing_disabled": false, "can_see_insights_as_brand": false, "hasAudio": true, "clips_metadata": { "audio_type": "original_sounds", "music_canonical_id": null, "music_info": null, "original_sound_info": { "original_audio_title": "Original audio", "should_mute_audio": false, "audio_asset_id": "18401234567890123", "consumption_info": { "is_trending_in_clips": false, "should_mute_audio_reason": "", "should_mute_audio_reason_type": null }, "ig_artist": { "id": "1751818088", "username": "iamsydneythomas", "profile_pic_url": "https://cdn.example.com/iamsydneythomas.jpg" }, "is_explicit": false, "audio_filter_infos": null } }, "ai_agent_owner_username": null, "ai_label_info": null, "post_date": "2024-08-10 18:03:11 UTC+0" }, { "post_index": "12", "id": "18058122345678912", "shortCode": "C8QltIdyB12", "postLink": "https://www.instagram.com/p/C8QltIdyB12/", "post_timestamp": 1723226591, "is_pinned": false, "likes": 84112, "comments": 902, "reposts": 164, "fb_like_count": null, "fb_comment_count": null, "mediaType": 2, "product_type": "clips", "caption": "Inside one of the planet's most remote landscapes. #explore", "accessibility_caption": null, "firstMedia": [ { "url": "https://cdn.example.com/posts/C8QltIdyB12.jpg", "width": 1080, "height": 1350 } ], "carouselMedia": [], "location": null, "owner": { "pk": "1751818088", "username": "iamsydneythomas", "full_name": "Sydney Thomas", "is_verified": true, "profile_pic_url": "https://cdn.example.com/iamsydneythomas.jpg" }, "coauthors": [], "usertags": [ { "pk": "25025320", "id": "25025320", "username": "instagram", "full_name": "Instagram", "profile_pic_url": "https://cdn.example.com/instagram.jpg", "is_verified": true, "position": [ 0.51, 0.44 ] } ], "mentions": [ "instagram" ], "hashtag": [ "#explore" ], "caption_is_edited": false, "is_paid_partnership": false, "sponsor_tags": null, "aigm_account_label_info": { "attribution_label_text": null, "is_auto_detected": false, "is_enabled": false, "is_manually_enabled": false }, "latest_story_media": 0, "like_and_view_counts_disabled": false, "comments_disabled": false, "commenting_disabled_for_viewer": false, "can_viewer_reshare": true, "ig_media_sharing_disabled": false, "can_see_insights_as_brand": false, "hasAudio": true, "clips_metadata": { "audio_type": "original_sounds", "music_canonical_id": null, "music_info": null, "original_sound_info": { "original_audio_title": "Original audio", "should_mute_audio": false, "audio_asset_id": "18401234567890123", "consumption_info": { "is_trending_in_clips": false, "should_mute_audio_reason": "", "should_mute_audio_reason_type": null }, "ig_artist": { "id": "1751818088", "username": "iamsydneythomas", "profile_pic_url": "https://cdn.example.com/iamsydneythomas.jpg" }, "is_explicit": false, "audio_filter_infos": null } }, "ai_agent_owner_username": null, "ai_label_info": null, "post_date": "2024-08-09 18:03:11 UTC+0" } ] }}Headers
| Name | Type | Required | Description |
|---|---|---|---|
| x-api-key | string | Yes | Your API key. All keys on a team share one credit pool. |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
| handle | string | Yes | Instagram username, without the @ |
| include_profile | boolean | No | Return the full profile. Included at no extra credit cost.default: false |
| include_posts | boolean | No | Return the latest 12 posts. Included at no extra credit cost.default: false |
Errors
| Status | Code | When |
|---|---|---|
400 | INVALID_PARAMS | A required parameter is missing or the wrong type. |
401 | INVALID_API_KEY | The key is unknown or has been revoked. |
402 | INSUFFICIENT_CREDITS | Balance is below this endpoint's cost. |
402 | KEY_LIMIT_REACHED | This API key has reached its credit limit. |
404 | ENDPOINT_NOT_FOUND | The API endpoint does not exist. Check the API URL and endpoint path. No credits are charged. |
500 | SCRAPE_FAILED | Upstream fetch failed after retries. |
503 | SERVICE_UNAVAILABLE | The API is temporarily unavailable. Check credits_charged; failures before resource use are free. |
504 | UPSTREAM_TIMEOUT | The upstream scraper timed out. |
Completed lookups return 200 and are charged at the endpoint rate, including private accounts and confirmed missing targets. Empty or missing targets return empty lists; an unavailable Profile is null. Documented empty next-page responses remain free. Check credits_charged on every response.