List Product reports

Developing

GET

/openapi/publisher/v1/reports

Retrieve aggregated product reports grouped by dimensions such as PERFORMANCE, PRODUCT, or BRAND. The aggregation is determined by the reportType parameter. he difference in time between the start date and end date can be no longer than 1 year. Dates must be specified in ISO format with no offset (UTC), format: yyyy-MM-ddTHH:mm:ss.SSSZ.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.artemisads.com/openapi/publisher/v1/reports?reportType=PERFORMANCE&marketplace=amazon.com&start=2025-01-01T08:00:00.000Z&end=2025-05-31T08:00:00.000Z&asin=B0DGXXWGNQ&productId=aa_86Rf07xd4ztfA13R&brandId=aa_J9HAfx0jN2TjHqzv&limit=100&cursor=86Rf07xd4ztfA2ztfA' \
--header 'x-aa-authorization: Bearer aa.oa2.v1.xxx'

Response Example

200 - Example 1

{
    "reports": [
        {
            "detailPageViews": 0,
            "addToCarts": 0,
            "conversions": 0,
            "sales": 0,
            "directDetailPageViews": 0,
            "directAddToCarts": 0,
            "directConversions": 0,
            "directSales": 0,
            "haloDetailPageViews": 0,
            "haloAddToCarts": 0,
            "haloConversions": 0,
            "haloSales": 0,
            "commissionEarned": 0,
            "date": "string",
            "clicks": 0,
            "productId": "string",
            "asin": "string",
            "productTitle": "string",
            "productImageUrl": "string",
            "links": {
                "linkId": "string",
                "productId": "string",
                "asin": "string",
                "sourceId": "string",
                "sourceName": "string",
                "marketplace": "string",
                "productStatus": "string",
                "trackingLink": "string",
                "shortTrackingLink": "string"
            },
            "brandId": "string",
            "brandName": "string",
            "brandLogoImageUrl": "string",
            "brandBiography": "string"
        }
    ],
    "cursor": "string"
}

Request

Query Params

Header Params

Responses

🟢200OK

application/json

Body

🟠401Unauthorized

🟠403Forbidden

Modified at 2025-06-26 06:16:15

List Brand Storefront Links

List Per-Product reports