Get Meta Ad Creatives by Ad Account
meta_ads_get_adcreatives_by_adaccountRetrieve all ad creatives for a Meta ad account with optional filters. Use to audit creative assets or find creatives by condition.
Instructions
Retrieve all ad creatives belonging to a specific Meta ad account.
Useful for auditing all creative assets, finding creatives by status, or reviewing creative content across the account.
Args:
act_id (string): Ad account ID prefixed with 'act_', e.g., 'act_1234567890'
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
effective_status (string[]): Filter by status: ACTIVE, DELETED, IN_PROCESS, WITH_ISSUES
filtering (object[]): Additional filter objects with field, operator, value
limit (number): Results per page (1-100, default: 25)
after / before (string): Pagination cursors
Returns: Object with data (creative array) and paging. Use meta_ads_fetch_pagination_url with paging.next for more results.
Examples:
Use when: "List all active creatives in my ad account"
Use when: "Show all creatives with issues in act_123456"
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, 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 | |
| effective_status | No | Filter by creative status: ACTIVE, DELETED, IN_PROCESS, WITH_ISSUES | |
| filtering | No | List of filter objects. Each has 'field', 'operator', and 'value'. Example: [{field: 'spend', operator: 'GREATER_THAN', value: 50}] | |
| 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 |