# Social Analytics Accounts

> Follower counts, growth and daily follower history per connected account

- **URL**: https://orshot.com/docs/api-reference/social-analytics-accounts

---

## Overview

Returns audience stats for every connected social account: current follower count, following and media counts where the platform reports them, growth over the window, and a per-date follower history series.

This is the data behind the follower growth chart and the account rows in your dashboard.

```markdown tab="Endpoint"
https://api.orshot.com/v1/social/analytics/accounts
```

## Request

**Request**
```js
await fetch(
  "https://api.orshot.com/v1/social/analytics/accounts?from=2026-07-14",
  {
    method: "GET",
    headers: {
      Authorization: "Bearer <ORSHOT_API_KEY>",
    },
  },
);
```

**Response**
```json
{
  "data": {
    "accounts": [
      {
        "account_id": 15,
        "platform": "linkedin",
        "username": "acme-inc",
        "avatar": "https://media.licdn.com/...",
        "follower_count": 930,
        "following_count": null,
        "media_count": null,
        "growth_percentage": 38.8,
        "history": [
          { "date": "2026-08-12", "followers": 927 },
          { "date": "2026-08-13", "followers": 930 }
        ]
      }
    ]
  }
}
```

`avatar` is a fresh URL from the platform. Prefer it over any stored copy, since platform CDN links expire. Fields a platform does not report (for example, `following_count` on LinkedIn pages) come back as `null`.

## Query Parameters

| Parameter | Type   | Required | Description                                                            |
| --------- | ------ | -------- | ---------------------------------------------------------------------- |
| `from`    | String | No       | Start of the history window, `YYYY-MM-DD`                              |
| `to`      | String | No       | End of the history window, `YYYY-MM-DD`                                |
| `refresh` | String | No       | Pass `1` to bypass the cache and pull fresh numbers from the platforms |

## Error Responses

Same as the [analytics overview endpoint](https://orshot.com/docs/api-reference/social-analytics-list): `403` with code `analytics_not_enabled`, and `429` with a `Retry-After` header when the 10 requests per minute analytics budget is exhausted.