# Show Ad Library ad (adsap_get_ad_library_snapshot)

Shows what Ad Library ads look like.

Canonical: https://adsap.ai/docs/tools/adsap_get_ad_library_snapshot
Updated: 2026-10-06

**Platform:** Meta · **Read or write:** Read · **Plan:** Early Access · **Consumes a task:** No · **Preview supported:** No

## What it does

Shows what Ad Library ads look like. Give it up to 8 ad IDs from an Ad Library search and one call returns every creative with its copy. In assistants that support interactive cards, two or more ads appear as a gallery: click an ad to enlarge it. Video ads play in the card and carousel ads show their slides.

## When to use it

- Use it after [`adsap_search_ad_library`](/tools/adsap_search_ad_library), which returns text and links but no picture.
- `ad_ids` takes 1 to 8 IDs, in the order you want them shown. Two or more appear as a gallery. One appears at full size.
- One call takes about 8 seconds for a full gallery. The assistant sends all the IDs in one call, not one call per ad.
- For more than 8 ads, ask for the next ones after the first gallery.
- The tool cannot show an ad that stopped running. That ad gets a tile saying so, and the other ads still appear.

## Worked example

### You ask

"Show me their two biggest static ads."

### The assistant calls `adsap_get_ad_library_snapshot`

```json
{
  "ad_account_id": "act_1234567890",
  "ad_ids": ["1000000000000001", "1000000000000002"]
}
```

### Adsap returns

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

```json
[
  {
    "type": "image",
    "data": "/9j/4AAQSkZJRgABAQAAAQABAAD",
    "mimeType": "image/jpeg"
  },
  {
    "type": "image",
    "data": "/9j/4AAQSkZJRgABAQAAAQABAAD",
    "mimeType": "image/jpeg"
  },
  {
    "type": "text",
    "text": "{\"ok\":true,\"data\":{\"ads\":[{\"ad_id\":\"1000000000000001\",\"ok\":true,\"page_name\":\"Example Shoes\",\"body_text\":\"Free delivery on orders over 100 euros.\",\"body_truncated\":false,\"is_video\":false,\"video_url\":null,\"is_carousel\":false,\"media_count\":1,\"images_returned\":1,\"library_url\":\"https://www.facebook.com/ads/library/?id=1000000000000001\"},{\"ad_id\":\"1000000000000002\",\"ok\":true,\"page_name\":\"Example Shoes\",\"body_text\":\"The new collection is here.\",\"body_truncated\":false,\"is_video\":false,\"video_url\":null,\"is_carousel\":false,\"media_count\":1,\"images_returned\":1,\"library_url\":\"https://www.facebook.com/ads/library/?id=1000000000000002\"}],\"rendered\":2,\"failed\":0}}"
  }
]
```

### How to read it

This tool returns content parts, not one data object. The image parts come first, one per creative, in the order of the ads. `data` holds each image as base64 text, shortened here. The last part is text that holds the details of each ad: its Page name, its copy in `body_text`, and its video and carousel flags.

`images_returned` says how many of the images belong to each ad. Most ads have 1. A carousel has more, and its slides come one after the other. `media_count` is the number of slides the ad has, which can be higher than the number returned. In assistants that show interactive cards, the card assembles this for you.

## Parameters

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

| Name | Type | Required | Description |
|---|---|---|---|
| `ad_account_id` | string | Yes | Your ad account ID (act_xxx): the same one used for the adsap_search_ad_library call. Anchors the workspace ownership check and the Meta budget. |
| `ad_ids` | array of string | No | The Ad Library ad ids to show, 1 to 8, taken from adsap_search_ad_library results' `id` field, in the order you want them displayed (e.g. highest reach first). Two or more render as a gallery. For more than 8 ads, show the first 8 and call again for the next ones when the user asks. |
| `ad_id` | string | No | A single Ad Library ad id. Same as ad_ids with one entry; prefer ad_ids. |

## Example prompts

- "Show me the top 8 of those ads."
- "Let me see that ad."
- "Show me the next ones."

## Notes

- The pictures are the advertiser's own image files. For a video ad the picture is its first frame, and the video plays when you open the ad in the card. - A carousel shown alone returns up to 6 slides. In a gallery the slides share a limit of 12 images across all the ads. - In a gallery, the tool shortens long copy to about 700 characters and sets `body_truncated` to true. Ask for that ad alone to read the full copy. - It shows ads exactly as Meta's Ad Library does, so it works only for ads the search can return.

## Related tools

- [`adsap_create_ad_from_ig_post`](/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_preview`](/tools/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`](/tools/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_preview_clip`](/tools/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`](/tools/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`](/tools/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`](/tools/adsap_replace_ad_creative): DESTRUCTIVE.
- [`adsap_search_ad_library`](/tools/adsap_search_ad_library): Search Meta's public Ad Library for ads (competitor research / ad transparency).
- [`adsap_upload_creative`](/tools/adsap_upload_creative): Upload image/video from Google Drive or Dropbox to a Meta ad account.

## Guide

Read [Creatives](/guides/creatives) for the workflow around this tool, and the [Tool reference](/tools) for every tool.