Get Meta Ad Creatives by Ad ID
meta_ads_get_ad_creatives_by_ad_idRetrieve ad creatives for a specific ad ID, including fields like image URL and title, to analyze or optimize ad performance.
Instructions
Retrieve the ad creatives associated with a specific Meta ad.
Args:
ad_id (string): Ad ID to retrieve creatives for, e.g., '23843211234567'
fields (string[]): Fields to retrieve. Available: id, name, account_id, actor_id, adlabels, asset_feed_spec, authorization_category, body, call_to_action_type, effective_authorization_category, effective_instagram_media_id, effective_object_story_id, image_hash, image_url, instagram_permalink_url, instagram_story_id, instagram_user_id, link_url, object_id, object_story_id, object_story_spec, object_type, object_url, platform_customizations, product_set_id, status, template_url, thumbnail_url, title, url_tags, use_page_actor_override, video_id
limit (number): Maximum creatives per page (default: 25)
after / before (string): Pagination cursors from response.paging.cursors
date_format (string): Date format: 'U' for Unix timestamp, 'Y-m-d H:i:s' for MySQL datetime
Returns: Object with data (creative array) and paging. Use meta_ads_fetch_pagination_url with paging.next for more results.
Examples:
Use when: "What creatives are used by ad 23843211234567?"
Use when: "Get the image URLs and titles for all creatives on this ad"
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ad_id | Yes | Ad ID to retrieve creatives for, e.g., '23843211234567' | |
| fields | No | Fields to retrieve. Available: id, name, account_id, actor_id, adlabels, asset_feed_spec, authorization_category, body, call_to_action_type, effective_authorization_category, effective_instagram_media_id, effective_object_story_id, image_hash, image_url, instagram_permalink_url, instagram_story_id, instagram_user_id, link_url, object_id, object_story_id, object_story_spec, object_type, object_url, platform_customizations, product_set_id, status, template_url, thumbnail_url, title, url_tags, use_page_actor_override, video_id | |
| date_format | No | Format for date fields in response. 'U' = Unix timestamp (seconds), 'Y-m-d H:i:s' = MySQL datetime. Default: ISO 8601 | |
| 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 |