Zernio
Zernio
API Reference

Accounts

List accountsGETList trending commercial musicGETCheck 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: send your Zernio API key in the Authorization header, prefixed with Bearer.

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 trending commercial music

Returns the 100 currently trending tracks of TikTok's Commercial Music Library for a TikTok account connected through the TikTok for Business app. Use a track id as tiktokSettings.musicSoundInfo.musicSoundId when creating a post. The list is not paged; countryCode selects the country chart.

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.