Social media audience API

Get follower and subscriber counts with one API call

Get the latest count for each supported social account in one Mallary profile. Use the counts to make reports, charts, and alerts without checking each app one by one.

  • One clear list
  • Checked each day
  • One profile per call
Watch the Audience API short YouTube
Reports Charts Alerts

Turn audience counts into clear next steps

Save the counts to track growth, make reports, and see when an account reaches a goal.

Get account counts in one call

Get the latest count for each supported account in one Mallary profile. You do not need to check each app one by one.

Show growth over time

Save each count in your app. Use the saved data to make a chart, report, or weekly update.

Know when a count changes

Save each count, then alert your team when a number goes up or reaches a goal.

GET /api/v1/audience

Make one call. Get one clear list.

Mallary returns one item for each connected account in the profile. Each item shows the platform, account, type of count, latest saved count, status, and time it was checked.

1

Connect your social accounts

Add the accounts you want to track to a Mallary profile.

2

Call the Audience API

Leave out profile_id for your default profile. Add it to use a different profile.

3

Use the saved counts

Add them to your report, chart, alert, app, or agent.

Latest audience countsGET
curl --request GET \
  --url 'https://mallary.ai/api/v1/audience' \
  --header 'Authorization: Bearer YOUR_API_KEY'
{
  "status": "ok",
  "data": {
    "profile_id": "AbC123xYz90",
    "generated_at": "2026-09-02T12:00:00.000Z",
    "audience": [
      {
        "platform": "youtube",        "label": "YouTube",
        "account": {
          "id": "UC123",
          "username": "@yourchannel",
          "avatar_url": null
        },
        "metric": "subscribers",        "count": 12450,        "status": "available",
        "status_message": null,
        "captured_at": "2026-09-02T11:45:00.000Z",
        "last_attempt_at": "2026-09-02T11:45:00.000Z",
        "next_update_at": "2026-09-03T11:45:00.000Z"
      }
    ]
  }
}
View the full response

Use the counts in your own tools

The Audience API sends back a short list that is easy to use in reports, apps, and workflows.

Client dashboards

Show each brand its latest audience count in one clean view.

Weekly reports

Save each count, then show the change in your weekly reports.

Goal tracking

Track progress toward a follower or subscriber goal for each account.

AI and automation

Give your agent or workflow the latest count before it makes a report.

Audience API FAQ

Common questions about audience counts

Here are the main things to know before you use the API.

What does the Mallary Audience API return?

It gives you the latest count for each supported account in one Mallary profile. It also shows the platform, account, type of count, status, and when the count was checked.

Which social platforms can I use?

You can get audience counts for YouTube, Facebook Pages, Instagram, TikTok, Threads, X, Pinterest, and Bluesky.

How often does Mallary update the count?

Mallary checks each supported count once every 24 hours. The API returns the latest count Mallary has saved.

Can I get counts for one Mallary profile?

Yes. Leave out profile_id to use your default profile. Add profile_id to use a different profile.

Does Mallary add all account counts together?

No. It lists each account on its own line. The same person may follow you on more than one platform, so one total may not be right.

Which plans include the Audience API?

Starter, Pro, and Business plans include the Audience API.

Social media audience API

Put your audience counts to work

Connect your social accounts. Call the API. Use the counts in a report, chart, alert, app, or AI tool.

One clear list Checked each day One profile per call