Get Multiple Meta Ad Sets by IDs
meta_ads_get_adsets_by_idsBatch lookup of Meta ad sets by their IDs. Retrieves specified fields such as status, budget, targeting, and optimization goal in one API call.
Instructions
Retrieve information for multiple Meta ad sets in a single API call (batch lookup).
Efficient when you need data for several ad sets at once.
Args:
adset_ids (string[]): List of ad set IDs to retrieve, e.g., ['23843211234567', '23843211234568']
fields (string[]): Fields per ad set. Common: id, name, account_id, campaign_id, status, effective_status, daily_budget, lifetime_budget, budget_remaining, bid_amount, bid_strategy, billing_event, optimization_goal, targeting, start_time, end_time, created_time, updated_time, pacing_type, destination_type
date_format (string): Date format: 'U' for Unix timestamp, 'Y-m-d H:i:s' for MySQL datetime
Returns: Object where keys are ad set IDs and values are the corresponding ad set details.
Examples:
Use when: "Get details for ad sets 23843211234567, 23843211234568, and 23843211234569"
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| adset_ids | Yes | List of ad set IDs, e.g., ['23843211234567', '23843211234568'] | |
| fields | No | List of specific fields to retrieve. If omitted, default fields are returned | |
| date_format | No | Format for date fields in response. 'U' = Unix timestamp (seconds), 'Y-m-d H:i:s' = MySQL datetime. Default: ISO 8601 |