Social Analytics Accounts

Follower counts, growth and daily follower history per connected account

Published Aug 13, 2026

GET

/v1/social/analytics/accounts

curl -X GET "https://api.orshot.com/v1/social/analytics/accounts?from=<FROM>&to=<TO>&refresh=<REFRESH>" \
  -H "Authorization: Bearer <ORSHOT_API_KEY>"

const res = await fetch("https://api.orshot.com/v1/social/analytics/accounts?from=<FROM>&to=<TO>&refresh=<REFRESH>", {
  method: "GET",
  headers: {
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
});

const data = await res.json();

import requests

response = requests.get(
    "https://api.orshot.com/v1/social/analytics/accounts?from=<FROM>&to=<TO>&refresh=<REFRESH>",
    headers={"Authorization": "Bearer <ORSHOT_API_KEY>"},
)

data = response.json()

$ch = curl_init("https://api.orshot.com/v1/social/analytics/accounts?from=<FROM>&to=<TO>&refresh=<REFRESH>");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer <ORSHOT_API_KEY>",
]);

$data = json_decode(curl_exec($ch), true);
curl_close($ch);

require "net/http"
require "json"

uri = URI("https://api.orshot.com/v1/social/analytics/accounts?from=<FROM>&to=<TO>&refresh=<REFRESH>")
req = Net::HTTP::Get.new(uri)
req["Authorization"] = "Bearer <ORSHOT_API_KEY>"

res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(req) }
data = JSON.parse(res.body)

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.

Endpoint

https://api.orshot.com/v1/social/analytics/accounts

Request#

JavaScript

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

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: 403 with code analytics_not_enabled, and 429 with a Retry-After header when the 10 requests per minute analytics budget is exhausted.

Was this page helpful?

Ready to automate?

Start rendering images, PDFs and videos from your templates in under 2 minutes. Free plan, no credit card.

Get your API key

Image, PDF and video generation via API
Visual editor with AI and smart layouts
Zapier, Make, MCP and 50+ integrations
White-label embed for your own app
30 free credits — no credit card required