List ad accounts
Returns the platform ad accounts available for the given social account (e.g. Meta ad accounts, TikTok advertiser IDs, Google Ads customer IDs).
For TikTok agencies: enumerates every advertiser under every Business Center the token
can read (paginated server-side), then chunks the lookup against TikTok's
/advertiser/info/ endpoint (which has a per-call cap of ≤100 IDs). Solo advertisers
without a BC fall back to the OAuth-time advertiser_ids list. Cached for 1h on the
SocialAccount; lazy-refreshed on first call after expiry.
API key authentication - use your Zernio API key as a Bearer token
In: header
Query Parameters
Social account ID
Filter response to a single platform ad account ID (e.g. act_123 for Meta, advertiser_id for TikTok). Returns at most one item.
Clamp the returned accounts[] length. Useful for typeahead pickers on agency tokens with hundreds of advertisers.
1 <= value <= 1000Response Body
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.adaccounts.listAdAccounts({ query: { accountId: 'account_abc123', },});console.log(data);{
"accounts": [
{
"id": "string",
"name": "string",
"currency": "string",
"status": "string",
"timezoneName": "string",
"timezoneOffsetHoursUtc": 0,
"minimumDailyBudget": 0,
"selectable": true,
"unusableReason": "string"
}
]
}{
"error": "Unauthorized"
}