Get the analytics of an account

curl --request GET \
  --url https://app.onlysocial.io/os/api/{workspace}/analytics/accounts/{account} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.onlysocial.io/os/api/{workspace}/analytics/accounts/{account}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.onlysocial.io/os/api/{workspace}/analytics/accounts/{account}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.onlysocial.io/os/api/{workspace}/analytics/accounts/{account}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.onlysocial.io/os/api/{workspace}/analytics/accounts/{account}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.onlysocial.io/os/api/{workspace}/analytics/accounts/{account}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "account": {
    "id": 123,
    "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "username": "<string>",
    "image": "<string>",
    "provider": "instagram",
    "data": {},
    "authorized": true,
    "created_at": "<string>",
    "published_at": "<string>"
  },
  "type": "overview",
  "tabs": [
    "overview",
    "content",
    "insights"
  ],
  "period": {
    "start_date": "2023-12-25",
    "end_date": "2023-12-25",
    "previous_start_date": "2023-12-25",
    "previous_end_date": "2023-12-25"
  },
  "initial_sync": {
    "in_progress": true,
    "progress": 123
  },
  "data": {
    "total_followers": 120,
    "views": {
      "value": 5400,
      "change": 12.5
    },
    "likes": {
      "value": 310,
      "change": -4.2
    },
    "audience": [
      {
        "date": "2026-01-01",
        "value": 118
      },
      {
        "date": "2026-01-02",
        "value": 120
      }
    ]
  }
}

{
  "message": "The date range may span at most 366 days.",
  "errors": {
    "date_to": [
      "The date range may span at most 366 days."
    ]
  }
}

Analytics

Get the analytics of an account

One account’s analytics of one type. The answer’s tabs lists the types the account supports, which depend on the network:

Network	Types
Instagram	overview, engagement, audience, reach, content, hashtags, insights, competitors (competitors needs an account connected through Facebook)
Facebook Page	overview, engagement, video, content, hashtags, insights
Google Business Profile	overview, engagement, content, search_terms, reviews
Threads, Bluesky, Mastodon, LinkedIn Page	overview, engagement, content, hashtags, insights
Pinterest	overview, content, hashtags, insights
TikTok, YouTube	overview, content, insights
LinkedIn profile	overview, engagement

Accounts on other networks (X among them) have no analytics and get a 422. data depends on the network and type. content lists the period’s posts with their metrics, paged (data.pagination) and sortable by a metric; reviews pages too. insights gives the best day, hour, post type and posting frequency, the top post and the engagement trend. While initial_sync.in_progress is true, the account’s first import is still running and the figures are incomplete.

Read-only. Personal access tokens may call it with any workspace role, viewers included.

Required permission: publishing:analytics:read

GET

{workspace}

analytics

accounts

{account}

Get the analytics of an account

curl --request GET \
  --url https://app.onlysocial.io/os/api/{workspace}/analytics/accounts/{account} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.onlysocial.io/os/api/{workspace}/analytics/accounts/{account}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.onlysocial.io/os/api/{workspace}/analytics/accounts/{account}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.onlysocial.io/os/api/{workspace}/analytics/accounts/{account}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.onlysocial.io/os/api/{workspace}/analytics/accounts/{account}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.onlysocial.io/os/api/{workspace}/analytics/accounts/{account}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "account": {
    "id": 123,
    "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "username": "<string>",
    "image": "<string>",
    "provider": "instagram",
    "data": {},
    "authorized": true,
    "created_at": "<string>",
    "published_at": "<string>"
  },
  "type": "overview",
  "tabs": [
    "overview",
    "content",
    "insights"
  ],
  "period": {
    "start_date": "2023-12-25",
    "end_date": "2023-12-25",
    "previous_start_date": "2023-12-25",
    "previous_end_date": "2023-12-25"
  },
  "initial_sync": {
    "in_progress": true,
    "progress": 123
  },
  "data": {
    "total_followers": 120,
    "views": {
      "value": 5400,
      "change": 12.5
    },
    "likes": {
      "value": 310,
      "change": -4.2
    },
    "audience": [
      {
        "date": "2026-01-01",
        "value": 118
      },
      {
        "date": "2026-01-02",
        "value": 120
      }
    ]
  }
}

{
  "message": "The date range may span at most 366 days.",
  "errors": {
    "date_to": [
      "The date range may span at most 366 days."
    ]
  }
}

Authorizations

Authorization

string

header

required

A workspace API key: Authorization: Bearer osk_...

Path Parameters

workspace

string<uuid>

required

Your workspace UUID. Must match the API key's workspace.

account

string<uuid>

required

Account UUID.

Query Parameters

type

enum<string>

default:overview

One of the account's tabs.

Available options:

overview,

engagement,

content,

hashtags,

insights,

audience,

reach,

video,

competitors,

search_terms,

reviews

period

enum<string>

default:this_month

In UTC. Weeks start on Monday. this_week, this_month and this_year run up to today; last_3_months is the three whole months before this one. Ignored when date_from and date_to are both sent.

Available options:

this_week,

last_week,

this_month,

last_month,

last_3_months,

this_year

date_from

string<date>

Start of a custom range (UTC day). Send with date_to.

Example:

"2026-01-01"

date_to

string<date>

End of a custom range, on or after date_from. A range spans at most 366 days, both ends included.

Example:

"2026-01-31"

page

integer

default:1

content and reviews only.

Required range: x >= 1

per_page

integer

content and reviews only. Defaults to 25 posts or 10 reviews.

Required range: 1 <= x <= 50

sort_by

string

content only: a metric name, as the keys of a post's metrics (e.g. VIEW_COUNT, IMPRESSION_COUNT, LIKES). Newest first without it.

Maximum string length: 64

Example:

"VIEW_COUNT"

sort_dir

enum<string>

default:desc

Available options:

asc,

desc

Response

Success

account

object

Show child attributes

type

string

Example:

"overview"

tabs

string[]

Example:

["overview", "content", "insights"]

period

object

The range the figures cover, and the previous range of the same length every change is measured against.

Show child attributes

initial_sync

object

Show child attributes

data

object

Depends on the network and type. Compared figures are {value, change}, time series {date, value} lists, breakdowns {label, value} lists, and charts with several series an object of such lists.

Example:

{
  "total_followers": 120,
  "views": { "value": 5400, "change": 12.5 },
  "likes": { "value": 310, "change": -4.2 },
  "audience": [
    { "date": "2026-01-01", "value": 118 },
    { "date": "2026-01-02", "value": 120 }
  ]
}

Diagnostics

Accounts

Posts

Media

Tags

Analytics

Get the analytics of an account

Authorizations

Path Parameters

Query Parameters

Response