---
title: "Get Profile Stats"
method: GET
path: "/instagram/profile-stats"
tags: ["instagram"]
---

# Get Profile Stats

`GET /instagram/profile-stats`

## Request

- Base URL: `https://api.reeldrop.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.reeldrop.io/instagram/profile-stats`
- Auth: HTTP bearer

The connected account's public profile fields and follower/post counts.

Deliberately separate from GET /connection, which several screens call on
every load and must stay cheap — this one hits the Graph API. Counts drift and
accounts connected before they were stored have none, so it fetches live and
refreshes the row; when the call fails (revoked token, Meta outage) it degrades
to whatever was stored rather than erroring, and the caller renders no counts.

## Query parameters

- `workspace_id` string, nullable: Workspace this request applies to. Defaults to the caller's personal workspace. Must be one the caller belongs to.

## Response `200`

Successful Response

- IgProfileStatsResponse
  - `connected` boolean, required
  - `username` string
  - `display_name` string
  - `avatar_url` string
  - `followers_count` integer, nullable
  - `follows_count` integer, nullable
  - `media_count` integer, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/reeldrop/apis/reeldrop-api.md) · [All operations](https://skmtc.dev/reeldrop/apis/reeldrop-api/llms.txt) · [OpenAPI document](https://skmtc.dev/reeldrop/apis/reeldrop-api/revisions/d3b2a338556c?raw)