---
title: "Most-followed Instagram accounts, gainers and losers"
method: GET
path: "/v1/top"
tags: ["Top charts"]
---

# Most-followed Instagram accounts, gainers and losers

`GET /v1/top`

## Request

- Base URL: `https://data.fastsocial.co`
- URL: `https://data.fastsocial.co/v1/top`
- Auth: API key in header `X-API-Key`

The same data as fastsocial.co/most-followed-instagram-accounts (Instagram Top Charts): the biggest notable public Instagram accounts ranked by followers, updated daily, with 1, 7 and 30-day follower changes, country, category and projected milestones. Free (0 credits); needs any API key. Data CC BY 4.0: credit FastSocial and link the source.

Cost: **0 credits**.

## Query parameters

- `sort` 'followers' | 'gainers' | 'losers' | 'milestones'
- `window` 1 | 7 | 30
- `country` string
- `category` 'sports' | 'music' | 'film_tv' | 'creators' | 'fashion_beauty' | 'brands' | 'media' | 'public_figures' | 'other'
- `limit` integer
- `offset` integer

## Response `200`

OK

- object
  - `ok` unknown, required
  - `data` TopPage, required
    - `sort` string
    - `window_days` integer
    - `country` string, nullable
    - `category` string, nullable
    - `total` integer
    - `offset` integer
    - `limit` integer
    - `accounts` TopAccount[]
      - `rank` integer
      - `username` string
      - `name` string
      - `followers` integer
      - `change_1d` integer, nullable
      - `change_7d` integer, nullable
      - `change_30d` integer, nullable
      - `country` string, nullable
      - `category` string
      - `is_verified` boolean
      - `engagement_rate` number, nullable
      - `next_milestone` integer, nullable
      - `milestone_projected` string, nullable: YYYY-MM-DD, straight-line projection from the last 30 days
    - `updated_at` string
    - `day` string
    - `tracking_since` string
    - `windows_available` integer[]
    - `source` string
    - `license` string
  - `meta` Meta, required
    - `cache` 'hit' | 'miss' | 'stale'
    - `age_seconds` integer
    - `stale` boolean
    - `credits` integer
    - `credits_remaining` integer, nullable

## Other responses

- `400`: Error
- `401`: Error
- `404`: Error
- `422`: Error
- `429`: Error
- `451`: Error
- `502`: Error
- `503`: Error

---

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