Instagram Profile Data API

Get Instagram Profile Data in One API Call

Pass a username, get back a complete profile object. GramScraper's profile endpoint returns structured JSON with all publicly available profile fields.

Code Examples

# Get profile data for any Instagram user
curl -H 'Authorization: Bearer gs_your_api_key' \
  'https://gramscraper.com/api/instagram/v1/user/by/username?username=natgeo'

import requests

url = "https://gramscraper.com/api/instagram/v1/user/by/username"
headers = {"Authorization": "Bearer gs_your_api_key"}
params = {"username": "natgeo"}

response = requests.get(url, headers=headers, params=params)
profile = response.json()

print(f"Name: {profile['full_name']}")
print(f"Bio: {profile['biography']}")
print(f"Followers: {profile['follower_count']:,}")
print(f"Posts: {profile['media_count']:,}")
print(f"Verified: {profile['is_verified']}")

const response = await fetch(
  'https://gramscraper.com/api/instagram/v1/user/by/username?username=natgeo',
  { headers: { 'Authorization': 'Bearer gs_your_api_key' } }
);

const profile = await response.json();
console.log(`Name: ${profile.full_name}`);
console.log(`Followers: ${profile.follower_count.toLocaleString()}`);
console.log(`Verified: ${profile.is_verified}`);

Example API Response

Here's what the profile endpoint returns:

{
  "username": "natgeo",
  "full_name": "National Geographic",
  "biography": "Experience the world through the eyes of...",
  "follower_count": 284000000,
  "following_count": 189,
  "media_count": 29400,
  "is_verified": true,
  "is_private": false,
  "profile_pic_url": "https://...",
  "external_url": "https://natgeo.com",
  "category": "Media/News Company"
}

Profile Fields Returned

Use Cases

• Build influencer analytics dashboards
• Monitor competitor Instagram accounts
• Verify influencer follower counts for brand campaigns
• Power lead generation tools with profile data
• Create social media monitoring and reporting tools

Frequently Asked Questions

How do I get Instagram profile data via API?

Use GramScraper's /v1/user/by/username endpoint. Pass an Instagram username as a query parameter and receive a JSON response with the profile's bio, follower count, post count, profile picture URL, verification status, and more.

What profile fields does the API return?

The API returns public profile data including username, full name, biography, follower count, following count, media count, profile picture URL, whether the account is verified, and whether the account is private.

Can I get profile data for any Instagram user?

The API returns publicly available profile data. For public accounts, you get the full profile overview. Private accounts return limited data that Instagram shows publicly (username, profile picture, follower/following counts).