Create Your Free Account

Get Your API Key

After signing in, go to your Dashboard and click "Generate API Key". Your key looks like gs_xxxxxxxxxxxxxxxx. Copy it — you'll use it in the next step.

Make Your First API Call

Fetch any public Instagram profile by username. Replace gs_your_api_key with your actual key:

curl -H "Authorization: Bearer gs_your_api_key" \
  "https://gramscraper.com/api/instagram/v1/user/by/username?username=instagram"

import requests

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

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

print(data["username"], "-", data["follower_count"], "followers")

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

const data = await response.json();
console.log(data.username, "-", data.follower_count, "followers");

See the Response

You'll get a JSON response with the profile's public data. Here's what it looks like:

Sample Response

{
  "username": "instagram",
  "full_name": "Instagram",
  "biography": "Bringing you closer to the people and things you love.",
  "follower_count": 676000000,
  "following_count": 76,
  "media_count": 7892,
  "is_verified": true,
  "is_private": false,
  "profile_pic_url": "https://...",
  "external_url": "https://about.instagram.com",
  "category": "Product/service"
}

Each profile lookup costs 1 credit. You start with 100 free credits.