GETProfiles1 credit

Get profile

GET https://api.instagramapi.dev/v1/profile

Returns the public profile: bio, full name, follower/following counts, post count, profile picture, verified/business flags, and external links.

Build this with an AI agent

Paste this prompt into Claude, Codex, or any coding agent.

Parameters

Name	Type	Required	Description
handle	string	yes	An Instagram account. Accepts a username (`nike`), a numeric user id (`13460080`), or a full profile URL (`https://instagram.com/nike`). We resolve it automatically.

Example request

curl "https://api.instagramapi.dev/v1/profile?handle=nike" \
  -H "Authorization: Bearer $INSTAGRAMAPI_KEY"

const res = await fetch("https://api.instagramapi.dev/v1/profile?handle=nike", {
  headers: { Authorization: `Bearer ${process.env.INSTAGRAMAPI_KEY}` },
});

res = requests.get("https://api.instagramapi.dev/v1/profile?handle=nike",
    headers={"Authorization": f"Bearer {INSTAGRAMAPI_KEY}"})

Try it

Live request · uses 1 credit

API key

handle *string

Example responses

Switch tabs to see the body shape for success and each error status.

{
  "data": {
    "id": "13460080",
    "username": "nike",
    "full_name": "Nike",
    "biography": "Just Do It.",
    "is_verified": true,
    "is_private": false,
    "is_business": true,
    "category": null,
    "followers": 291952375,
    "following": 264,
    "posts": 1657,
    "external_url": "http://empli.fi/nike",
    "profile_pic_url": "https://instagram.com/.../nike.jpg",
    "public_email": null,
    "public_phone_number": null
  },
  "meta": {
    "endpoint": "profile",
    "request_id": "req_3f8a1c9e",
    "credits_charged": 1,
    "credits_remaining": 4987,
    "ms": 412
  }
}

{
  "error": {
    "code": "missing_parameter",
    "message": "Missing required parameter \"handle\".",
    "docs": "/docs/profile"
  },
  "meta": {
    "request_id": "req_3f8a1c9e"
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "This API key is invalid or has been revoked.",
    "docs": "/docs#authentication"
  },
  "meta": {
    "request_id": "req_3f8a1c9e"
  }
}

{
  "error": {
    "code": "insufficient_credits",
    "message": "You're out of credits. Top up to continue.",
    "docs": "/dashboard/billing"
  },
  "meta": {
    "request_id": "req_3f8a1c9e"
  }
}

{
  "error": {
    "code": "not_found",
    "message": "No public data for that request (private, deleted, or nonexistent). This is a billed request. We queried Instagram on your behalf.",
    "docs": "/docs/profile"
  },
  "meta": {
    "request_id": "req_3f8a1c9e",
    "endpoint": "profile",
    "credits_charged": 1,
    "credits_remaining": 4985
  }
}

{
  "error": {
    "code": "upstream_error",
    "message": "Upstream data provider error. You were not charged. Please retry.",
    "docs": "/docs/profile"
  },
  "meta": {
    "request_id": "req_3f8a1c9e"
  }
}

Response fields

Fields returned under data on a 200 response. Every response also includes a meta object with billing info.

Field	Type	Description
id	string	Numeric account id (stable even if the username changes).
username	string	The account's @handle.
full_name	string	Display name shown on the profile.
biography	string	The profile's bio text.
is_verified	boolean	Whether the account has a verified badge.
is_private	boolean	Whether the account is private.
is_business	boolean	Whether this is a business/professional account.
category	null	Business category label when set (e.g. "Sportswear"); null otherwise.
followers	number	Number of accounts following this account.
following	number	Number of accounts this account follows.
posts	number	Total number of posts on the profile.
external_url	string	The clickable link in the bio, if any.
profile_pic_url	string	URL of the account's profile picture.
public_email	null	Public contact email, if the account exposes one; null otherwise.
public_phone_number	null	Public contact phone number, if exposed; null otherwise.