Ad Creatives

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.

get/v1/ads/videos

Query parameters

accountIdstring required

Zernio SocialAccount id (posting or ads variant) used to resolve the Meta token.

adAccountIdstring required

Meta ad account id (act_<n>).

fieldsstring
Example:id,title,status,thumbnails,length

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.

limitinteger

Rows per page

afterstring

Cursor from paging.after of the previous page.

Response

Ad videos (raw Meta shape)

adAccountIdstring
dataobject[]

Changes