Get Audience Counts

GET

api

audience

Get current audience counts

curl --request GET \
  --url https://mallary.ai/api/v1/audience \
  --header 'Authorization: Bearer <token>'

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

fetch('https://mallary.ai/api/v1/audience', 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://mallary.ai/api/v1/audience",
  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://mallary.ai/api/v1/audience"

	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://mallary.ai/api/v1/audience")

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

{
  "status": "ok",
  "data": {
    "profile_id": "<string>",
    "generated_at": "2023-11-07T05:31:56Z",
    "audience": [
      {
        "platform": "x",
        "label": "<string>",
        "account": {
          "id": "<string>",
          "username": "<string>",
          "avatar_url": "<string>"
        },
        "metric": "followers",
        "count": 1,
        "status": "available",
        "status_message": "<string>",
        "captured_at": "2023-11-07T05:31:56Z",
        "last_attempt_at": "2023-11-07T05:31:56Z",
        "next_update_at": "2023-11-07T05:31:56Z"
      }
    ]
  }
}

Mallary updates supported audience counts once every 24 hours. Use profile_id for a non-default profile. Omit it to use the default profile. The response includes every connected account. count is the latest saved number when Mallary can collect it.

YouTube returns subscribers.
Facebook Pages, Instagram, Threads, TikTok, X, Pinterest, and Bluesky return followers. Facebook may return page_likes when that is the only count the Page gives Mallary.
A TikTok connection made without audience stats access returns permission_required until it is reconnected with that access.
LinkedIn returns permission_required until Mallary adds the permission it needs.
Other platforms may return unsupported when they do not provide an account audience count.

Mallary does not add the counts together. The same person may follow more than one account.

Authorizations

Authorization

string

header

required

Use Authorization: Bearer {api_key}

Query Parameters

profile_id

string

Connection profile to inspect. Omit to use the default profile. Random public connection profile ID returned by GET /api/v1/profiles.

Pattern: ^[A-Za-z0-9]{6,32}$

Example:

"AbC123xYz90"

Response

Audience counts retrieved

status

enum<string>

required

Available options:

ok

data

object

required

Show child attributes

Last modified on August 20, 2026

Get current audience counts

curl --request GET \
  --url https://mallary.ai/api/v1/audience \
  --header 'Authorization: Bearer <token>'

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

fetch('https://mallary.ai/api/v1/audience', 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://mallary.ai/api/v1/audience",
  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://mallary.ai/api/v1/audience"

	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://mallary.ai/api/v1/audience")

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

{
  "status": "ok",
  "data": {
    "profile_id": "<string>",
    "generated_at": "2023-11-07T05:31:56Z",
    "audience": [
      {
        "platform": "x",
        "label": "<string>",
        "account": {
          "id": "<string>",
          "username": "<string>",
          "avatar_url": "<string>"
        },
        "metric": "followers",
        "count": 1,
        "status": "available",
        "status_message": "<string>",
        "captured_at": "2023-11-07T05:31:56Z",
        "last_attempt_at": "2023-11-07T05:31:56Z",
        "next_update_at": "2023-11-07T05:31:56Z"
      }
    ]
  }
}

Overview

Endpoints

Authorizations

Query Parameters

Response