Zernio
Zernio
API Reference

Inbox Analytics

List conversation analyticsGETGet conversation analyticsGETGet day × hour heatmapGETGet inbox response-time statsGETGet inbox source breakdownGETGet top accounts by inbox volumeGETGet inbox messaging volumeGET
Dashboard
llms.txtOpenAPI
OverviewPlatformsAPI ReferenceResources
Inbox Analytics

List conversation analytics

Per-conversation listing with per-row totals + first/last message timestamps. The inbox analog of GET /v1/analytics (posts listing): same filter shape, same pagination, same sort/order semantics. Use as the entry point for the per-conversation analytics drawer at /v1/analytics/inbox/conversations/{conversationId}.

Rows are enriched with the conversation's participant info (participantName, participantUsername, participantPicture) and last-message preview by joining the Conversation document scoped to the caller's team. Max date range is 365 days.

GET
/v1/analytics/inbox/conversations

Authorization

bearerAuth
AuthorizationBearer <token>

API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.

In: header

Query Parameters

fromDate*string
Formatdate
toDate?string
Formatdate
profileId?string
platform?string
accountId?string
source?string
limit?integer
Range1 <= value <= 100
Default50
page?integer
Range1 <= value
Default1
sortBy?string
Default"lastMessageAt"

Value in

  • "lastMessageAt"
  • "firstMessageAt"
  • "totalMessages"
  • "received"
  • "sent"
  • "read"
  • "failed"
order?string
Default"desc"

Value in

  • "asc"
  • "desc"

Response Body

application/json

application/json

application/json

application/json

{  "success": true,  "from": "2019-08-24",  "to": "2019-08-24",  "items": [    {      "conversationId": "string",      "mongoId": "string",      "accountId": "string",      "platform": "string",      "participantName": "string",      "participantUsername": "string",      "participantPicture": "string",      "lastMessage": "string",      "totalMessages": 0,      "received": 0,      "sent": 0,      "read": 0,      "failed": 0,      "firstMessageAt": "2019-08-24T14:15:22Z",      "lastMessageAt": "2019-08-24T14:15:22Z"    }  ],  "pagination": {    "page": 0,    "limit": 0,    "total": 0,    "totalPages": 0,    "hasMore": true  }}
Was this page helpful?

Get Google Business Profile search keywords

Returns search keywords that triggered impressions for a Google Business Profile location. Data is aggregated monthly. Keywords below a minimum impression threshold set by Google are excluded. Max 18 months of historical data. Requires the Analytics add-on.

Get conversation analytics

Per-conversation inbox analytics. The inbox analog of /v1/analytics/post-timeline: one conversation, daily totals, source mix. The {conversationId} path param accepts EITHER the Mongo `_id` of the Conversation document OR its `platformConversationId` (the same identity used by metadata.conversationId at ingest time). Ownership is verified in MongoDB against the caller's team before the Tinybird query fires. Max date range is 365 days.