API to get posts data along with performance metrics for each post.

POST

/bp/v2/posts/list

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

责任人：未设置

用于获取帖子数据及每个帖子的性能指标的 API。

需要以下权限之一：
[]

请求参数

Header 参数

Body 参数application/vnd.bpPost.v2+json必填

示例

{
    "filters": [
        {
            "endDate": "2019-08-24T14:15:22.123Z",
            "fieldName": "caption",
            "filterType": "RANGE",
            "startDate": "2019-08-24T14:15:22.123Z",
            "values": [
                "string"
            ]
        }
    ],
    "maxResults": 50,
    "metricEndDate": "string",
    "metricStartDate": "string",
    "nextToken": "string",
    "profileId": "string",
    "selectedMetrics": [
        "clickThroughRate"
    ],
    "sortCriterion": {
        "sortField": "clickThroughRate",
        "sortOrder": "ASC"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://www.amazon.com/ap/oa/bp/v2/posts/list' \
--header 'Amazon-Advertising-API-ClientId;' \
--header 'Amazon-Advertising-API-Scope;' \
--header 'Content-Type: application/vnd.bpPost.v2+json' \
--data '{
    "filters": [
        {
            "endDate": "2019-08-24T14:15:22.123Z",
            "fieldName": "caption",
            "filterType": "RANGE",
            "startDate": "2019-08-24T14:15:22.123Z",
            "values": [
                "string"
            ]
        }
    ],
    "maxResults": 50,
    "metricEndDate": "string",
    "metricStartDate": "string",
    "nextToken": "string",
    "profileId": "string",
    "selectedMetrics": [
        "clickThroughRate"
    ],
    "sortCriterion": {
        "sortField": "clickThroughRate",
        "sortOrder": "ASC"
    }
}'

返回响应

🟢200成功

application/vnd.bpPost.v2+json

ListPosts 200 响应

Bodyapplication/vnd.bpPost.v2+json

示例

{}

🟠400请求有误

🟠402

🟠403禁止访问

🟠404记录不存在

🟠409

🟠429

🔴500服务器错误

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

API to create a Post.

Get a post.