listOfferMetrics

北美(North America）

https://sellingpartnerapi-na.amazon.com

POST

/replenishment/2022-11-07/offers/metrics/search

返回销售合作伙伴报价的聚合补给计划指标。

使用计划：

速率（每秒请求次数）	突发
1	1

x-amzn-RateLimit-Limit 响应头返回已应用于请求操作的使用计划速率限制（如果可用）。上表指示此操作的默认速率和突发值。业务需求较高的销售合作伙伴可能会看到比这里显示的更高的速率和突发值。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

请求参数

Body 参数application/json

示例

{
    "pagination": {
        "limit": 1,
        "offset": 0
    },
    "sort": {
        "order": "ASC",
        "key": "SHIPPED_SUBSCRIPTION_UNITS"
    },
    "filters": {
        "aggregationFrequency": "WEEK",
        "timeInterval": {
            "startDate": "2019-08-24T14:15:22Z",
            "endDate": "2019-08-24T14:15:22Z"
        },
        "timePeriodType": "PERFORMANCE",
        "marketplaceId": "string",
        "programTypes": [
            "SUBSCRIBE_AND_SAVE"
        ],
        "asins": [
            "string"
        ]
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://sellingpartnerapi-na.amazon.com/replenishment/2022-11-07/offers/metrics/search' \
--header 'Content-Type: application/json' \
--data-raw '{
    "pagination": {
        "limit": 1,
        "offset": 0
    },
    "sort": {
        "order": "ASC",
        "key": "SHIPPED_SUBSCRIPTION_UNITS"
    },
    "filters": {
        "aggregationFrequency": "WEEK",
        "timeInterval": {
            "startDate": "2019-08-24T14:15:22Z",
            "endDate": "2019-08-24T14:15:22Z"
        },
        "timePeriodType": "PERFORMANCE",
        "marketplaceId": "string",
        "programTypes": [
            "SUBSCRIBE_AND_SAVE"
        ],
        "asins": [
            "string"
        ]
    }
}'

返回响应

🟢200成功

application/json

成功。

Headers

Body

示例

{
    "offers": [
        {
            "notDeliveredDueToOOS": 30.78,
            "shippedSubscriptionUnits": 20,
            "totalSubscriptionsRevenue": 12.89,
            "asin": "B000TMUDOW",
            "revenuePenetration": 10.34,
            "lostRevenueDueToOOS": 12.32,
            "couponsRevenuePenetration": 10,
            "timeInterval": {
                "endDate": "2023-03-11T00:00:00Z",
                "startDate": "2023-03-05T00:00:00Z"
            },
            "currencyCode": "USD"
        },
        {
            "notDeliveredDueToOOS": 40.78,
            "shippedSubscriptionUnits": 40,
            "totalSubscriptionsRevenue": 34.03,
            "asin": "B004CLH5CY",
            "revenuePenetration": 9.87,
            "lostRevenueDueToOOS": 17.82,
            "couponsRevenuePenetration": 17,
            "timeInterval": {
                "endDate": "2023-03-11T00:00:00Z",
                "startDate": "2023-03-05T00:00:00Z"
            },
            "currencyCode": "USD"
        }
    ],
    "pagination": {
        "totalResults": 17
    }
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障

修改于 2025-06-15 14:55:06

getSellingPartnerMetrics

listOffers