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.
Overview
Section titled “Overview”Send a username, @handle or profile URL in usernames. You get back one profile object with the account’s ID, username, full name, biography, follower and following counts, post count, verified and private flags, highlight count and profile picture URL.
It’s a single lookup: everything comes back in one call.
Use cases
Section titled “Use cases”- Enrich a list of creators or leads with follower counts.
- Check whether an account is verified or private.
- Track follower growth by calling it on a schedule.
Request
Section titled “Request”curl -G "https://api.scrapier.io/api/v2/instagram-profile/" \ -H "X-API-Key: YOUR_API_KEY" \ --data-urlencode "usernames=mrbeast" \ --max-time 210const params = new URLSearchParams({ usernames: "mrbeast" });
const res = await fetch(`https://api.scrapier.io/api/v2/instagram-profile/?${params}`, { headers: { "X-API-Key": "YOUR_API_KEY" }, signal: AbortSignal.timeout(210_000),});const body = await res.json();if (!res.ok) throw new Error(body.error ?? body.detail ?? `HTTP ${res.status}`);
console.log(body.data.profile);import requests
resp = requests.get( "https://api.scrapier.io/api/v2/instagram-profile/", headers={"X-API-Key": "YOUR_API_KEY"}, params={"usernames": "mrbeast"}, timeout=210,)body = resp.json()if not resp.ok: raise RuntimeError(body.get("error") or body.get("detail"))
print(body["data"]["profile"])curl -X POST "https://api.scrapier.io/api/v2/instagram-profile/" \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"usernames":"mrbeast"}' \ --max-time 210Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
X-API-Key header | string | yes | — | Your API key from the dashboard. |
usernames | string | yes | e.g. mrbeast | Instagram username, @handle, or profile URL. Lookup endpoint. |
include_about | boolean | no | false | Include an about block (joinedDate/country) — usually null. |
cursor | string | no | — | 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. |
Advanced
| Name | Type | Default | Description |
|---|---|---|---|
use_proxy | boolean | true | Route the request through Scrapier's residential proxy pool. Default: true. Leave as is unless support tells you otherwise. |
raw_data | boolean | 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. |
Response
Section titled “Response”{ "success": true, "data": { "usernames": "mrbeast", "profile": { "inputUrl": "https://www.instagram.com/mrbeast/", "url": "https://www.instagram.com/mrbeast", "id": "2278169415", "username": "mrbeast", "fullName": "MrBeast", "biography": "Video Philanthropist 💰", "followersCount": 456000000, "followsCount": 500, "postsCount": 350, "verified": true, "private": false, "highlightReelCount": 5, "profilePicUrl": "https://instagram.fbhk1-3.fna.fbcdn.net/v/t51.2885-19/mrbeast_profile.jpg", "relatedProfiles": [], "latestIgtvVideos": [], "latestPosts": [], "scraped_at": "2026-03-09T15:19:49.021Z" }, "next_cursor": null }}Bad input. The exact message varies by endpoint.
{ "success": false, "error": "…"}Balance below the endpoint’s price.
{ "error": "Insufficient credits. Buy more to scrape more.", "balance": 1, "required": 2}Invalid or unknown API key.
{ "detail": "Authentication service unavailable or invalid API key."}Throttled — wait for Retry-After.
{ "detail": "Request was throttled. Expected available in N seconds."}Sample from the live catalog; arrays trimmed to 3 items. Results are in data.profile.
Response fields
Section titled “Response fields”| Field | Type | Example | Description |
|---|---|---|---|
usernames | string | mrbeast | — |
profile | object | {…} | The results. |
next_cursor | null | null | Pass back as cursor for the next page. null on the last page. |
profile.inputUrl | string | https://www.instagram.com/mrbeast/ | — |
profile.url | string | https://www.instagram.com/mrbeast | — |
profile.id | string | 2278169415 | — |
profile.username | string | mrbeast | — |
profile.fullName | string | MrBeast | — |
profile.biography | string | Video Philanthropist 💰 | — |
profile.followersCount | integer | 456000000 | — |
profile.followsCount | integer | 500 | — |
profile.postsCount | integer | 350 | — |
profile.verified | boolean | true | — |
profile.private | boolean | false | — |
profile.highlightReelCount | integer | 5 | — |
profile.profilePicUrl | string | https://instagram.fbhk1-3.fna.fbcdn.net/v/t51… | — |
profile.relatedProfiles | array | [] | — |
profile.latestIgtvVideos | array | [] | — |
profile.latestPosts | array | [] | — |
profile.scraped_at | string | 2026-03-09T15:19:49.021Z | — |
Pagination
Section titled “Pagination”Returns everything in one call; next_cursor is always null.
Errors
Section titled “Errors”Failed calls are free. Branch on the HTTP status and read the message from error (or detail). Full details in Errors.
| Status | Meaning | Retry? | Charged? |
|---|---|---|---|
400 | Bad or missing input. | No — fix the params | No |
401 / 403 | Missing, invalid or revoked API key. | No — fix the key | No |
402 | Out of credits (body has balance). | No — top up | No |
404 | Unknown endpoint slug. | No — check the slug | No |
429 / 503 | Busy or throttled. | Yes — after Retry-After | No |
5xx | Target site or upstream failure, or timeout. | Yes — with backoff | No |
include_aboutadds an about block (joined date and country), but it’s usually null.
Related
Section titled “Related”- Instagram Profile Full — Get a public Instagram profile together with its recent posts (with like and comment counts) and related accounts in one call.
- Instagram Influencer Engagement — Get engagement stats for a public Instagram account (total and average interactions, interactions per 1k followers) over its recent 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.