> ## 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 Bid Recommendations

> Gets Sponsored Products bid recommendations for keywords and targeting expressions

Gets Sponsored Products bid recommendations for keywords and targeting expressions. Feed the suggested bids into amazon\_ads\_create\_targets or amazon\_ads\_update\_targets.

|                      |                                      |
| -------------------- | ------------------------------------ |
| **App**              | Amazon Ads                           |
| **Operation ID**     | `amazon_ads_get_bid_recommendations` |
| **Type**             | Action                               |
| **Connection**       | `amazon_ads` (required)              |
| **Credits per run**  | 1                                    |
| **Agent / MCP tool** | Yes                                  |

## Inputs

| Field                   | Type                                                    | Required | Default | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ----------------------- | ------------------------------------------------------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `account`               | DynamicAccount                                          | Yes      | -       | Select the Amazon Ads profile to get bid recommendations for.                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `recommend_for`         | string or SelectableOption                              | Yes      | -       | Get Sponsored Products theme-based bid recommendations for an existing ad group or for a new ad group planned around a list of ASINs. Options: existing\_ad\_group or new\_ad\_group.                                                                                                                                                                                                                                                                                                                       |
| `campaign_id`           | string or SelectItem                                    | No       | -       | The campaign of the ad group. Required when recommend\_for is existing\_ad\_group.                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `ad_group_id`           | string or SelectItem                                    | No       | -       | The ad group to recommend bids for. Required when recommend\_for is existing\_ad\_group.                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `asins`                 | array of string (also accepts a comma-separated string) | No       | -       | The ad ASINs planned for the new ad group, as a list or comma-separated text. Required when recommend\_for is new\_ad\_group.                                                                                                                                                                                                                                                                                                                                                                               |
| `targeting_expressions` | array of object or string                               | Yes      | -       | Raw Amazon targeting expressions to get bid recommendations for, sent as-is (up to 100). Each entry: \{"type": ...} with optional "value". Types: CLOSE\_MATCH, LOOSE\_MATCH, SUBSTITUTES, COMPLEMENTS (auto targeting); KEYWORD\_BROAD\_MATCH, KEYWORD\_PHRASE\_MATCH, KEYWORD\_EXACT\_MATCH with a keyword value; PAT\_ASIN, PAT\_CATEGORY, PAT\_CATEGORY\_REFINEMENT with an ASIN or category value. Example: \[\{"type": "KEYWORD\_EXACT\_MATCH", "value": "running shoes"}, \{"type": "CLOSE\_MATCH"}] |
| `bidding`               | object or string                                        | No       | -       | Only for new\_ad\_group: the raw bidding control configuration of the planned campaign, sent as-is. Example: \{"strategy": "AUTO\_FOR\_SALES"}                                                                                                                                                                                                                                                                                                                                                              |
| `include_analysis`      | boolean                                                 | No       | `False` | Include bid analyzer impact data with the recommendations. Default false.                                                                                                                                                                                                                                                                                                                                                                                                                                   |

### SelectItem

| Field   | Type   | Required | Default | Description                                                                                          |
| ------- | ------ | -------- | ------- | ---------------------------------------------------------------------------------------------------- |
| `value` | string | Yes      | -       | The value of the selectable item.                                                                    |
| `label` | string | Yes      | -       | The label of the selectable item, used for display purposes. If not provided, defaults to the value. |

### SelectableOption

| Field   | Type   | Required | Default | Description |
| ------- | ------ | -------- | ------- | ----------- |
| `value` | string | Yes      | -       |             |
| `label` | string | Yes      | -       |             |

## Output

**Type**: `Dict`

Returns suggested bid ranges per targeting expression.
