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.
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.
Familles d'outils
| Famille | Outils |
|---|---|
| Audiences et ciblage | 8 |
| Campagnes, ensembles et publicités | 8 |
| Comptes | 6 |
| Créations | 5 |
| Pixels et règles automatiques | 6 |
| Statistiques et comparaisons | 9 |
| Autres outils | 2 |
Audiences et ciblage
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 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 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 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 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 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 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 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
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 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 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 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 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 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 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 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
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 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 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 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 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 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
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 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 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 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 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
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 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 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 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 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 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
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 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 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 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 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 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 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 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 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
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 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 |