> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scraperize.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Profile
> Fetches a public Instagram profile by username and returns it as clean JSON: user id, handle, full name, bio, profile picture, verified/private/memorialized flags, follower, following and post counts, bio links (title, URL, pinned), the linked Facebook Page, the Threads username, pronouns, whether the account has an active story (and when it was posted), whether it posts Reels, and its story highlights (id, title, cover, link). Also returns related accounts — the "Accounts you might like" Instagram suggests for the profile (id, handle, name, verified, picture). Posts are not included. Private accounts return their public profile header. Only publicly available data is returned.
**Cost: 1 credit** per successful request. Errors and cache hits (`cache_max_age`) are free.
Paste this into ChatGPT, Claude or your coding assistant to generate working code for this endpoint (use the copy button).
```text Prompt
I want to make an API call to /v1/instagram/profile. Here are the details:
Endpoint: GET https://api.scraperize.com/v1/instagram/profile
Description: Fetches a public Instagram profile by username and returns it as clean JSON: user id, handle, full name, bio, profile picture, verified/private/memorialized flags, follower, following and post counts, bio links (title, URL, pinned), the linked Facebook Page, the Threads username, pronouns, whether the account has an active story (and when it was posted), whether it posts Reels, and its story highlights (id, title, cover, link). Also returns related accounts — the "Accounts you might like" Instagram suggests for the profile (id, handle, name, verified, picture). Posts are not included. Private accounts return their public profile header. Only publicly available data is returned.
Required Headers:
- x-api-key: Your API key
Parameters:
- handle (string) [required]: The Instagram username, e.g. `natgeo` (an `@handle` or profile URL also works).
- cache_max_age (select): Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh.
Example Response:
{
"data": {
"profile": {
"id": "787132",
"graphId": "17841400573960012",
"handle": "natgeo",
"fullName": "National Geographic",
"url": "https://www.instagram.com/natgeo/",
"biography": "Step into wonder and find your inner explorer with National Geographic 🌎",
"profilePicUrl": "https://scontent-los4-1.cdninstagram.com/v/t51.82787-19/683576066_18653628823019133_9051036240972105113_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid…",
"isPrivate": false,
"isVerified": true,
"isMemorialized": false,
"followerCount": 268418091,
"followingCount": 194,
"postCount": 32000,
"postCountApproximate": true,
"hasActiveStory": true,
"latestStoryAt": "2026-10-07T19:05:44.000Z",
"hasReels": true,
"threadsHandle": "natgeo",
"pronouns": [],
"bioLinks": [
{
"id": "17954981494900183",
"title": null,
"url": "http://visitstore.bio/natgeo",
"type": "external",
"isPinned": false,
"imageUrl": null
}
],
"linkedFacebookPage": null,
"highlights": [],
"highlightsHasMore": false
},
"relatedAccounts": [
{
"id": "378353537",
"handle": "animalplanet",
"fullName": "Animal Planet",
"isVerified": true,
"profilePicUrl": "https://scontent-los4-1.cdninstagram.com/v/t51.2885-19/471307838_1123917355849999_3742640417869698375_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=105&ccb=7-5&_nc_sid…",
"url": "https://www.instagram.com/animalplanet/"
}
],
"fetchedAt": "2026-10-08T10:49:03.664Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}
Please help me write code in my preferred programming language to make this API call and handle the response appropriately. Include error handling and best practices.
```
## OpenAPI
````yaml /api-reference/openapi.json get /v1/instagram/profile
openapi: 3.0.3
info:
title: Scraperize API
version: 1.0.0
description: >-
Extract public data from social media platforms as clean JSON. Endpoints are
split by platform and by what they return, e.g. `GET /v1/twitter/tweet`.
## Authentication
Send your API key in the `x-api-key` header (or `Authorization: Bearer
`). Create keys in your dashboard.
## Credits
Each successful live scrape costs **1 credit**. Credits are prepaid and
never expire.
## Caching
Every endpoint accepts an optional `cache_max_age`
(`1d`|`3d`|`7d`|`14d`|`30d`). A cache hit within that window is returned for
**0 credits**.
## Responses
Success returns `{ "data": …, "meta": { "requestId", … } }`. Errors return
`{ "error": { "code", "message", "requestId" } }` with a matching HTTP
status. `meta` on a scrape carries `creditsCharged`, `creditsRemaining`,
`cached`, and (on a hit) `cachedAt`.
## Rate limits
Requests are limited per team per minute; over the limit returns `429` with
a `Retry-After` header.
servers:
- url: https://api.scraperize.com
description: Production
security:
- ApiKeyAuth: []
tags:
- name: Twitter
description: Twitter / X scraping endpoints
- name: Facebook
description: Facebook scraping endpoints
- name: Linkme
description: Linkme (link.me) scraping endpoints
- name: Amazon
description: Amazon (creator shop / storefront) scraping endpoints
- name: Linkbio
description: Linkbio (lnk.bio) scraping endpoints
- name: Pillar
description: Pillar (pillar.io) scraping endpoints
- name: Komi
description: Komi (komi.io) scraping endpoints
- name: Linktree
description: Linktree (linktr.ee) scraping endpoints
- name: Kick
description: Kick (kick.com) scraping endpoints
- name: Snapchat
description: Snapchat (snapchat.com) scraping endpoints
- name: Telegram
description: Telegram (t.me) scraping endpoints
- name: LinkedIn
description: LinkedIn scraping endpoints
- name: Twitch
description: Twitch scraping endpoints
- name: TikTok
description: TikTok (tiktok.com) scraping endpoints
- name: Instagram
description: Instagram scraping endpoints
- name: Lagos Life
description: Lagos Life scraping endpoints
paths:
/v1/instagram/profile:
get:
tags:
- Instagram
summary: Profile
description: >-
Fetches a public Instagram profile by username and returns it as clean
JSON: user id, handle, full name, bio, profile picture,
verified/private/memorialized flags, follower, following and post
counts, bio links (title, URL, pinned), the linked Facebook Page, the
Threads username, pronouns, whether the account has an active story (and
when it was posted), whether it posts Reels, and its story highlights
(id, title, cover, link). Also returns related accounts — the "Accounts
you might like" Instagram suggests for the profile (id, handle, name,
verified, picture). Posts are not included. Private accounts return
their public profile header. Only publicly available data is returned.
parameters:
- name: handle
in: query
required: true
description: >-
The Instagram username, e.g. `natgeo` (an `@handle` or profile URL
also works).
schema:
type: string
example: natgeo
- name: cache_max_age
in: query
required: false
description: >-
Optional. Return a cached result if one this age or newer exists —
served for **0 credits** with `meta.cached=true` and
`meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and
refreshes the cache. Omit to always scrape fresh.
schema:
type: string
enum:
- 1d
- 3d
- 7d
- 14d
- 30d
example: 7d
responses:
'200':
description: The profile and its related accounts.
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
profile:
type: object
nullable: true
relatedAccounts:
type: array
items:
type: object
fetchedAt:
type: string
format: date-time
meta:
type: object
description: >-
requestId + credit/caching metadata (creditsCharged,
creditsRemaining, cached, cachedAt).
required:
- data
- meta
example:
data:
profile:
id: '787132'
graphId: '17841400573960012'
handle: natgeo
fullName: National Geographic
url: https://www.instagram.com/natgeo/
biography: >-
Step into wonder and find your inner explorer with
National Geographic 🌎
profilePicUrl: >-
https://scontent-los4-1.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=_fdjK6hwb-cQ7kNvwFno_o6&_nc_oc=Adp9N-1OKYdD9OEe2jVCqN9WkB4jO-7bqT5KzBLLG2vHHSuvCIzoQab0X8tjF0Fwna4&_nc_zt=24&_nc_ht=scontent-los4-1.cdninstagram.com&_nc_gid=Y8NLSpS0SPGj4fZkIDjIIg&_nc_ss=7b689&oh=00_AQObVWgxLJopdnN8ycZfmoctB7ZWXXOLtj7qSiSYDaV0Zw&oe=6ACD31EB
isPrivate: false
isVerified: true
isMemorialized: false
followerCount: 268418091
followingCount: 194
postCount: 32000
postCountApproximate: true
hasActiveStory: true
latestStoryAt: '2026-10-07T19:05:44.000Z'
hasReels: true
threadsHandle: natgeo
pronouns: []
bioLinks:
- id: '17954981494900183'
title: null
url: http://visitstore.bio/natgeo
type: external
isPinned: false
imageUrl: null
- id: '17908403766429128'
title: Subscribe Here!
url: >-
https://ngmdomsubs.nationalgeographic.com/servlet/OrdersGateway?cds_mag_code=NGM&cds_page_id=283562&cds_response_key=I5FX10002
type: external
isPinned: false
imageUrl: null
linkedFacebookPage: null
highlights: []
highlightsHasMore: false
relatedAccounts:
- id: '378353537'
handle: animalplanet
fullName: Animal Planet
isVerified: true
profilePicUrl: >-
https://scontent-los4-1.cdninstagram.com/v/t51.2885-19/471307838_1123917355849999_3742640417869698375_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=105&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy44MDAuQzMifQ%3D%3D&_nc_ohc=pSOcFIKPpAgQ7kNvwHOM-AA&_nc_oc=AdrAirfndqXHbiyffnSrQO_7_H4TUMR-6pri9X09u8ozJMWgxDwz94jL9DyzrkZ8t2Y&_nc_zt=24&_nc_ht=scontent-los4-1.cdninstagram.com&_nc_ss=7b689&oh=00_AQOowkFIsM5KTKQa5ekpQ_gTAOqQK-DGQORttOto_O6Q0A&oe=6ACD5543
url: https://www.instagram.com/animalplanet/
- id: '8338677473'
handle: discover.magazine
fullName: Discover Magazine
isVerified: true
profilePicUrl: >-
https://scontent-los4-1.cdninstagram.com/v/t51.2885-19/354392035_272653778626874_1385606066663280881_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=108&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=EkBFXeSPg74Q7kNvwHYJx3c&_nc_oc=Adq-Ge6NBRd_inra3Ky9ik9EoB15WmbAqFRVojDQ8eaUeeUfuVl737Sj9cEJP8suZPM&_nc_zt=24&_nc_ht=scontent-los4-1.cdninstagram.com&_nc_ss=7b689&oh=00_AQNMfHY6O_1Pan1_0uHVbGebfBle-elSkL7cuHpBKFealA&oe=6ACD398A
url: https://www.instagram.com/discover.magazine/
- id: '289756973'
handle: pbsnature
fullName: Nature
isVerified: true
profilePicUrl: >-
https://scontent-los4-1.cdninstagram.com/v/t51.2885-19/18380357_1952944324924536_7971533827648520192_a.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=111&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy40MDAuQzMifQ%3D%3D&_nc_ohc=X3QwcYjCNcAQ7kNvwGpJj4t&_nc_oc=AdrEPOZKFrPL0BWnIyR2z-oYlten004QAUgPgF70KNswCMTpZqvuIs6eJg3f5Teo1eg&_nc_zt=24&_nc_ht=scontent-los4-1.cdninstagram.com&_nc_ss=7b689&oh=00_AQPRUwgRy7k3sYCdWw0Dit_ZhzsGMZSAOnaMkN3MnrtVCQ&oe=6ACD4FBC
url: https://www.instagram.com/pbsnature/
fetchedAt: '2026-10-08T10:49:03.664Z'
meta:
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
creditsCharged: 1
creditsRemaining: 4999
cached: false
'401':
description: Missing, invalid, or revoked API key.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: UNAUTHORIZED
message: API key required — pass it in the `x-api-key` header.
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
'402':
description: Not enough credits for this request.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: INSUFFICIENT_CREDITS
message: >-
This request costs 1 credit, but your balance is 0. Top up
to continue.
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
'404':
description: No Instagram profile found for that handle.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: NOT_FOUND
message: >-
The requested content was not found (it may not exist, be
deleted, or be private).
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
'422':
description: Invalid query parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: VALIDATION_ERROR
message: Request validation failed
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
details:
- path: url
message: Required
'429':
description: Over the per-minute rate limit — honour `Retry-After`.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: RATE_LIMITED
message: >-
Rate limit exceeded — max 100 requests per 60s. Retry in
~30s.
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
'503':
description: >-
Temporarily unavailable — retry after `Retry-After`. `error.code`
tells you why: `UPSTREAM_BLOCKED` (the source blocked this request),
`EXTRACTION_FAILED` (the source returned unexpected data),
`PLATFORM_UNAVAILABLE` (the source is down), or
`SERVICE_UNAVAILABLE` (we are at capacity).
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error:
code: UPSTREAM_BLOCKED
message: >-
The source is temporarily unavailable. Please try again
shortly.
requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
components:
schemas:
Error:
type: object
properties:
error:
type: object
properties:
code:
type: string
example: NOT_FOUND
message:
type: string
example: The requested content was not found.
requestId:
type: string
example: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
details:
type: array
items:
type: object
description: Present on validation errors.
required:
- code
- message
- requestId
required:
- error
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: >-
Your API key. Send it in the `x-api-key` header (or `Authorization:
Bearer `). Create and manage keys from your dashboard.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.