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

writeAmazon Adsads.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

In an AI client (MCP)

tools/call

{
  "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>"
  }
}

From code (Tool API)

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>"}'

Early access — the Tool API is open on request, contact us.

Arguments

Name	Type	Description
`store`required	`string`	the store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim.
`country_code`required	`string`	the Ads profile's 2-letter country code (e.g. 'US').
`audience_name`required	`string`	shown in the Ads console; use a new name for each audience.
`sql_query`required	`string`	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`required	`string · date-time`	UTC 'YYYY-MM-DDTHH:MM:SSZ'.
`time_window_end`required	`string · date-time`	UTC 'YYYY-MM-DDTHH:MM:SSZ'.
`lookalike_audience_expected_reach`required	`string`	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

Every tool answers {notification, data, human_action}; data carries:

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).

ads_create_lookalike_audience

Call itCopy Anchor Link

ArgumentsCopy Anchor Link

ResultCopy Anchor Link

Body (Amazon schema)Copy Anchor Link

GotchasCopy Anchor Link

On this page

Call it

Arguments

Result

Body (Amazon schema)

Gotchas