TopOverlappingAudiences

POST

/insights/topOverlappingAudiences

最后修改时间：2026-08-27 23:20:27

责任人：未设置

获取与输入表达式重叠的热门受众。

授权资源类型：
DSP Rodeo Entity ID、DSP 广告商账户 ID

参数名称：
Amazon-Advertising-AccountId

参数位置：
header

需要以下权限之一：
["campaign_edit"]

请求参数

Query 参数

Header 参数

Body 参数application/vnd.topoverlappingaudiencesinputexpression.v1+json必填

示例

使用受众定向表达式作为输入的 TopOverlappingAudiences API 输入表达式示例。

{
    "audienceTargetingExpression": {
        "audiences": [
            {
                "audienceId": "12345",
                "groupId": "customerProvidedString1",
                "negative": "false"
            },
            {
                "audienceId": "23456",
                "groupId": "customerProvidedString1",
                "negative": "false"
            }
        ]
    },
    "categoryFilter": [
        "THIRD_PARTY"
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://advertising-api.amazon.com/insights/topOverlappingAudiences?advertiserId=undefined&maxResults=undefined&nextToken=undefined' \
--header 'Amazon-Advertising-API-ClientId;' \
--header 'Amazon-Advertising-API-Scope;' \
--header 'Content-Type: application/vnd.topoverlappingaudiencesinputexpression.v1+json' \
--data '{
    "audienceTargetingExpression": {
        "audiences": [
            {
                "audienceId": "12345",
                "groupId": "customerProvidedString1",
                "negative": "false"
            },
            {
                "audienceId": "23456",
                "groupId": "customerProvidedString1",
                "negative": "false"
            }
        ]
    },
    "categoryFilter": [
        "THIRD_PARTY"
    ]
}'

返回响应

🟢200成功

application/vnd.topoverlappingaudiencesinsights.v1+json

操作成功。

Bodyapplication/vnd.topoverlappingaudiencesinsights.v1+json

示例

{}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠415

🟠429

🔴500服务器错误

修改于 2026-08-27 23:20:27

TopCategoriesPurchased

getAsinEngagementForStore