Ad Creatives

Ad video library

Changed on

Lists the videos in a Meta ad account's library, including ones uploaded elsewhere, so you can reuse one across ads.

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

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/ads/videos
  • Auth: HTTP bearer

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

  • f8c8f34fb41aRevision changes
    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status

  • d556591af3f6Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status