Get creative performance (adsap_get_creative_performance)
Platform: Meta · Read or write: Read · Plan: Early Access · Consumes a task: No · Preview supported: No
What it does
Ranks the ads in an account by creative performance and flags fatigue. Each ad gets a hook rate (3-second plays over impressions) and a hold rate (15-second over 3-second plays). It also gets ad relevance diagnostics and a fatigue label: healthy, watch or fatigued. The fatigue label comes from frequency, CPA decay and hook rate decline. You can set the window up to 90 days, include paused ads, and sort by spend, fatigue, hook rate, CPA or ROAS.
Parameters
Descriptions are shortened from the tool schema. Your assistant sees the full text.
| Name | Type | Required | Description |
|---|---|---|---|
ad_account_id | string | Yes | Must include act_ prefix. |
date_range_days | number | No | Analysis window in days. Default 30, max 90. |
include_paused | boolean | No | Include paused ads. Default false. |
include_asset_breakdown | boolean | No | Fetch asset-level breakdown for dynamic creatives. Default false. |
sort_by | one of spend, fatigue_score, hook_rate, cpa, roas | No | Sort order. Default: spend. |
limit | number | No | Max ads to return. Default 50, max 100. |
Example prompts
- “Which of my ads are showing creative fatigue?”
- “Rank my ads by hook rate over the last 14 days.”
- “Which creatives have the best ROAS this quarter?”
Related tools
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 an Ad Library ad ACTUALLY LOOKS 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_import_status: Check progress of a Meta historical-asset import started with adsap_import_account_creatives: status, phase (images then videos)…adsap_get_preview_clip: Fetch the animated placement-preview clip (recorded video of the real Meta preview) for an ad+placement previously rendered with…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.
Last updated on