Ad video library
Lists the ad account's video library (Meta's /act_X/advideos), rows returned verbatim.
The default projection covers id, title, status, poster frames, length and source (the
playable MP4); fields is a raw-passthrough override. Any id here is reusable as
video.id on the create endpoints, so N ads that differ only in copy share one upload.
source lets you PLAY a video before picking it, which a poster frame alone can't settle
when several videos share a first frame. It is a signed CDN URL that EXPIRES, so treat it
as good for preview at selection time only. Never persist it; re-list to get a fresh one.
This is the only way to reach a video uploaded OUTSIDE Zernio (Ads Manager, another
tool); videos we uploaded also come back as creative.videoId on GET /v1/ads.
Meta transcodes asynchronously, so a row is only usable once status.video_status
reads ready. Upload a new video via POST /v1/ads/videos, or inline via video.url
on POST /v1/ads/create.
Authorization
bearerAuth API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.
In: header
Query Parameters
Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.
Meta ad account id (act_).
Comma-separated Graph field override. Supports nested {} projections and Graph field modifiers, so a nested edge can be paged explicitly: without a .limit() modifier the expansion runs at the Meta default page size and the tail is dropped silently.
Rows per page
1 <= value <= 10025Cursor from paging.after of the previous page.
Response Body
application/json
application/json
application/json
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.adcreatives.listAdVideos({ query: { accountId: 'account_abc123', adAccountId: 'adaccount_abc123', },});console.log(data);{ "adAccountId": "string", "data": [ {} ], "paging": { "after": "string" }}Ad image library
Lists the ad account's image library (Meta's `/act_X/adimages`), rows returned verbatim. The default projection covers hash, url, name, dimensions and status; `fields` is a raw-passthrough override. Any `hash` here is reusable wherever Meta accepts `image_hash` (e.g. `imageHash` on POST /v1/ads/creatives).
List TikTok ad identities
The identities an ad on this TikTok advertiser may run as (the profile shown on the ad): the advertiser's own TikTok accounts (TT_USER), Business Center authorized accounts (BC_AUTH_TT) and custom brand identities (CUSTOMIZED_USER). Pass the chosen `identityId` on POST /v1/ads/create or POST /v1/ads/boost. Spark-post identities (AUTH_CODE) are not listed; a Spark code creates its own.