GETProfiles2 credits

Account age & country

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

Exposes Instagram's "About this account" transparency panel together with the full public profile in one call: the month and year the account was created (plus its age in years), the country the account was registered in (which can differ from where the person currently lives), whether it has ever changed its username — with the former usernames listed — and its verified badge. Instagram only reveals creation dates at month granularity, so no exact day is available. Works on private accounts too. Built for fraud & trust checks, influencer vetting, and account-marketplace due diligence. Cost: 2 credits, flat, regardless of account size.

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/about?handle=nike" \
  -H "Authorization: Bearer $INSTAGRAMAPI_KEY"

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

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

Try it

Live request · uses 2 credits

API key

handle *string

Example responses

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

{
  "data": {
    "username": "natgeo",
    "account_created": "November 2010",
    "account_created_year": 2010,
    "account_created_month": 11,
    "account_age_years": 15.7,
    "country_of_registration": "United States",
    "has_changed_username": false,
    "former_usernames": [],
    "is_verified": true,
    "profile": {
      "id": "787132",
      "full_name": "National Geographic",
      "biography": "Inspiring the explorer in everyone 🌎",
      "is_private": false,
      "is_business": true,
      "category": "Publisher",
      "followers": 279441024,
      "following": 135,
      "posts": 30542,
      "external_url": "https://on.natgeo.com/instagram",
      "profile_pic_url": "https://instagram.com/.../natgeo.jpg"
    }
  },
  "meta": {
    "endpoint": "profile/about",
    "request_id": "req_3f8a1c9e",
    "credits_charged": 2,
    "credits_remaining": 4987,
    "ms": 412
  }
}

{
  "error": {
    "code": "missing_parameter",
    "message": "Missing required parameter \"handle\".",
    "docs": "/docs/profile/about"
  },
  "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/about"
  },
  "meta": {
    "request_id": "req_3f8a1c9e",
    "endpoint": "profile/about",
    "credits_charged": 2,
    "credits_remaining": 4985
  }
}

{
  "error": {
    "code": "upstream_error",
    "message": "Upstream data provider error. You were not charged. Please retry.",
    "docs": "/docs/profile/about"
  },
  "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
username	string	The account's current @handle.
account_created	string	When the account was created, as Instagram reports it (month + year, e.g. "November 2010"). Instagram never exposes the exact day.
account_created_year	number	Creation year, parsed as a number.
account_created_month	number	Creation month (1–12); null when Instagram only reports a year.
account_age_years	number	Account age in years (one decimal), computed from the creation month/year.
country_of_registration	string	The country the account was registered in, per Instagram's transparency data. This is where the account was created — NOT necessarily where the person lives now; null when Instagram doesn't disclose it.
has_changed_username	boolean	True if the account has ever changed its username — a strong signal for impersonation and resold-account checks.
former_usernames	array<unknown>	Usernames the account previously used; empty when it has never changed.
is_verified	boolean	Whether the account has a verified badge.
profile	object	The full public profile, included at no extra cost (we fetch it to resolve the account).
profile.id	string	Numeric account id (stable even if the username changes).
profile.full_name	string	Display name shown on the profile.
profile.biography	string	The profile's bio text.
profile.is_private	boolean	Whether the account is private. The About panel still works on private accounts.
profile.is_business	boolean	Whether this is a business/professional account.
profile.category	string	Business category label when set; null otherwise.
profile.followers	number	Number of accounts following this account.
profile.following	number	Number of accounts this account follows.
profile.posts	number	Total number of posts on the profile.
profile.external_url	string	The clickable link in the bio, if any.
profile.profile_pic_url	string	URL of the account's profile picture.