Zernio
Zernio
API Reference

Accounts

List accountsGETCheck account healthGETList posts published on the platformGETCheck accounts healthGETGet Bluesky account settingsGETGet follower statsGETCheck whether an Instagram user follows the accountGETGet Slack account settingsGETGet TikTok creator infoGETUpdate accountPUTUpdate Bluesky account settingsPATCHUpdate Slack account settingsPATCHDisconnect accountDELETEMove account to another profilePATCH
Dashboard
llms.txtOpenAPI
OverviewPlatformsAPI ReferenceResources
Accounts

Check account health

Returns detailed health info for a specific account including token status, permissions, and recommendations.

For WhatsApp accounts the response also includes platformConnection, a live probe of the Meta link behind the channel (the same read as GET /v1/whatsapp/number-info). The OAuth token can be perfectly valid while Meta refuses to serve the phone-number object (for example after a phone-side coexistence disconnect), so tokenStatus alone is not a liveness signal for WhatsApp. When the Meta link is dead, platformConnection.status is disconnected and the overall status is error.

GET
/v1/accounts/{accountId}/health

Authorization

bearerAuth
AuthorizationBearer <token>

API key authentication - use your Zernio API key as a Bearer token

In: header

Path Parameters

accountId*string

The account ID to check

Response Body

application/json

application/json

application/json

application/json

{  "accountId": "abc123",  "platform": "instagram",  "username": "myaccount",  "displayName": "My Account",  "status": "healthy",  "tokenStatus": {    "valid": true,    "expiresAt": "2025-06-15T00:00:00Z",    "expiresIn": "180 days",    "needsRefresh": false  },  "permissions": {    "posting": [      {        "scope": "instagram_basic",        "granted": true,        "required": true      },      {        "scope": "instagram_content_publish",        "granted": true,        "required": true      }    ],    "analytics": [      {        "scope": "instagram_manage_insights",        "granted": true,        "required": false      }    ],    "optional": [],    "canPost": true,    "canFetchAnalytics": true,    "missingRequired": []  },  "issues": [],  "recommendations": []}
Was this page helpful?

List accounts

Returns connected social accounts. Only includes accounts within the plan limit by default. Follower data requires analytics add-on. Supports optional server-side pagination via page/limit params. When omitted, returns all accounts (backward-compatible). page and limit must be supplied together; out-of-range page/limit values are rejected with 400 rather than silently clamped.

List posts published on the platform

Returns the 25 most recent posts that exist on the platform for a connected account, read live from the platform API. This covers everything on the account, including posts that were never created through Zernio. Use it to obtain the platform's own post id, which the analytics endpoints take as input. On YouTube the returned `id` is the video ID that `GET /v1/analytics/youtube/daily-views`, `/video-retention` and `/demographics` expect as `videoId`, so this endpoint is what backs a video picker in your own UI. Not every field applies to every platform: `reactionCount` is Facebook and LinkedIn, `shareCount` is platform dependent, `cid` is the Bluesky content id needed to reply, and `subreddit` is Reddit only. Absent fields are omitted from the response. The account's token is refreshed before the call when it has expired. When the refresh cannot recover it, the response is a 401 with code `TOKEN_EXPIRED` and the account has to be reconnected.