---
title: "Follower history for a connected account"
method: GET
path: "/v1/accounts/{accountId}/followers"
tags: ["Accounts", "Analytics"]
---

# Follower history for a connected account

`GET /v1/accounts/{accountId}/followers`

## Request

- Base URL: `https://www.postquick.ai/api`
- URL: `https://www.postquick.ai/api/v1/accounts/{accountId}/followers`
- Auth: HTTP bearer

Returns the daily follower-count history for a connected social account, plus the most recent snapshot. History is populated by a daily cron. Useful for tracking growth over time without scraping public profile pages.

## Path parameters

- `accountId` string, required: Social account ID

## Query parameters

- `days` string: How many days of history to return. Default 30, clamped to [1, 365].

## Response `200`

Follower history.

- object
  - `success` true, required
  - `data` object, required
    - `accountId` string, required
    - `platform` string, required
    - `followerCount` number, nullable, required
    - `followingCount` number, nullable, required
    - `followersFetchedAt` string, date-time, nullable, required
    - `history` object[], required
      - `captured_date` string, required: ISO date (YYYY-MM-DD) of the snapshot
      - `follower_count` number, nullable, required
      - `following_count` number, nullable, required

## Other responses

- `404`: Account not found.

---

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