Get Instagram Profile

Retrieve public profile information for an Instagram user.

Endpoint

GET /instagram/profile/:username

Parameters

Path Parameters

Parameter	Type	Required	Description
`username`	string	Yes	The Instagram username (without @)

Request

Headers

Header	Required	Description
`Authorization`	Yes	Bearer token with your API key

Example Request

curl -X GET "https://api.your-domain.com/instagram/profile/instagram" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch(
  'https://api.your-domain.com/instagram/profile/instagram',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

const profile = await response.json();

import requests

response = requests.get(
    'https://api.your-domain.com/instagram/profile/instagram',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

profile = response.json()

Response

Success Response

Status Code: 200 OK

Returns the Instagram user profile data including biography, follower counts, and profile information.

{
  "id": "25025320",
  "username": "instagram",
  "full_name": "Instagram",
  "biography": "Bringing you closer to the people and things you love.",
  "profile_pic_url": "https://...",
  "profile_pic_url_hd": "https://...",
  "is_verified": true,
  "is_private": false,
  "edge_followed_by": {
    "count": 674000000
  },
  "edge_follow": {
    "count": 78
  },
  "edge_owner_to_timeline_media": {
    "count": 7845
  }
}

Response Fields

Field	Type	Description
`id`	string	Unique Instagram user ID
`username`	string	Instagram username
`full_name`	string	Display name
`biography`	string	Profile bio text
`profile_pic_url`	string	URL to profile picture
`profile_pic_url_hd`	string	URL to high-resolution profile picture
`is_verified`	boolean	Whether the account is verified
`is_private`	boolean	Whether the account is private
`edge_followed_by.count`	number	Number of followers
`edge_follow.count`	number	Number of accounts followed
`edge_owner_to_timeline_media.count`	number	Number of posts

Error Responses

Status	Description
`400`	Invalid username format
`401`	Invalid or missing API key
`404`	Profile not found
`429`	Rate limit exceeded
`500`	Failed to extract profile data

See Error Handling for detailed error response formats.

Notes

Private Instagram profiles will return limited information. The is_private field will be true for these accounts.

Instagram may temporarily block requests if too many are made in a short period. Implement appropriate retry logic with exponential backoff.

Get Profile