# Social Blade API: Get Instagram account stats

> Looks up public Instagram account totals, engagement and grade on Social Blade by handle or profile link. Daily history and 30-day follower change need a Social Blade sign-in, so they are not returned.

Unofficial. Not affiliated with or endorsed by Social Blade.

- Page: https://fous.com/methods/socialblade.com/get-instagram-stats
- Method: `socialblade.com/get_instagram_stats`, version 1
- Website: socialblade.com
- Returns: username, display name, grade, followers, following, posts, engagement and average likes/comments
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `username` | string | yes | `"https://www.instagram.com/cristiano/"` | Instagram handle or profile link, for example @natgeo or https://www.instagram.com/natgeo/. |

## Output

From a run on Oct 23, 2026. Its input:

```json
{
  "username": "https://www.instagram.com/cristiano/"
}
```

Its output:

```json
{
  "grade": "A+",
  "posts": 4146,
  "username": "cristiano",
  "followers": 679836142,
  "following": 638,
  "daily_stats": [],
  "display_name": "Cristiano Ronaldo",
  "social_blade_link": "https://socialblade.com/instagram/user/cristiano",
  "average_likes_per_post": 7252948.75,
  "engagement_rate_percent": 1.09,
  "average_comments_per_post": 142851.5625,
  "follower_change_last_30_days": null
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"socialblade.com/get_instagram_stats","input":{"username":"https://www.instagram.com/cristiano/"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What's the current follower count and engagement rate for the Instagram account @natgeo?
- Can you pull the grade and average likes per post for https://www.instagram.com/nasa/?
- How many followers and posts does the public Instagram profile @bbcnews have right now?
- Check the engagement and average comments on the Instagram handle @chefsteps on Social Blade.
- Give me the display name, following count, and overall grade for the Instagram account @garyvee.

## Input schema

```json
{
  "type": "object",
  "required": [
    "username"
  ],
  "properties": {
    "username": {
      "type": "string",
      "description": "Instagram handle or profile link, for example @natgeo or https://www.instagram.com/natgeo/."
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "username",
    "display_name",
    "grade",
    "followers",
    "following",
    "posts",
    "engagement_rate_percent",
    "average_likes_per_post",
    "average_comments_per_post",
    "follower_change_last_30_days",
    "daily_stats",
    "social_blade_link"
  ],
  "properties": {
    "grade": {
      "type": [
        "string",
        "null"
      ],
      "description": "Social Blade grade, when shown."
    },
    "posts": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Current posts (media) count."
    },
    "username": {
      "type": "string",
      "description": "Instagram handle without @."
    },
    "followers": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Current followers."
    },
    "following": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Current following count."
    },
    "daily_stats": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "date",
          "followers",
          "following",
          "posts"
        ],
        "properties": {
          "date": {
            "type": "string",
            "format": "date"
          },
          "posts": {
            "type": [
              "integer",
              "null"
            ]
          },
          "followers": {
            "type": [
              "integer",
              "null"
            ]
          },
          "following": {
            "type": [
              "integer",
              "null"
            ]
          }
        },
        "additionalProperties": false
      },
      "description": "Up to 14 daily records; empty when public history is restricted."
    },
    "display_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "Account display name."
    },
    "social_blade_link": {
      "type": "string",
      "description": "Social Blade account page link."
    },
    "average_likes_per_post": {
      "type": [
        "number",
        "null"
      ],
      "description": "Average likes per post, when shown."
    },
    "engagement_rate_percent": {
      "type": [
        "number",
        "null"
      ],
      "description": "Engagement rate in percent."
    },
    "average_comments_per_post": {
      "type": [
        "number",
        "null"
      ],
      "description": "Average comments per post, when shown."
    },
    "follower_change_last_30_days": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Follower change over the last 30 days; null when public history is restricted."
    }
  },
  "additionalProperties": false
}
```

## See more

- [Social Blade API: Get TikTok creator stats](https://fous.com/methods/socialblade.com/get-tiktok-stats.md): Gets a TikTok creator's Social Blade profile totals, grade when shown, 30-day follower and like changes, and up to 14 days of daily totals, from a TikTok handle or a TikTok or Social Blade profile link. Counts reflect Social Blade's recorded and sometimes rounded figures.
- [Social Blade API: Get YouTube channel stats](https://fous.com/methods/socialblade.com/get-youtube-channel-stats.md): Looks up a YouTube channel on Social Blade by name, @handle, YouTube link or Social Blade link and returns its profile, 30-day growth, earnings estimates and the last 14 daily statistics.
- [Instagram API: Get engagement stats](https://fous.com/methods/instagram.com/get-engagement-stats-2.md): Gets an Instagram account's follower count plus its posting and engagement over the last 30 days: posts published, average views of its videos and reels, and average likes and comments per post, from a username or profile link.
- [Instagram API: Get profile](https://fous.com/methods/instagram.com/get-profile.md): Gets an Instagram account's public profile from its username, @name or profile link: name, bio, exact follower, following and post counts, verified and private flags, first bio link, profile picture and account ID.
- [Bluesky API: Get profile](https://fous.com/methods/bsky.app/get-profile.md): Looks up a public Bluesky profile by handle or profile link, including bio, audience counts and join date. A bare name first checks its .bsky.social handle, then the top relevant people-search result.
- [TikTok API: Get profile](https://fous.com/methods/tiktok.com/get-profile.md): Gets a TikTok creator's public profile and totals (followers, following, likes, videos) from a username, @handle or profile link. Profiles not visible to public visitors cannot be returned.
- [Instagram API: List recent posts](https://fous.com/methods/instagram.com/list-recent-posts.md): Lists the latest publicly embeddable posts and reels from an Instagram account, newest first. Without login Instagram may show fewer posts than requested. View counts that are not available are null.
- [Mastodon API: Get profile](https://fous.com/methods/mastodon.social/get-profile.md): Gets a public Mastodon profile by handle or profile link, with its bio, counts, dates and profile fields. Major servers are read directly. Other servers are looked up through mastodon.social, and their home-server account ID is not available.
- [All Social Blade methods](https://fous.com/methods/socialblade.com.md)
