Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Retrieve Microsoft Ads optimisation recommendations for an account: budget increases, new keywords, broad match changes, conflicting negative keywords and responsive search ad suggestions, each wit…
| App | Microsoft Ads |
| Operation ID | microsoft_ads_list_recommendations |
| Type | Action |
| Connection | microsoft_ads (required) |
| Credits per run | 1 |
| Agent / MCP tool | Yes |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
account | DynamicAccount | Yes | - | Microsoft Ads account to read recommendations for. |
recommendation_types | string or array of string | No | - | Which recommendations to retrieve, as a list or comma separated. Valid values are ADD_BROAD_MATCH_KEYWORD, CAMPAIGN_BUDGET, KEYWORD, REMOVE_CONFLICTING_NEGATIVE_KEYWORD, RESPONSIVE_SEARCH_AD and RESPONSIVE_SEARCH_AD_ASSET. Leave empty to request all of them. Microsoft requires at least one and rejects any other value. |
max_count | integer | No | - | Maximum recommendations to return. Leave empty for all available. |
List[Dict]
Returns pending recommendations. Type-specific fields such as recommended_budget or suggested_keyword appear only on the matching type.
Fields: recommendation_id, recommendation_type, campaign_id, campaign_name, ad_group_name, estimated_increase_in_clicks, estimated_increase_in_conversions, estimated_increase_in_cost