ListHistoricalReachCurves

POST

/mediaPlan/historicalReachCurves/list

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

责任人：未设置

列出历史覆盖曲线。

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

参数名称：
Amazon-Ads-AccountId

参数位置：
header

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

授权资源类型：
全球广告账户 ID、配置文件 ID

参数名称：
Amazon-Ads-AccountId

参数位置：
header

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

请求参数

Header 参数

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

示例

Get recent historical reach curves.Reach curve response when there is no data for the given geography and month combination.

。

{
    "maxResults": 2,
    "month": "02/2023",
    "nextToken": "%6A%22VI3wDokCxd5UyqYJwFE_%55%5C",
    "targeting": {
        "channels": [
            "STV"
        ],
        "demographics": [
            "A18_PLUS",
            "P2_PLUS"
        ],
        "geography": "US",
        "reachType": "INDIVIDUALS"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Get recent historical reach curves.Reach curve response when there is no data for the given geography and month combination.

curl --location 'https://www.amazon.com/ap/oa/mediaPlan/historicalReachCurves/list' \
--header 'Amazon-Ads-AccountId;' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.abcdefg1234567890' \
--header 'Amazon-Advertising-API-Scope: 2095123454329876' \
--header 'Content-Type: application/vnd.mediaplanhistoricalreachcurves.v1+json' \
--data '{
    "maxResults": 2,
    "month": "02/2023",
    "nextToken": "%6A%22VI3wDokCxd5UyqYJwFE_%55%5C",
    "targeting": {
        "channels": [
            "STV"
        ],
        "demographics": [
            "A18_PLUS",
            "P2_PLUS"
        ],
        "geography": "US",
        "reachType": "INDIVIDUALS"
    }
}'

返回响应

🟢200成功

application/vnd.mediaplanhistoricalreachcurves.v1+json

ListHistoricalReachCurves 200 响应。

Bodyapplication/vnd.mediaplanhistoricalreachcurves.v1+json

示例

{}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠415

🟠429

🔴500服务器错误

修改于 2026-08-27 23:21:02

Retrieves the top audiences that overlap with the provided audience.

ListHistoricalReachCurvesMetadata