ads_insights_get_audiences_overlapping_audiences
Get the audiences that OVERLAP one given audience segment — audience-overlap insights for a single audienceId, not a catalog of audiences.
readAmazon Adsads.insights
Amazon Ads API · insightsGetAudiencesOverlappingAudiences · GET /insights/audiences/{audienceId}/overlappingAudiences Docs: https://advertising.amazon.com/API/docs/en-us/overlapping-audiences#tag/Audience-insights/operation/insightsGetAudiencesOverlappingAudiences
Call it
In an AI client (MCP)
{
"name": "ads_insights_get_audiences_overlapping_audiences",
"arguments": {
"store": "myStore-US",
"countryCode": "<countryCode>",
"audienceId": "<audienceId>",
"ad_type": "DSP"
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/ads_insights_get_audiences_overlapping_audiences \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US","countryCode":"<countryCode>","audienceId":"<audienceId>","ad_type":"DSP"}'Early access — the Tool API is open on request, contact us.
Arguments
| Name | Type | Description |
|---|---|---|
storerequired | string | the store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim. |
countryCoderequired | string | the Ads profile's 2-letter country code (e.g. 'US'). |
audienceIdrequired | string | the one audience segment to fetch overlap insights for — there is no list-all mode; sent inside the request body as body.audienceId. |
ad_typerequired | string | Amazon's adType — the ad program whose audiences are compared; DSP also needs body.advertiserId. Allowed: DSP | SD.DSPSD |
body | object | optional query parameters — adType comes from ad_type; advertiserId (required for DSP, from ads_dsp_advertisers), minimumOverlapAffinity / maximumOverlapAffinity (≥ 0), audienceCategory (list, 1–20), maxResults (1–500, default 30), nextToken. |
Result
Every tool answers {notification, data, human_action}; data carries:
- Amazon's payload in data.result.
Params (Amazon schema)
audienceId*: string
adType*: DSP | SD
advertiserId: string
minimumOverlapAffinity: number (min 0)
maximumOverlapAffinity: number (min 0) — if specified, the affinities of all returned overlapping audiences will be at most the provided affinity
audienceCategory: [string] (max 20)
maxResults: integer (1–500)
nextToken: stringGotchas
- For standard SP brand performance use ads_generate_brand_metrics_report / ads_get_brand_metrics_report instead.