List Per-Product reports

GET

/openapi/publisher/v1/reports/details

List per product reports within a date range [start, end]. Filter by asin, productId, linkId or sourceId.The 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/details?marketplace=amazon.com&start=2025-01-01T08:00:00.000Z&end=2025-05-31T08:00:00.000Z&asins=B0DGXXWGNQ,B0DG8PZSCY&productIds=aa_86Rf07xd4ztfA13R,aa_afRa9dxd4ztfA123&linkIds=aa_uFNqjbUyGoMAU4FM, aa_Dlv1t7DuLkZcvwdj&sourceIds=aa_86Rf07xd4ztfA13R,aa_86Rf07xd4ztfA2Ud&primaryTrackingId=MAIN001&subTrackingId=SUB001&limit=100&cursor=86Rf07xd4ztfA2ztfA' \
--header 'x-aa-authorization: Bearer aa.oa2.v1.xxx'

Response Example

200 - 成功示例

{
  "reports": [
    {
      "marketplace": "",
      "date": "",
      "currency": "",
      "detailPageViews": 0,
      "addToCarts": 0,
      "conversions": 0,
      "sales": 0.0,
      "directDetailPageViews": 0,
      "directAddToCarts": 0,
      "directConversions": 0,
      "directSales": 0.0,
      "haloDetailPageViews": 0,
      "haloAddToCarts": 0,
      "haloConversions": 0,
      "haloSales": 0.0,
      "commissionEarned": 0.0,
      "productId": "",
      "asin": "",
      "productTitle": "",
      "productImageUrl": "",
      "link": {
        "linkId": "",
        "productId": "",
        "asin": "",
        "sourceId": "",
        "sourceName": "",
        "marketplace": "",
        "productStatus": "",
        "trackingLink": "",
        "shortTrackingLink": "",
        "primaryTrackingId": "",
        "subTrackingId": ""
      },
      "primaryTrackingId": "",
      "subTrackingId": "",
      "finalized": false
    }
  ],
  "cursor": ""
}

Request

Query Params

Header Params

Responses

🟢200Success

application/json

Body

🟠401Unauthorized

🟠403Forbidden

🟠422Input Validation Failed

Modified at 2025-06-26 06:13:20

List Product reports