Gets audience segments based on filters

POST

/audiences/list

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

责任人：未设置

返回某广告主的受众细分列表。可通过提供 Filter 对象数组来筛选结果集。结果集中的每一项都将匹配所有指定的筛选条件。

授权资源类型：
DSP Rodeo Entity ID, DSP Advertiser Account ID

参数名称：
Amazon-Advertising-AccountId

参数位置：
header

需要以下权限之一：
["advertiser_campaign_edit","advertiser_campaign_view","campaign_edit","ads_planner_internal_edit","ads_planner_edit"]

授权资源类型：
DSP Rodeo Entity ID, DSP Advertiser Account ID

参数名称：
Amazon-Ads-AccountId

参数位置：
header

需要以下权限之一：
["advertiser_campaign_edit","advertiser_campaign_view","campaign_edit","ads_planner_internal_edit","ads_planner_edit"]

请求参数

Query 参数

Header 参数

Body 参数application/json

示例

{
    "adType": "DSP",
    "countries": [
        "string"
    ],
    "filters": [
        {
            "field": "string",
            "operator": "EQ",
            "values": [
                "string"
            ]
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://www.amazon.com/ap/oa/audiences/list?advertiserId=undefined&canTarget=undefined&nextToken=undefined&maxResults=undefined' \
--header 'Amazon-Advertising-API-ClientId;' \
--header 'Amazon-Advertising-API-Scope;' \
--header 'Amazon-Ads-AccountId;' \
--header 'Content-Type: application/json' \
--data '{
    "adType": "DSP",
    "countries": [
        "string"
    ],
    "filters": [
        {
            "field": "string",
            "operator": "EQ",
            "values": [
                "string"
            ]
        }
    ]
}'

返回响应

🟢200成功

application/json

成功

Bodyapplication/json

示例

{
    "audiences": [
        {
            "audienceId": "string",
            "groupId": "string",
            "negative": true
        }
    ],
    "matchCount": 0,
    "nextToken": "string"
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠429

🔴500服务器错误

修改于 2026-08-27 23:19:48

Request SD report

Browse the taxonomy of audience categories