Skip to content
truescrape
Free key

Contents

Site

Instagram Profile API

Open in ChatGPTOpen in ClaudeOpen in Gemini

Public profile for an Instagram account: followers, following, post count, bio, links and business category. Private accounts return their public shell with isPrivate: true rather than an error. That is a real answer. Calls cost 1 credit each. A cache hit is free, and a failed or empty response is never charged.

Try it

Prefilled with the request that produced the example below. No key yet? Get a free key.

Request

GET/v1/instagram/profile
ParameterTypeRequiredDescription
handlestringyesHandle (@nike), or a full instagram.com profile URL

Also accepts cache_max_age (a hit costs 0 credits) and include_raw (returns the untouched upstream payload under raw).

curl
curl "$API/v1/instagram/profile?handle=natgeo&cache_max_age=7d" \
  -H "x-api-key: $KEY"
JavaScript
const query = new URLSearchParams({
  handle: 'natgeo',
  cache_max_age: '7d',
});

const response = await fetch(`${API}/v1/instagram/profile?${query}`, {
  headers: { 'x-api-key': KEY },
});

const body = await response.json();
if (!body.success) throw new Error(body.error.code);

// 1 credit, 0 on a cache hit
console.log(body.data, body.meta.creditsCharged);
Python
import os, httpx

r = httpx.get(
    f"{os.environ['API']}/v1/instagram/profile",
    params={
        "handle": "natgeo",
        "cache_max_age": "7d",
    },
    headers={"x-api-key": os.environ["KEY"]},
    timeout=30,
)

body = r.json()
if not body["success"]:
    raise RuntimeError(body["error"]["code"])

print(body["data"], body["meta"]["creditsCharged"])

Example response

Captured on , with raw removed and lists cut to two items. A live call returns current data.

response
{
  "success": true,
  "data": {
    "platform": "instagram",
    "id": "787132",
    "handle": "natgeo",
    "displayName": "National Geographic",
    "bio": "Step into wonder and find your inner explorer with National Geographic 🌎",
    "avatarUrl": "https://scontent.cdninstagram.com/v/t51.82787-19/683576066_18653628823019133_9051036240972105113_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy40MDAuQzMifQ%3D%3D&_nc_ohc=qG9hbsury8oQ7kNvwEdxFwb&_nc_oc=AdrgDP14N7Ua1iRdPJhI_zmqfehSep5aqdA9eBvkCOj8ZpLJPBMsRqhiwD4A0NGgDPY&_nc_zt=24&_nc_ht=scontent.cdninstagram.com&_nc_gid=iS6h5OY-8DcxSybnyM4L2A&_nc_ss=70a8c&oh=00_AQOlqFoyzD6z02j8ijOqEqUWVt6ptzyPJpe-styE94E2Rw&oe=6ADDE4EB",
    "bannerUrl": null,
    "url": "https://www.instagram.com/natgeo/",
    "verified": true,
    "followerCount": 268324378,
    "followingCount": 195,
    "postCount": 32000,
    "viewCount": null,
    "isPrivate": false,
    "isBusiness": null,
    "category": null,
    "location": null,
    "externalLinks": [
      "http://visitstore.bio/natgeo",
      "https://ngmdomsubs.nationalgeographic.com/servlet/OrdersGateway?cds_mag_code=NGM&cds_page_id=283562&cds_response_key=I5FX10002"
    ],
    "createdAt": null,
    "fetchedAt": "2026-10-21T01:52:29.628Z"
  },
  "meta": {
    "platform": "instagram",
    "endpoint": "instagram.profile",
    "creditsCharged": 1,
    "cached": false,
    "cacheAgeSeconds": null,
    "durationMs": 1890,
    "requestId": "req_g4y0rzg5adpw1sivzo69"
  }
}

Returns

Returns one Creator.

Cost and behaviour

Credits1 per live request, 0 on a cache hit
Cacheableyes: cache_max_age accepts a cached copy
Batchableyes: usable as a target in POST /v1/jobs/batch
Subscribableyes: as often as every 3600 seconds, firing a webhook only on a change

Other Instagram endpoints

All Instagram endpointsThe unified schema