Get Meta Ad Images
meta_ads_get_ad_imagesRetrieve ad images from a Meta ad account to audit assets, filter by hash, name, or dimensions, and check image status.
Instructions
Retrieve ad images belonging to a Meta ad account.
Useful for auditing image assets, finding images by hash or name, and checking image dimensions and status.
Args:
act_id (string): Ad account ID prefixed with 'act_', e.g., 'act_1234567890'
fields (string[]): Fields to retrieve. Available: id, account_id, created_time, creatives, hash, height, is_associated_creatives_in_adgroups, name, original_height, original_width, permalink_url, status, updated_time, url, url_128, width
hashes (string[]): Filter by specific image hashes
name (string): Filter images by name (partial match)
minwidth (number): Minimum image width in pixels
minheight (number): Minimum image height in pixels
limit (number): Results per page (1-100, default: 25)
after / before (string): Pagination cursors
Returns: Object with data (image array) and paging. Each image contains URL, dimensions, hash, and status. Use meta_ads_fetch_pagination_url with paging.next for more results.
Examples:
Use when: "List all images in my ad account"
Use when: "Find images with hashes abc123 and def456"
Use when: "Show images wider than 1000px"
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| act_id | Yes | Ad account ID prefixed with 'act_', e.g., 'act_1234567890' | |
| fields | No | Fields to retrieve. Available: id, account_id, created_time, creatives, hash, height, is_associated_creatives_in_adgroups, name, original_height, original_width, permalink_url, status, updated_time, url, url_128, width | |
| hashes | No | Filter by specific image hashes, e.g., ['abc123', 'def456'] | |
| name | No | Filter images by name (partial match) | |
| minwidth | No | Minimum image width in pixels | |
| minheight | No | Minimum image height in pixels | |
| limit | No | Maximum number of results to return per page (1-100, default: 25) | |
| after | No | Cursor for the next page of results, from response.paging.cursors.after | |
| before | No | Cursor for the previous page of results, from response.paging.cursors.before | |
| offset | No | Alternative pagination: number of results to skip |