accounts
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).
AuthorizationBearer <token>
API key authentication - use your Zernio API key as a Bearer token
In: header
Query Parameters
profileId?string
Filter accounts by profile ID
platform?string
Filter accounts by platform (e.g. "instagram", "twitter").
includeOverLimit?boolean
When true, includes accounts from over-limit profiles.
Default
falsepage?integer
Page number (1-based). When provided with limit, enables server-side pagination. Omit for all accounts.
Range
1 <= valuelimit?integer
Page size. Required alongside page for pagination.
Range
1 <= value <= 100Response Body
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.accounts.listAccounts();console.log(data);{
"accounts": [
{
"_id": "64e1...",
"platform": "twitter",
"profileId": {
"_id": "64f0...",
"name": "My Brand",
"slug": "my-brand"
},
"username": "@acme",
"displayName": "Acme",
"profileUrl": "https://x.com/acme",
"isActive": true
}
],
"hasAnalyticsAccess": false
}{
"error": "Unauthorized"
}