Social media audience API

Get follower and subscriber counts with one API call

See the latest audience count for every supported social account in one Mallary profile. Build reports, charts, and alerts without checking each app by hand.

  • One simple response
  • Fresh counts each day
  • One profile at a time
Watch the Audience API short YouTube

Turn audience counts into clear next steps

Use one small API response to track growth, build reports, and see when an account reaches its next goal.

Get many counts in one call

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

Show growth over time

Save each new count in your app. Then turn the data into a clear chart, report, or weekly update.

Spot a change fast

Build an alert when an account grows, slows down, or reaches a goal that matters to your team.

GET /api/v1/audience

Make one call. Get one clear list.

Mallary returns one item for each connected account in the profile. Each item has the platform, account, metric, count, status, and update time.

1

Connect your social accounts

Keep each brand or project in its own Mallary profile.

2

Call the Audience API

Use your default profile or add profile_id for another profile.

3

Use the latest count

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

Latest audience counts GET
curl --request GET \
  --url 'https://mallary.ai/api/v1/audience' \
  --header 'Authorization: Bearer YOUR_API_KEY'
{
  "status": "ok",
  "data": {
    "profile_id": "AbC123xYz90",
    "audience": [
      {
        "platform": "youtube",
        "metric": "subscribers",
        "count": 12450
      }
    ]
  }
}

Use the data where your team works

The Audience API gives you a small, clear response that is easy to use in many tools.

Client dashboards

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

Weekly reports

Add follower and subscriber gains to the reports you already send.

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 is what to know before you build with the endpoint.

What does the Mallary Audience API return?

It returns the latest follower, subscriber, or Page like count for each supported account in one Mallary profile. It also tells you the platform, account, metric, status, and time of the last count.

Which social platforms can I use?

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

How often does Mallary update the count?

Mallary checks supported audience counts once every 24 hours. The API gives you the latest saved count.

Can I get counts for one Mallary profile?

Yes. Add profile_id when you want a profile that is not your default profile. Leave it out to use your default profile.

Does Mallary add all account counts together?

No. Each account stays on its own line. One person may follow you on more than one platform, so adding every count could be wrong.

Which plans include the Audience API?

The Audience API is part of the analytics tools on Starter, Pro, and Business plans.

Put your audience counts to work

Connect your social accounts, call one endpoint, and build a clear view of your audience.