latestOpenAPI 3.1.02026-08-225721892.2 MB

19fd2b70854e

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 and length; 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.

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. There is no upload operation here: upload by URL 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

Comma-separated Graph field override (supports nested {} projections).

limitinteger

Rows per page

afterstring

Cursor from paging.after of the previous page.

Response

Ad videos (raw Meta shape)

adAccountIdstring
dataobject[]