# Meta Ads

Source : https://pilot.braike.com/docs/regies/meta-ads

Les 44 outils de lecture que Pilot MCP sert pour Meta Ads, tirés du serveur.

Pilot MCP sert **44 outils** pour Meta Ads, tous en lecture. Leur nom commence par `meta_`. Les 28 outils d'écriture du connecteur ne sont pas servis : Pilot MCP est en lecture seule.

Meta Ads en lecture : comptes, campagnes, ensembles de publicités et publicités, statistiques et comparaisons, créations, audiences et ciblage, pixels et règles automatiques.

<Callout title="Ce que dit chaque fiche">
Le nom, la description et les paramètres viennent de la liste que le serveur sert à votre assistant (`tools/list`). Les descriptions sont en anglais : c'est le texte que votre assistant reçoit. Votre assistant n'a pas à remplir les accès à la régie : Pilot les ajoute à chaque appel.
</Callout>

## Familles d'outils [#familles]

| Famille | Outils |
| --- | ---: |
| [Audiences et ciblage](#audiences) | 8 |
| [Campagnes, ensembles et publicités](#campagnes) | 8 |
| [Comptes](#comptes) | 6 |
| [Créations](#creations) | 5 |
| [Pixels et règles automatiques](#pixels-regles) | 6 |
| [Statistiques et comparaisons](#statistiques) | 9 |
| [Autres outils](#autres) | 2 |

## Audiences et ciblage [#audiences]

### `meta_browse_targeting` [#meta_browse_targeting]

**Meta Ads: Browse Targeting** · lecture · rejouable

Finds Meta targeting options of a type (adinterest, adgeolocation, adeducationschool...) matching q, through the ad account's targetingsearch edge: the same lookup as search\_targeting. Up to 100 options per page, one page unless pages asks for more; suite tells whether options remain.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui | Ad account ID (act\_xxx). |
| `type` | `string` | oui | adinterest, adgeolocation, adeducationschool, etc. |
| `q` | `string` | oui | Search query: a term or a few characters. |
| `pages` | `number` | non | Maximum number of pages to follow (default 1). Meta counts a single call for a whole cursor run: following pages costs much less than asking for one large page, which Meta rejects for volume. |

### `meta_estimate_reach` [#meta_estimate_reach]

**Meta Ads: Estimate Reach** · lecture · rejouable

Estimated audience size of a targeting spec on a Meta ad account (reachestimate): users\_lower\_bound, users\_upper\_bound and estimate\_ready, for an optional optimization\_goal. Creates nothing.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui |   |
| `targeting_spec` | `object` | oui | Targeting spec: geo\_locations, age\_min, age\_max, etc. |
| `optimization_goal` | `string` | non | LINK\_CLICKS, REACH, IMPRESSIONS, etc. |

### `meta_get_custom_audience` [#meta_get_custom_audience]

**Meta Ads: Get Custom Audience** · lecture · rejouable

Details of one Meta custom audience by audience\_id: id, name, subtype, approximate size bounds, operation\_status and the owning account\_id.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `audience_id` | `string` | oui |   |
| `account_id` | `string` | non | Meta Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |

### `meta_get_delivery_estimate` [#meta_get_delivery_estimate]

**Meta Ads: Get Delivery Estimate** · lecture · rejouable

Meta delivery estimate: with adset\_id, for that existing ad set's own targeting and optimization goal (estimate\_mau\_lower\_bound, estimate\_mau\_upper\_bound, estimate\_ready); otherwise for a targeting\_spec on the ad account, with an optional optimization\_goal. One of adset\_id or targeting\_spec is required.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui | Ad account ID, with or without the act\_ prefix. |
| `targeting_spec` | `object` | non | Targeting spec (geo\_locations, age\_min, age\_max, etc.). Required without adset\_id. |
| `optimization_goal` | `string` | non | Optimization goal, e.g. LINK\_CLICKS or REACH. |
| `adset_id` | `string` | non | ID of an existing ad set: estimates with its own targeting (account\_id is then ignored). |

### `meta_list_custom_audiences` [#meta_list_custom_audiences]

**Meta Ads: List Custom Audiences** · lecture · rejouable

Lists the custom audiences of a Meta ad account with id, name, subtype, approximate size bounds (approximate\_count\_lower\_bound, approximate\_count\_upper\_bound) and description. Paginated: limit rows per page (default 100), one page unless pages asks for more; suite tells whether rows remain.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui |   |
| `limit` | `number` | non |   |
| `pages` | `number` | non | Maximum number of pages to follow (default 1). Meta counts a single call for a whole cursor run: following pages costs much less than asking for one large page, which Meta rejects for volume. |

### `meta_list_saved_audiences` [#meta_list_saved_audiences]

**Meta Ads: List Saved Audiences** · lecture · rejouable

Lists the saved audiences of a Meta ad account with id, name and targeting. Paginated: limit rows per page (default 100), one page unless pages asks for more; suite tells whether rows remain.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui |   |
| `limit` | `number` | non |   |
| `pages` | `number` | non | Maximum number of pages to follow (default 1). Meta counts a single call for a whole cursor run: following pages costs much less than asking for one large page, which Meta rejects for volume. |

### `meta_search_targeting` [#meta_search_targeting]

**Meta Ads: Search Targeting** · lecture · rejouable

Searches Meta targeting options (interests, locations...) by the term q and a type (adinterest, adgeolocation...), through the ad account's targetingsearch edge: the same lookup as browse\_targeting. Up to 100 options per page, one page unless pages asks for more; suite tells whether options remain.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui | Ad account ID (act\_xxx). |
| `q` | `string` | oui | Search term. |
| `type` | `string` | oui | adinterest, adgeolocation, etc. |
| `pages` | `number` | non | Maximum number of pages to follow (default 1). Meta counts a single call for a whole cursor run: following pages costs much less than asking for one large page, which Meta rejects for volume. |

### `meta_validate_targeting` [#meta_validate_targeting]

**Meta Ads: Validate Targeting** · lecture · rejouable

Sends a Meta targeting spec to the ad account's targetingvalidation edge and returns Meta's answer under data; valid only means the call succeeded. Creates and changes nothing.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui | Ad account ID, with or without the act\_ prefix. |
| `targeting_spec` | `object` | oui | Targeting spec to validate. |

## Campagnes, ensembles et publicités [#campagnes]

### `meta_get_ad` [#meta_get_ad]

**Meta Ads: Get Ad** · lecture · rejouable

Details of one Meta ad by ad\_id: id, name, status, adset\_id, creative (its id) and the owning account\_id.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `ad_id` | `string` | oui |   |
| `account_id` | `string` | non | Meta Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |

### `meta_get_ad_rejections` [#meta_get_ad_rejections]

**Meta Ads: Get Ad Rejections** · lecture · rejouable

Lists the ads of a Meta ad account whose effective status is DISAPPROVED or WITH\_ISSUES, with id, name, effective\_status and issues\_info (the rejection or issue details). Paginated: limit rows per page (default 50), one page unless pages asks for more; suite tells whether rows remain.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui |   |
| `limit` | `number` | non |   |
| `pages` | `number` | non | Maximum number of pages to follow (default 1). Meta counts a single call for a whole cursor run: following pages costs much less than asking for one large page, which Meta rejects for volume. |

### `meta_get_adset` [#meta_get_adset]

**Meta Ads: Get Ad Set** · lecture · rejouable

Details of one Meta ad set by adset\_id: id, name, status, daily\_budget, lifetime\_budget (in the currency's minor unit), targeting and the owning account\_id.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `adset_id` | `string` | oui |   |
| `account_id` | `string` | non | Meta Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |

### `meta_get_campaign` [#meta_get_campaign]

**Meta Ads: Get Campaign** · lecture · rejouable

Details of one Meta campaign by campaign\_id: id, name, status, objective, daily\_budget, lifetime\_budget (in the currency's minor unit) and the owning account\_id.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `campaign_id` | `string` | oui |   |
| `account_id` | `string` | non | Meta Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |

### `meta_list_ad_labels` [#meta_list_ad_labels]

**Meta Ads: List Ad Labels** · lecture · rejouable

Lists the ad labels of a Meta ad account with id, name and created\_time. Paginated: limit rows per page (default 100), one page unless pages asks for more; suite tells whether rows remain.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui |   |
| `limit` | `number` | non |   |
| `pages` | `number` | non | Maximum number of pages to follow (default 1). Meta counts a single call for a whole cursor run: following pages costs much less than asking for one large page, which Meta rejects for volume. |

### `meta_list_ads` [#meta_list_ads]

**Meta Ads: List Ads** · lecture · rejouable

Lists the ads of a Meta ad account with id, name, status, effective\_status, adset\_id, campaign\_id, campaign name, creative id and created\_time. with\_creative: true expands the creative (title, body, image and 1080x1080 thumbnail URLs, image\_hash, video\_id, object\_story\_spec for carousels, asset\_feed\_spec for dynamic formats). Paginated: limit rows per page (default 100), one page unless pages asks for more; suite tells whether rows remain.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui |   |
| `limit` | `number` | non |   |
| `with_creative` | `boolean` | non |   |
| `pages` | `number` | non | Maximum number of pages to follow (default 1). Meta counts a single call for a whole cursor run: following pages costs much less than asking for one large page, which Meta rejects for volume. |

### `meta_list_adsets` [#meta_list_adsets]

**Meta Ads: List Ad Sets** · lecture · rejouable

Lists the ad sets of a Meta ad account with id, name, status, daily\_budget, lifetime\_budget (in the currency's minor unit), campaign\_id and targeting. Paginated: limit rows per page (default 100), one page unless pages asks for more; suite tells whether rows remain.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui |   |
| `limit` | `number` | non |   |
| `pages` | `number` | non | Maximum number of pages to follow (default 1). Meta counts a single call for a whole cursor run: following pages costs much less than asking for one large page, which Meta rejects for volume. |

### `meta_list_campaigns` [#meta_list_campaigns]

**Meta Ads: List Campaigns** · lecture · rejouable

Lists the campaigns of a Meta ad account with id, name, status, objective, daily\_budget, lifetime\_budget and created\_time; budgets are in the currency's minor unit (cents for EUR or USD). status filters on effective\_status (ACTIVE, PAUSED...). Paginated: limit rows per page (default 100), one page unless pages asks for more; suite tells whether rows remain.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui |   |
| `limit` | `number` | non |   |
| `status` | `string` | non |   |
| `pages` | `number` | non | Maximum number of pages to follow (default 1). Meta counts a single call for a whole cursor run: following pages costs much less than asking for one large page, which Meta rejects for volume. |

## Comptes [#comptes]

### `meta_check_account_issues` [#meta_check_account_issues]

**Meta Ads: Check Account Issues** · lecture · rejouable

Checks a Meta ad account for problems: reads account\_status, disable\_reason, spend\_cap, amount\_spent and the funding source, and returns them with a list of issues: account not active (account\_status other than 1), a disable reason, or more than 90% of the spend cap used.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui |   |

### `meta_get_account` [#meta_get_account]

**Meta Ads: Get Account** · lecture · rejouable

Details of a Meta ad account: id, name, account\_status, currency, timezone\_name and spend\_cap. Legacy tool, kept for compatibility.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui |   |

### `meta_get_activities` [#meta_get_activities]

**Meta Ads: Get Activities** · lecture · rejouable

Change history of a Meta ad account: activity events with event\_type, event\_time, object\_id and actor\_id. Paginated: limit rows per page (default 100), one page unless pages asks for more; suite tells whether rows remain.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui |   |
| `limit` | `number` | non |   |
| `pages` | `number` | non | Maximum number of pages to follow (default 1). Meta counts a single call for a whole cursor run: following pages costs much less than asking for one large page, which Meta rejects for volume. |

### `meta_get_ad_account_activities` [#meta_get_ad_account_activities]

**Meta Ads: Get Ad Account Activities** · lecture · rejouable

Recent activity log of a Meta ad account (who changed what): event\_type, event\_time, object\_id, object\_name, actor\_id, actor\_name and extra\_data, limit entries (default 50), first page only.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui | Ad account ID, with or without the act\_ prefix. |
| `limit` | `number` | non | Maximum number of results (default 50). |

### `meta_get_minimum_budgets` [#meta_get_minimum_budgets]

**Meta Ads: Get Minimum Budgets** · lecture · rejouable

Minimum daily budgets Meta accepts on an ad account: currency, min\_daily\_budget\_imp and min\_daily\_budget\_high\_freq. Useful to check a proposed ad set budget.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui |   |

### `meta_list_accounts` [#meta_list_accounts]

**Meta Ads: List Accounts** · lecture · rejouable

Lists the Meta ad accounts of the connected Meta user with id, name, account\_status and currency, first page only. Legacy tool, kept for compatibility.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | non | Meta Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |

## Créations [#creations]

### `meta_get_ad_creative` [#meta_get_ad_creative]

**Meta Ads: Get Ad Creative** · lecture · rejouable

Details of one Meta ad creative by creative\_id: id, name, title, body, image\_url, thumbnail\_url and the owning account\_id.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `creative_id` | `string` | oui |   |
| `account_id` | `string` | non | Meta Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |

### `meta_get_ad_images` [#meta_get_ad_images]

**Meta Ads: Get Ad Images** · lecture · rejouable

Resolves Meta image hashes (from a creative or a carousel card) into full-size image URLs for an ad account: hash, url, width, height, permalink\_url and url\_128. Pass all hashes in one call; up to 10 pages are followed.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui |   |
| `hashes` | `any[]` | oui |   |

### `meta_list_ad_creatives` [#meta_list_ad_creatives]

**Meta Ads: List Ad Creatives** · lecture · rejouable

Lists the ad creatives of a Meta ad account with id, name, title, body, image\_url and thumbnail\_url. Paginated: limit rows per page (default 100), one page unless pages asks for more; suite tells whether rows remain.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui |   |
| `limit` | `number` | non |   |
| `pages` | `number` | non | Maximum number of pages to follow (default 1). Meta counts a single call for a whole cursor run: following pages costs much less than asking for one large page, which Meta rejects for volume. |

### `meta_list_ad_images` [#meta_list_ad_images]

**Meta Ads: List Ad Images** · lecture · rejouable

Lists the images of a Meta ad account's library with id, name, url and hash. Paginated: limit rows per page (default 100), one page unless pages asks for more; suite tells whether rows remain.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui |   |
| `limit` | `number` | non |   |
| `pages` | `number` | non | Maximum number of pages to follow (default 1). Meta counts a single call for a whole cursor run: following pages costs much less than asking for one large page, which Meta rejects for volume. |

### `meta_list_ad_videos` [#meta_list_ad_videos]

**Meta Ads: List Ad Videos** · lecture · rejouable

Lists the videos of a Meta ad account's library with id, title, source and length. Paginated: limit rows per page (default 100), one page unless pages asks for more; suite tells whether rows remain.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui |   |
| `limit` | `number` | non |   |
| `pages` | `number` | non | Maximum number of pages to follow (default 1). Meta counts a single call for a whole cursor run: following pages costs much less than asking for one large page, which Meta rejects for volume. |

## Pixels et règles automatiques [#pixels-regles]

### `meta_get_automated_rule` [#meta_get_automated_rule]

**Meta Ads: Get Automated Rule** · lecture · rejouable

Details of one Meta automated rule by rule\_id: id, name, status, evaluation\_spec, execution\_spec, schedule\_spec, created\_time, updated\_time and the owning account\_id.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `rule_id` | `string` | oui | Automated rule ID. |
| `account_id` | `string` | non | Meta Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |

### `meta_get_pixel` [#meta_get_pixel]

**Meta Ads: Get Pixel** · lecture · rejouable

Details of one Meta pixel by pixel\_id: id, name, creation\_time, last\_fired\_time, is\_unavailable, code and the owning ad account (owner\_ad\_account).

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `pixel_id` | `string` | oui | Pixel ID. |
| `account_id` | `string` | non | Meta Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |

### `meta_get_pixel_stats` [#meta_get_pixel_stats]

**Meta Ads: Get Pixel Stats** · lecture · rejouable

Event statistics of one Meta pixel by pixel\_id (its stats edge), optionally between start\_time and end\_time.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `pixel_id` | `string` | oui | Pixel ID. |
| `start_time` | `string` | non | Start date (YYYY-MM-DD). |
| `end_time` | `string` | non | End date (YYYY-MM-DD). |
| `account_id` | `string` | non | Meta Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |

### `meta_get_rule_history` [#meta_get_rule_history]

**Meta Ads: Get Rule History** · lecture · rejouable

Execution history of one Meta automated rule by rule\_id (its history edge), limit entries (default 25).

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `rule_id` | `string` | oui | Automated rule ID. |
| `limit` | `number` | non |   |
| `account_id` | `string` | non | Meta Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |

### `meta_list_automated_rules` [#meta_list_automated_rules]

**Meta Ads: List Automated Rules** · lecture · rejouable

Lists the automated rules of a Meta ad account (its ad rules library) with id, name, status and evaluation\_spec. Paginated: limit rows per page (default 100), one page unless pages asks for more; suite tells whether rows remain.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui |   |
| `limit` | `number` | non |   |
| `pages` | `number` | non | Maximum number of pages to follow (default 1). Meta counts a single call for a whole cursor run: following pages costs much less than asking for one large page, which Meta rejects for volume. |

### `meta_list_pixels` [#meta_list_pixels]

**Meta Ads: List Pixels** · lecture · rejouable

Lists the Meta pixels of an ad account with id, name and code (the pixel's base code). Paginated: limit rows per page (default 100), one page unless pages asks for more; suite tells whether rows remain.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui |   |
| `limit` | `number` | non |   |
| `pages` | `number` | non | Maximum number of pages to follow (default 1). Meta counts a single call for a whole cursor run: following pages costs much less than asking for one large page, which Meta rejects for volume. |

## Statistiques et comparaisons [#statistiques]

### `meta_compare_campaigns_performance` [#meta_compare_campaigns_performance]

**Meta Ads: Compare Campaigns Performance** · lecture · rejouable

Compares Meta campaigns side by side: for each ID in campaign\_ids, its insights over date\_preset (default last\_30d) with the requested metrics (default spend, impressions, clicks, ctr, cpc) and the owning account\_id. A campaign without delivery gets insights: null.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `campaign_ids` | `any[]` | oui |   |
| `date_preset` | `string` | non |   |
| `metrics` | `any[]` | non |   |
| `account_id` | `string` | non | Meta Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |

### `meta_compare_periods_performance` [#meta_compare_periods_performance]

**Meta Ads: Compare Periods Performance** · lecture · rejouable

Compares a Meta ad account over two date presets, period1 and period2 (e.g. last\_7d and last\_14d): account-level insights for each, with the same fields as get\_account\_insights. Each preset is read as Meta defines it, so last\_14d also covers the last 7 days.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui |   |
| `period1` | `string` | oui | last\_7d, last\_14d, etc. |
| `period2` | `string` | oui | last\_7d, last\_14d, etc. |

### `meta_get_account_insights` [#meta_get_account_insights]

**Meta Ads: Get Account Insights** · lecture · rejouable

Performance insights of a Meta ad account: spend, impressions, clicks, CPC, CPM, CTR, reach, frequency, actions, conversions, cost\_per\_action\_type, action\_values, purchase\_roas, video plays and quartiles, with the campaign, ad set and ad IDs and names. level is account, campaign, adset or ad (default account); the window is date\_preset (default last\_7d) or time\_range, which takes precedence; time\_increment splits it by days, breakdowns adds dimensions, champs requests fewer fields and filtrage passes raw Meta filters. Paginated: limit rows per page (default 100), one page unless pages asks for more; suite tells whether rows remain.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui |   |
| `date_preset` | `string` | non |   |
| `level` | `string` | non |   |
| `limit` | `number` | non |   |
| `pages` | `number` | non | Maximum number of pages to follow (default 1). Meta counts a single call for a whole cursor run: following pages costs much less than asking for one large page, which Meta rejects for volume. |
| `breakdowns` | `any[]` | non | Optional breakdowns (age, gender, device\_platform, publisher\_platform, platform\_position, country, region, impression\_device, hourly\_stats\_aggregated\_by\_advertiser\_time\_zone); any other value is refused. Not all of them combine: when unsure, ask for one only. |
| `time_increment` | `number` | non | Splits the results into periods of N days: 1 gives one row per day. Omitted: a single total for the whole window. |
| `time_range` | `object` | non | Explicit window \{ since: 'YYYY-MM-DD', until: 'YYYY-MM-DD' \}, both bounds INCLUDED. Takes precedence over date\_preset. |
| `champs` | `any[]` | non | Subset of fields to request. Intersected with the default field list, plus video\_thruplay\_watched\_actions and the three quality rankings (quality\_ranking, engagement\_rate\_ranking, conversion\_rate\_ranking), returned only when named. An empty or missing list, or one with no known field, requests the default list. |
| `filtrage` | `any[]` | non | Raw Meta filters, e.g. \[\{ field: 'ad.id', operator: 'IN', value: \[...\] \}\]. Omitted: no filter. |

### `meta_get_account_performance_summary` [#meta_get_account_performance_summary]

**Meta Ads: Get Account Performance Summary** · lecture · rejouable

Key figures of a Meta ad account over date\_preset (default last\_30d): spend, impressions, clicks, CTR, CPC, CPM, reach and purchase conversions (purchase and omni\_purchase actions). Purchase values are not requested from Meta, so conversionValue stays 0 and roas stays null: get\_account\_insights returns action\_values and purchase\_roas.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui |   |
| `date_preset` | `string` | non |   |

### `meta_get_ad_insights` [#meta_get_ad_insights]

**Meta Ads: Get Ad Insights** · lecture · rejouable

Performance insights of one Meta ad by ad\_id, with the same fields as get\_account\_insights plus the owning account\_id, over date\_preset (default last\_7d), with optional breakdowns. Only the first page of rows is returned.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `ad_id` | `string` | oui |   |
| `date_preset` | `string` | non |   |
| `breakdowns` | `any[]` | non | Optional breakdowns (age, gender, device\_platform, publisher\_platform, platform\_position, country, region, impression\_device, hourly\_stats\_aggregated\_by\_advertiser\_time\_zone); any other value is refused. Not all of them combine: when unsure, ask for one only. |
| `account_id` | `string` | non | Meta Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |

### `meta_get_adset_insights` [#meta_get_adset_insights]

**Meta Ads: Get Ad Set Insights** · lecture · rejouable

Performance insights of one Meta ad set by adset\_id, with the same fields as get\_account\_insights plus the owning account\_id, over date\_preset (default last\_7d), with optional breakdowns. Only the first page of rows is returned.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `adset_id` | `string` | oui |   |
| `date_preset` | `string` | non |   |
| `breakdowns` | `any[]` | non | Optional breakdowns (age, gender, device\_platform, publisher\_platform, platform\_position, country, region, impression\_device, hourly\_stats\_aggregated\_by\_advertiser\_time\_zone); any other value is refused. Not all of them combine: when unsure, ask for one only. |
| `account_id` | `string` | non | Meta Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |

### `meta_get_campaign_insights` [#meta_get_campaign_insights]

**Meta Ads: Get Campaign Insights** · lecture · rejouable

Performance insights of one Meta campaign by campaign\_id, with the same fields as get\_account\_insights plus the owning account\_id, over date\_preset (default last\_7d), with optional breakdowns. Only the first page of rows is returned.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `campaign_id` | `string` | oui |   |
| `date_preset` | `string` | non |   |
| `breakdowns` | `any[]` | non | Optional breakdowns (age, gender, device\_platform, publisher\_platform, platform\_position, country, region, impression\_device, hourly\_stats\_aggregated\_by\_advertiser\_time\_zone); any other value is refused. Not all of them combine: when unsure, ask for one only. |
| `account_id` | `string` | non | Meta Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |

### `meta_get_daily_spend_breakdown` [#meta_get_daily_spend_breakdown]

**Meta Ads: Get Daily Spend Breakdown** · lecture · rejouable

Daily spend, impressions and clicks of a Meta ad account, one row per day, over date\_preset (default last\_30d), at level account, campaign or adset (default account). Only the first page of rows is returned.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui |   |
| `date_preset` | `string` | non |   |
| `level` | `string` | non |   |

### `meta_get_insights` [#meta_get_insights]

**Meta Ads: Get Insights** · lecture · rejouable

Insights of a Meta ad account between since and until (YYYY-MM-DD; both are needed, otherwise Meta's default window applies), at level account, campaign, adset or ad (default account), with the same fields as get\_account\_insights. Paginated: limit rows per page (default 100), one page unless pages asks for more; suite tells whether rows remain. Legacy tool, kept for compatibility.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui |   |
| `level` | `string` | non |   |
| `since` | `string` | non |   |
| `until` | `string` | non |   |
| `limit` | `number` | non |   |
| `pages` | `number` | non | Maximum number of pages to follow (default 1). Meta counts a single call for a whole cursor run: following pages costs much less than asking for one large page, which Meta rejects for volume. |

## Autres outils [#autres]

### `meta_get_top_performing_ads` [#meta_get_top_performing_ads]

**Meta Ads: Get Top Performing Ads** · lecture · rejouable

The top\_n ads (default 10) of a Meta ad account with the highest value of a metric: roas (default), spend, ctr or cpc, over date\_preset (default last\_7d). Each row has ad\_id, ad\_name, spend, impressions, clicks, ctr, cpc, actions, action\_values and roas, computed as purchase value over spend (0 when unknown). With cpc, the highest cost comes first. Ranks at most the first 500 ad rows Meta returns.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui |   |
| `metric` | `string` | non |   |
| `top_n` | `number` | non |   |
| `date_preset` | `string` | non |   |

### `meta_get_worst_performing_ads` [#meta_get_worst_performing_ads]

**Meta Ads: Get Worst Performing Ads** · lecture · rejouable

The bottom\_n ads (default 10) of a Meta ad account with the lowest value of a metric: ctr (default), cpc or spend, over date\_preset (default last\_7d). Each row has ad\_id, ad\_name, spend, impressions, clicks, ctr and cpc. With cpc, the lowest cost comes first. Ranks at most the first 500 ad rows Meta returns.

| Paramètre | Type | Requis | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | oui |   |
| `metric` | `string` | non |   |
| `bottom_n` | `number` | non |   |
| `date_preset` | `string` | non |   |