Get animated preview clip (`adsap_get_preview_clip`)

Platform: Meta · Read or write: Read · Plan: All plans · Consumes a task: No · Preview supported: No

What it does

Fetches the animated clip of an ad preview you rendered earlier. The clip is a recording of the real Meta preview for one placement. It returns a signed URL when the recording is ready, or a pending status while the recording continues. It reads from storage only and makes no Meta API call.

When to use it

Use it after adsap_get_ad_preview, with the same ad_id and ad_format, to get the animated clip of that preview.
It reads from storage only and makes no Meta call. Asking again every few seconds costs nothing on the Meta side.
status has three values: ready, pending while the recording runs, and not_found when no clip exists for that ad and placement.
Clips exist for video ads only. On not_found, render the preview first with adsap_get_ad_preview.
The link in animated_url expires after one hour. Call the tool again for a fresh link.

Worked example

You ask

“Is the animated Reels preview of ad 120210000000000 ready yet?”

The assistant calls `adsap_get_preview_clip`


{
  "ad_account_id": "act_1234567890",
  "ad_id": "120210000000000",
  "ad_format": "INSTAGRAM_REELS"
}

Adsap returns

The field names are the ones Adsap returns. The values are examples.


{
  "status": "ready",
  "animated_url": "https://www.example.com/ad-previews/120210000000000_INSTAGRAM_REELS.webm",
  "mime": "video/webm",
  "expires_in_seconds": 3600
}

How to read it

status tells you where the clip stands. On ready, animated_url is a signed link to a short WebM video of the real Meta preview, valid for expires_in_seconds. Open it in a browser to watch the ad play in its placement.

On pending or not_found there is no animated_url. The payload holds status and a message that says what to do next.

Parameters

Descriptions are shortened from the tool schema. Your assistant sees the full text.

Name	Type	Required	Description
`ad_account_id`	string	Yes	Ad account ID (act_xxx) that owns the ad.
`ad_id`	string	Yes	The ad whose preview clip to fetch.
`ad_format`	one of `DESKTOP_FEED_STANDARD`, `MOBILE_FEED_STANDARD`, `INSTAGRAM_STANDARD`, `INSTAGRAM_STORY`, `INSTAGRAM_REELS`, `RIGHT_COLUMN_STANDARD`, `MESSENGER_MOBILE_INBOX_MEDIA`, `THREADS_STREAM`	Yes	The placement the clip was rendered for.

Example prompts

“Is the animated preview of my Reels ad ready yet?”
“Get me the video clip of that ad preview.”

adsap_create_ad_from_ig_post: Turn an existing Instagram post, video, or reel into an ad inside an EXISTING ad set: Meta Ads Manager’s “Use existing post”.
adsap_get_ad_library_snapshot: SHOW what Ad Library ads ACTUALLY LOOK LIKE (creative, copy, page name), in a SELF-CONTAINED card.
adsap_get_ad_preview: Render a pixel-accurate visual preview of an existing Meta ad (real Meta render; video ads also get an animated clip in the interactive…
adsap_get_creative_performance: Ranked creative performance analysis with fatigue detection.
adsap_get_import_status: Check progress of a Meta historical-asset import started with adsap_import_account_creatives: status, phase (images then videos)…
adsap_get_upload_status: Check status of an async video upload.
adsap_import_account_creatives: Import ALL historical creative assets (images + videos) that already exist in a Meta ad account into the Adsap Creative Library.
adsap_list_creative_assets: List uploaded Meta creative images and videos in the ad account asset library.
adsap_list_drive_files: Browse Google Drive for creative image/video files to upload to Meta.
adsap_list_dropbox_files: Browse Dropbox for creative image/video files to upload to Meta.
adsap_list_ig_media: List an Instagram account’s recent media/posts (live from Meta): the posts, reels, and stories that can be promoted.
adsap_replace_ad_creative: DESTRUCTIVE.
adsap_search_ad_library: Search Meta’s public Ad Library for ads (competitor research / ad transparency).
adsap_upload_creative: Upload image/video from Google Drive or Dropbox to a Meta ad account.

Guide

Read Creatives for the workflow around this tool, and the Tool reference for every tool.

The Meta Ads MCP server page shows how to connect Meta Ads to Claude, ChatGPT or Perplexity.

Get animated preview clip (adsap_get_preview_clip)