# Scrapier — Instagram API > Profiles, posts, reels, comments, hashtags, highlights, search results and transcripts from Instagram, as structured JSON. Base URL: https://api.scrapier.io/api/v2 · Auth: header `X-API-Key: ` · Synchronous: HTTP 200 returns {"success": true, "data": {...}} · Paginate by sending data.next_cursor back as `cursor` until it is null · Paths keep the trailing slash. Live parameter source (no auth): https://api.scrapier.io/api/v2/endpoints · Docs: https://docs.scrapier.io/api-reference/instagram.md ## GET /instagram-audio-reels/ Instagram Audio Reels: List the reels that use a given Instagram audio track, with author, engagement counts and computed metrics, from the numeric audio ID. Cost: 1 credit per successful call · Pagination: cursor · Results: data.reels Parameters: - audio_ids (required, string, example 1049332199830474): Numeric IG audio id. Required first call. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Notes: - `audio_ids` takes one numeric audio ID per call. - Some engagement fields, such as `shares` and `saves`, can be null. Example: curl "https://api.scrapier.io/api/v2/instagram-audio-reels/?audio_ids=1049332199830474" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/instagram/instagram-audio-reels.md ## GET /instagram-comments/ Instagram Comments: List the comments on a public Instagram post, with author, text and like count, from the post URL. Cost: 1 credit per successful call · Pagination: cursor · Results: data.comments Parameters: - urls (required, string, example https://www.instagram.com/p/DTlCigBADky/): Instagram post or reel URL (/p/, /reel/, /tv/). - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - include_replies (optional, boolean, default true, locked in cursor): Include nested replies. Instagram serves reply threads only to logged-in sessions, so `replies` stays empty and a `warning` explains it. - max_replies_per_comment (optional, integer, default 5): Maximum replies per parent comment (no effect logged-out; see include_replies). - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Notes: - `urls` takes one post or reel URL per call. - `max_replies_per_comment` has no effect while replies are unavailable logged out. Example: curl "https://api.scrapier.io/api/v2/instagram-comments/?urls=https%3A%2F%2Fwww.instagram.com%2Fp%2FDTlCigBADky%2F" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/instagram/instagram-comments.md ## GET /instagram-highlight-details/ Instagram Highlight Details: Look up one Instagram story highlight by ID or URL and get its title, media count and owner. Cost: 1 credit per successful call · Pagination: single lookup · Results: data.highlight Parameters: - highlight_ids (required, string, example 17975319242920589): Bare numeric highlight id, "highlight:ID", or a stories/highlights URL. Lookup endpoint -- next_cursor null. Missing/deleted id -> 404, bad id -> 400, IG block -> 502. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/instagram-highlight-details/?highlight_ids=17975319242920589" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/instagram/instagram-highlight-details.md ## GET /instagram-highlights/ Instagram Highlights: List a public Instagram account's story highlights, with title, cover image and media count, from the username. Cost: 1 credit per successful call · Pagination: cursor · Results: data.highlights Parameters: - usernames (required, string, example mrbeast): Instagram username. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Notes: - `usernames` takes one username per call. Example: curl "https://api.scrapier.io/api/v2/instagram-highlights/?usernames=mrbeast" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/instagram/instagram-highlights.md ## GET /instagram-influencer-engagement/ Instagram Influencer Engagement: Get engagement stats for a public Instagram account (total and average interactions, interactions per 1k followers) over its recent posts. Cost: 1 credit per successful call · Pagination: single lookup · Results: data.profile Parameters: - usernames (required, string, example mrbeast): Public Instagram username, no @. Lookup endpoint — next_cursor null. No login required. - posts_to_analyze (optional, integer, default 20): Size of the recent-media window analyzed (max 500) - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Notes: - The `coverage` block tells you how many items the stats are actually based on. Check `total_items` before comparing accounts. Example: curl "https://api.scrapier.io/api/v2/instagram-influencer-engagement/?usernames=mrbeast" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/instagram/instagram-influencer-engagement.md ## GET /instagram-popular-search/ Instagram Popular Search: Search Instagram by keyword without a login and get top posts and reels, related search terms and the topic's total media count. Cost: 1 credit per successful call · Pagination: cursor · Results: data.posts · Long-running (client timeout 210 s or more) Parameters: - queries (required, string, example ronaldo): Search keyword. Required first call. title/total_media_count/description are only populated on page 1 (SSR-only fields; null on later pages). - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Notes: - `title`, `total_media_count` and `description` are only filled on page 1. They are null on later pages. Example: curl "https://api.scrapier.io/api/v2/instagram-popular-search/?queries=ronaldo" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/instagram/instagram-popular-search.md ## GET /instagram-post-scraper/ Instagram Post: Fetch one Instagram post by URL or shortcode, with caption, owner, like and comment counts and its latest comments. Cost: 1 credit per successful call · Pagination: single lookup · Results: data.post Parameters: - urls (required, string, example https://www.instagram.com/p/DXHKcyvEWfr/): Instagram post/reel/tv URL or bare shortcode. One record, no pagination. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - detail_level (optional, boolean, default true, locked in cursor): Full detail incl. comments. - comments_per_post (optional, integer, default 10, locked in cursor): Latest comments kept. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Notes: - For reels you also want the view count, use `instagram-reel-scraper`. Example: curl "https://api.scrapier.io/api/v2/instagram-post-scraper/?urls=https%3A%2F%2Fwww.instagram.com%2Fp%2FDXHKcyvEWfr%2F" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/instagram/instagram-post-scraper.md ## GET /instagram-profile/ Instagram Profile: Look up a public Instagram account by username, @handle or URL and get its bio, follower, following and post counts and verification status. Cost: 1 credit per successful call · Pagination: single lookup · Results: data.profile Parameters: - usernames (required, string, example mrbeast): Instagram username, @handle, or profile URL. Lookup endpoint. - include_about (optional, boolean, default false): Include an about block (joinedDate/country) — usually null. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Notes: - `include_about` adds an about block (joined date and country), but it's usually null. Example: curl "https://api.scrapier.io/api/v2/instagram-profile/?usernames=mrbeast" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/instagram/instagram-profile.md ## GET /instagram-profile-full/ Instagram Profile Full: Get a public Instagram profile together with its recent posts (with like and comment counts) and related accounts in one call. Cost: 1 credit per successful call · Pagination: single lookup · Results: data.profile Parameters: - usernames (required, string, example mrbeast): Bare username, @handle, or profile URL. Lookup endpoint -- next_cursor null. - max_posts (optional, integer, default 3): Recent posts embedded in the response. - fetch_post_details (optional, boolean, default true): Per-post like/comment counts. - include_related_profiles (optional, boolean, default true): Include AYML related accounts. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Notes: - The account data sits under `profile.data.user`, in Instagram's own nested format, not the flat shape `instagram-profile` returns. - Turn off `fetch_post_details` or `include_related_profiles` if you don't need them. Example: curl "https://api.scrapier.io/api/v2/instagram-profile-full/?usernames=mrbeast" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/instagram/instagram-profile-full.md ## GET /instagram-profile-posts/ Instagram Profile Posts: List a public account's feed posts, a page at a time, with caption, like and comment counts and media type, from the username. Cost: 1 credit per successful call · Pagination: cursor · Results: data.posts · Long-running (client timeout 210 s or more) Parameters: - usernames (required, string, example mrbeast): Instagram username. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - pinned_mode (optional, string, one of: include|skip|only, default include, locked in cursor): include | skip | only — pinned-post filter. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Notes: - `usernames` takes one username per call. Example: curl "https://api.scrapier.io/api/v2/instagram-profile-posts/?usernames=mrbeast" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/instagram/instagram-profile-posts.md ## GET /instagram-profile-reels/ Instagram Profile Reels: List a public account's reels, a page at a time, with caption, like and comment counts and posting time, from the username. Cost: 1 credit per successful call · Pagination: cursor · Results: data.reels Parameters: - usernames (required, string, example natgeo): Instagram username. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Notes: - This list has no view count or duration. For a reel's view count, use `instagram-reel-scraper`. Example: curl "https://api.scrapier.io/api/v2/instagram-profile-reels/?usernames=natgeo" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/instagram/instagram-profile-reels.md ## GET /instagram-profile-search/ Instagram Profile Search: Search Instagram accounts by keyword and get usernames, names, follower counts and verification status. Cost: 1 credit per successful call · Pagination: cursor · Results: data.profiles Parameters: - queries (required, string, example fitness coach): Search keyword. Required first call. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - include_media_count (optional, boolean, default true, locked in cursor): Include each profile's `media_count` in the results. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/instagram-profile-search/?queries=fitness+coach" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/instagram/instagram-profile-search.md ## GET /instagram-reel-scraper/ Instagram Reel: Fetch one Instagram reel by URL or shortcode, with caption, owner, view, like and comment counts and its latest comments. Cost: 1 credit per successful call · Pagination: single lookup · Results: data.reel Parameters: - urls (required, string, example https://www.instagram.com/reel/DXHKcyvEWfr/): Instagram reel/post/tv URL or bare shortcode. One record, no pagination. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - include_shares_count (optional, boolean, default false, locked in cursor): Attempt reshare_count. - comments_per_post (optional, integer, default 10, locked in cursor): Latest comments kept. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Notes: - `include_shares_count` is best-effort: the share count may not always be available. Example: curl "https://api.scrapier.io/api/v2/instagram-reel-scraper/?urls=https%3A%2F%2Fwww.instagram.com%2Freel%2FDXHKcyvEWfr%2F" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/instagram/instagram-reel-scraper.md ## GET /instagram-suggested-users/ Instagram Suggested Users: Get the accounts Instagram suggests as related to a public profile, from a username or profile URL. Cost: 1 credit per successful call · Pagination: single lookup · Results: data.related Parameters: - urls (required, string, example https://www.instagram.com/mrbeast/): Instagram username or profile URL. Lookup endpoint. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/instagram-suggested-users/?urls=https%3A%2F%2Fwww.instagram.com%2Fmrbeast%2F" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/instagram/instagram-suggested-users.md ## GET /instagram-transcript/ Instagram Transcript: Transcribe the speech in an Instagram reel or video post from its URL, with detected language and the post's like and comment counts. Cost: 2 credits per successful call · Pagination: single lookup · Results: data.transcript · Long-running (client timeout 210 s or more) Parameters: - urls (required, string, example https://www.instagram.com/reel/DXtvzz7B3dC/): Reel/post URL. Lookup endpoint — next_cursor null. - translate_to_english (optional, boolean, default false): Translate transcript to English - model_size (optional, string, one of: tiny|base|small|medium|large-v3, default base): faster-whisper model size - beam_size (optional, integer, default 1): Beam search width (1-10) - language (optional, string): ISO language code to force (default: auto-detect) - max_duration_seconds (optional, integer, default 0): Optional cap: videos longer than this many seconds are rejected up front (422). 0 = no cap (full transcript, or a typed 504 if it cannot finish in time) - vad_filter (optional, boolean, default true): Drop non-speech audio - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Notes: - `model_size` accepts tiny, base, small, medium or large-v3. The default is base. - Check `status` in the result: it reports whether transcription succeeded. Example: curl "https://api.scrapier.io/api/v2/instagram-transcript/?urls=https%3A%2F%2Fwww.instagram.com%2Freel%2FDXtvzz7B3dC%2F" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/instagram/instagram-transcript.md ## GET /instagram-trending-reels/ Instagram Trending Reels: List currently trending Instagram reels, a page at a time, with caption, like and comment counts and author. No input needed. Cost: 1 credit per successful call · Pagination: cursor · Results: data.reels Parameters: - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. No parameter is marked required; send at least one input (see descriptions). Example: curl "https://api.scrapier.io/api/v2/instagram-trending-reels/" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/instagram/instagram-trending-reels.md