---
title: "Get account metrics"
method: GET
path: "/v1/social-accounts/{id}/metrics"
tags: ["Social Accounts"]
---

# Get account metrics

`GET /v1/social-accounts/{id}/metrics`

## Request

- Base URL: `https://api.outstand.so`
- URL: `https://api.outstand.so/v1/social-accounts/{id}/metrics`
- Auth: none declared

Fetch analytics and metrics for a connected social account. Returns follower counts, engagement metrics, and platform-specific statistics.

**Supported Metrics by Platform:**
- **Instagram:** followers, following, media count, engagement (views, likes, comments, shares, saves, reach, accounts_engaged, total_interactions), and `follower_growth` (followers_gained, followers_lost, net_follower_change, daily_new_followers) - requires Business/Creator account with `instagram_business_manage_insights` permission (supports date range). Instagram omits follower growth for accounts with fewer than 100 followers; those fields are null and listed in `follower_growth.unavailable_fields`
- **Facebook:** page followers/fans, engagement (impressions, reach, post_engagements) - requires `pages_read_engagement` and `read_insights`, supports date range. Since Meta's June 2026 deprecation, impressions and reach are derived from media views and read lower than the retired impression metrics; metrics Meta did not return are listed in `platform_specific.insights_unavailable`
- **Threads:** followers, engagement (views, likes, replies, reposts, quotes) - supports date range
- **LinkedIn:** followers (personal & organization), engagement for organizations (likes, comments, shares, clicks, impressions, engagement_rate) - requires `rw_organization_admin` permission, supports date range
- **TikTok:** followers, following, total likes, video count - current snapshot only, no date range support
- **YouTube:** subscribers, total views, video count - lifetime statistics only, no date range support
- **X (Twitter):** followers, following, tweet count (current snapshot), plus engagement (views, likes, comments, shares, quotes) aggregated from up to 500 of the account's own tweets posted within the date range. Aggregation is best-effort and may be unavailable under X API rate limits or tier restrictions. **Cost note:** this reads posts from your connected X app and counts against your X API quota / pay-per-use cost (~$0.005 per post read); a busy account can cost up to ~$2.50 per call. Date range supported.
- **BlueSky:** followers, following, posts count - current snapshot only (Bluesky exposes no time-series analytics, so the date range is ignored). No engagement metrics.
- **Pinterest:** followers, following, pin count (`posts_count` includes both created and saved pins, per Pinterest's API), engagement (views/impressions, saves, pin_clicks, outbound_clicks); full daily analytics available under `platform_specific`. Date range supported.

**Date Range:** Use `since` and `until` query parameters for platforms that support historical data. Defaults to last 30 days.

## Path parameters

- `id` string, required

## Query parameters

- `since` number
- `until` number

## Response `200`

Account metrics retrieved successfully

- object: Account metrics response
  - `success` boolean, required
  - `data` object, required: Account metrics data
    - `account_id` string, required
    - `network` string, required
    - `followers_count` number, nullable, required
    - `following_count` number, nullable, required
    - `posts_count` number, nullable, required
    - `engagement` object, nullable, required: Engagement metrics for the date range. Fields vary by platform.
      - `views` number, nullable
      - `likes` number, nullable
      - `comments` number, nullable
      - `shares` number, nullable
      - `saves` number, nullable
      - `reposts` number, nullable
      - `quotes` number, nullable
      - `reach` number, nullable
      - `accounts_engaged` number, nullable
      - `total_interactions` number, nullable
      - `replies` number, nullable: Instagram: account-level story replies
      - `profile_links_taps` number, nullable
    - `stories` object, nullable: Instagram: engagement attributable to Stories over the date range (media_product_type=STORY breakdown)
      - `views` number, nullable
      - `reach` number, nullable
      - `total_interactions` number, nullable
      - `replies` number, nullable
    - `follower_growth` object, nullable: Instagram: follower growth over the date range. Instagram does not report it for accounts with fewer than 100 followers; those fields are null and named in unavailable_fields. Data can lag up to 48 hours.
      - `followers_gained` number, nullable, required: Accounts that followed during the date range
      - `followers_lost` number, nullable, required: Accounts that unfollowed during the date range
      - `net_follower_change` number, nullable, required: followers_gained minus followers_lost
      - `daily_new_followers` object[], nullable, required: New followers per day over the date range (Instagram follower_count, period=day)
        - `end_time` string, required
        - `value` number, required
      - `unavailable_fields` string[], required: Fields Instagram did not report and that are therefore null
    - `platform_specific` object, required: Raw platform-specific data from the API
    - `period` object, required: Date range for the metrics
      - `since` number, required
      - `until` number, required
      - `note` string
    - `fetched_at` string, required

## Other responses

- `400`: Validation Error
- `404`: Social account not found
- `500`: Internal server error

---

[API](https://skmtc.dev/outstand/apis/outstand-social-accounts-api-v1.md) · [All operations](https://skmtc.dev/outstand/apis/outstand-social-accounts-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/outstand/apis/outstand-social-accounts-api-v1/revisions/181fad55d031?raw)