Get inbox messaging volume
Daily inbox messaging volume + breakdowns. Folds the raw messaging events into three projections so the client can render the volume chart, KPI strip, and per-platform stacked bar from a single call. Max date range is 365 days.
API key authentication - use your Zernio API key as a Bearer token
In: header
Query Parameters
Inclusive lower bound (YYYY-MM-DD). Required.
dateInclusive upper bound (YYYY-MM-DD). Defaults to today.
dateFilter by single platform (facebook, instagram, twitter, etc.).
Filter by metadata.source lineage (human, workflow, sequence, broadcast, comment_automation, api, contact, platform).
Response Body
application/json
application/json
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.inboxanalytics.getInboxVolume({ query: { fromDate: '2026-01-15', },});console.log(data);{
"success": true,
"from": "2019-08-24",
"to": "2019-08-24",
"summary": {
"received": 0,
"sent": 0,
"read": 0,
"failed": 0,
"uniqueConversations": 0
},
"timeseries": [
{
"date": "2019-08-24",
"sent": 0,
"received": 0,
"read": 0,
"failed": 0
}
],
"byPlatform": [
{
"platform": "string",
"sent": 0,
"received": 0,
"read": 0,
"failed": 0
}
]
}{
"error": "string",
"details": {}
}{
"error": "Unauthorized"
}{
"error": "string",
"type": "invalid_request_error",
"code": "string",
"param": "string",
"platform": "string",
"platformError": {},
"details": {}
}Get top accounts by inbox volume GET
Leaderboard of social accounts by inbox message volume. Decorates each row with display labels from the live SocialAccount record (so the UI shows username + displayName, not just an ID). Accounts that no longer map to a SocialAccount surface as "(disconnected)" so the row stays visible. Max date range is 365 days.
List ads GET
Returns a paginated list of ads with metrics computed over an optional date range. Use source=all to include externally-synced ads from platform ad managers. If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max. To find the Zernio ad behind a comment you see in Meta Business Manager, filter by platformAdId (the Meta ad ID), effectiveObjectStoryId (Facebook), or effectiveInstagramMediaId (Instagram) — those are the post/media the ad's engagement lives on, and are also returned on each ad's `creative` object. Then call GET /v1/ads/{adId}/comments with the returned ad id.