> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Keyword Traffic Estimates

> Estimate the clicks, impressions, cost, click-through rate and position keywords would deliver at a given bid on Microsoft Ads

Estimate the clicks, impressions, cost, click-through rate and position keywords would deliver at a given bid on Microsoft Ads. Every figure comes back as a low and high band rather than a single number, and the bid drives the result as much as the keywords do.

| | |
| - | - |
| **App** | Microsoft Ads |
| **Operation ID** | `microsoft_ads_get_keyword_traffic_estimates` |
| **Type** | Action |
| **Connection** | `microsoft_ads` (required) |
| **Credits per run** | 1 |
| **Agent / MCP tool** | Yes |

## Inputs

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `account` | object or array of object or MicrosoftAdsAccountItem or string or integer | Yes | - | Microsoft Ads account the estimate is run for. |
| `keywords` | string or array of string | Yes | - | Keywords to estimate, as a list or one per line. Up to 1000 per run. |
| `match_type` | enum (`Exact`, `Phrase`, `Broad`) | No | `Exact` | Match type applied to every keyword in this run. |
| `max_cpc` | number | Yes | - | Bid to estimate at, in the account currency. The estimate is driven by this as much as by the keywords, so compare a few values. |
| `daily_budget` | number | No | - | Planned daily budget, which caps the estimated volume. |
| `language` | string | No | `English` | Language name, for example English or French. |
| `location_id` | integer or string | No | `190` | Microsoft location ID for the estimate. 190 is the United States. microsoft\_ads\_search\_locations finds other IDs. |
| `currency` | string | No | - | Three letter currency code. Defaults to the account currency. |

### MicrosoftAdsAccountItem

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `value` | string | Yes | - | |
| `label` | string | Yes | - | |
| `customerId` | string | No | - | The Microsoft Ads customer ID used for REST CustomerId headers. If omitted, it is resolved from the account ID. |

## Output

**Type**: `List[Dict]`

Returns one row per keyword with a low and high band for each metric.

**Fields**: `keyword`, `match_type`, `max_cpc`, `min_clicks`, `max_clicks`, `min_impressions`, `max_impressions`, `min_total_cost`, `max_total_cost`, `min_average_position`, `max_average_position`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.