getInsightsForStoreAPI

POST

/stores/{brandEntityId}/insights

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

责任人：未设置

店铺洞察（Stores Insights）提供您店铺表现的相关信息，包括流量和销售额。您可以通过此 API 访问店铺洞察。

需要以下权限之一：
["advertiser_campaign_edit","amazon_stores_view","amazon_stores_edit"]

请求参数

Path 参数

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

示例

RequestForInsightsMetricsRequestForStoreQualityMetricsRequestForStoreQualityMetricsWithLanguage

{
    "dimension": "DATE",
    "endDate": "2020-01-02",
    "filter": {
        "pageIds": [
            "page1_id"
        ],
        "sources": [
            "ADS"
        ]
    },
    "maxResult": 1000,
    "metrics": [
        "ORDERS",
        "SALES",
        "UNITS",
        "VIEWS",
        "VISITORS",
        "VISITS"
    ],
    "paginationToken": "string",
    "startDate": "2020-01-01"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

RequestForInsightsMetricsRequestForStoreQualityMetricsRequestForStoreQualityMetricsWithLanguage

curl --location 'https://www.amazon.com/ap/oa/stores//insights' \
--header 'Content-Type: application/vnd.GetInsightsForStoreRequest.v1+json' \
--data '{
    "dimension": "DATE",
    "endDate": "2020-01-02",
    "filter": {
        "pageIds": [
            "page1_id"
        ],
        "sources": [
            "ADS"
        ]
    },
    "maxResult": 1000,
    "metrics": [
        "ORDERS",
        "SALES",
        "UNITS",
        "VIEWS",
        "VISITORS",
        "VISITS"
    ],
    "paginationToken": "string",
    "startDate": "2020-01-01"
}'

返回响应

🟢200成功

application/vnd.GetInsightsForStoreResponse.v1+json

成功

Bodyapplication/vnd.GetInsightsForStoreResponse.v1+json

示例

{}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠422参数错误

🟠429

🔴500服务器错误

修改于 2026-08-27 23:52:56

getAsinEngagementForStore

Associates or disassociates a record with an audience. Note that the API call rate is limited to 100 transactions per second (TPS). Calls exceeding this rate are throttled. Payload size is limited to a maximum of 6MB or 2000 records. Calls with a payload