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.

Authorization

AuthorizationBearer <token>

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

In: header

Query Parameters

accountIdstring

Social account ID

adAccountId?string

Filter response to a single platform ad account ID (e.g. act_123 for Meta, advertiser_id for TikTok). Returns at most one item.

limit?integer

Clamp the returned accounts[] length. Useful for typeahead pickers on agency tokens with hundreds of advertisers.

Range1 <= value <= 1000

Response Body

application/json

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.ads.listAdAccounts({  query: {    accountId: 'account_abc123',  },});console.log(data);

{
  "accounts": [
    {
      "id": "string",
      "name": "string",
      "currency": "string",
      "status": "string",
      "timezoneName": "string",
      "timezoneOffsetHoursUtc": 0
    }
  ]
}

{
  "error": "Unauthorized"
}

Empty

Authorization

AuthorizationBearer <token>

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

In: header

Query Parameters

accountIdstring

Social account ID

adAccountId?string

Filter response to a single platform ad account ID (e.g. act_123 for Meta, advertiser_id for TikTok). Returns at most one item.

limit?integer

Clamp the returned accounts[] length. Useful for typeahead pickers on agency tokens with hundreds of advertisers.

Range1 <= value <= 1000

Response Body

application/json

import Zernio from '@zernio/node';

const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });

const { data } = await zernio.ads.listAdAccounts({
  query: {
    accountId: 'account_abc123',
  },
});
console.log(data);

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.ads.listAdAccounts({  query: {    accountId: 'account_abc123',  },});console.log(data);

{
  "accounts": [
    {
      "id": "string",
      "name": "string",
      "currency": "string",
      "status": "string",
      "timezoneName": "string",
      "timezoneOffsetHoursUtc": 0
    }
  ]
}

{
  "error": "Unauthorized"
}

Empty

List ad accounts

Authorization

Query Parameters

Response Body

200application/json

401application/json

422

List ad accounts

Authorization

Query Parameters

Response Body

200application/json

401application/json

422

application/json

application/json

application/json

application/json