# ads_create_lookalike_audience (https://sellersheetai.com/docs/mcp-api/tools/ads_create_lookalike_audience)

> Create an AMC lookalike audience: Amazon models shoppers similar to a seed the AMC query selects (for example the store's ad clickers) and activates them in the store's sponsored-a

Access: **WRITE** · toolset amazon_ads · family ads.amc-audiences

ds account. Ask the seller first. Amazon Ads API · createLookalikeAudience · POST /amc/audiences/lookalike Docs: https://advertising.amazon.com/API/docs/en-us/amc-rba#tag/Rule-based-audience-lookalike/operation/createLookalikeAudience Gate: commit — interactive: restate exactly what will happen, wait for a typed CONFIRM; autopilot: only within the seller's instruction and stated limits; otherwise ask.

## Call it

MCP tool call:

```json
{
  "name": "ads_create_lookalike_audience",
  "arguments": {
    "store": "myStore-US",
    "country_code": "<country_code>",
    "audience_name": "<audience_name>",
    "sql_query": "<sql_query>",
    "time_window_start": "<time_window_start>",
    "time_window_end": "<time_window_end>",
    "lookalike_audience_expected_reach": "<lookalike_audience_expected_reach>"
  }
}
```

Tool API (early access — contact us):

```bash
curl -X POST https://api.sellersheetai.com/api/v1/tools/ads_create_lookalike_audience \
  -H "Authorization: Bearer $SELLERSHEET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"store":"myStore-US","country_code":"<country_code>","audience_name":"<audience_name>","sql_query":"<sql_query>","time_window_start":"<time_window_start>","time_window_end":"<time_window_end>","lookalike_audience_expected_reach":"<lookalike_audience_expected_reach>"}'
```

## Arguments

| Name | Type | Required | Description |
|---|---|---|---|
| `store` | string | yes | the store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim. |
| `country_code` | string | yes | the Ads profile's 2-letter country code (e.g. 'US'). |
| `audience_name` | string | yes | shown in the Ads console; use a new name for each audience. |
| `sql_query` | string | yes | AMC SQL over the *_for_audiences tables whose SELECT returns user_id — the seed, 500 to 500,000 shoppers (count it first with ads_create_workflow_execution). |
| `time_window_start` | string · date-time | yes | UTC 'YYYY-MM-DDTHH:MM:SSZ'. |
| `time_window_end` | string · date-time | yes | UTC 'YYYY-MM-DDTHH:MM:SSZ'. |
| `lookalike_audience_expected_reach` | string | yes | how far from the seed to reach. Allowed: MOST_SIMILAR \| SIMILAR \| BALANCED \| BROAD \| MOST_BROAD. MOST_SIMILAR gives the smallest, closest audience (about 500K–1M shoppers in Europe and the Americas, 200K–300K in Asia); MOST_BROAD the largest. |
| `audience_description` | string |  | optional text shown with the audience. |
| `time_window_relative` | boolean |  | true to move the seed's window forward at each refresh. |
| `parameter_values` | object |  | values for parameters the SQL declares. |

## Result

- `data.audience_execution_id` — poll it with ads_get_query_based_audience_by_audience_execution_id.
- `data.status` — PENDING at first.

## Body (Amazon schema)

- advertiserId*: string audienceDescription: string audienceName*: string countryCode: AE | AU | BR | CA | DE | ES | FR | IN | IT | JP | MX | NL | SA | SE | TR | UK | US inputParameters: [{columnType: DIMENSION | METRIC, dataType*: string | {elementDataType, elementNullable, type} | {precision, type} | {keyDataType, type, valueDataType, valueNullable} | {fields, type}, defaultValue, description, name*}] (max 100) inputParameters.dataType.type: ARRAY | DECIMAL | MAP | STRUCT parameterValues: object query: string refreshRateDays: integer (7–21; default 21) timeWindowEnd*: string (date-time) timeWindowRelative: boolean (default False) timeWindowStart*: string (date-time) workflowId: string lookalikeAudienceExpectedReach*: string

## Gotchas

- Gate: commit — the audience goes to the seller's ads account and cannot be changed.
- Only the lookalike is created, not a copy of the seed.
- A seed that clears 500 in an AMC count can still FAIL after about 20 minutes with "did
- not find a sufficient match for seed users" (measured: 716 ad clickers over 28 days) —
- Amazon keeps only shoppers it can match; seed broadly (reach, or a longer window).