List Deals

GET

/openapi/publisher/v1/deals

List deals within a time range [start, end]. Filter by asin, productId. The difference in time between the start date and end date can be no longer than 1 year. Times must be specified in ISO format with no offset (UTC), format: yyyy-MM-ddTHH:mm:ss.SSSZ.

Request

Query Params

Header Params

Responses

🟢200Success

application/json

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠422Input Validation Failed

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.artemisads.com/openapi/publisher/v1/deals?marketplace=amazon.com&start=2025-01-01T08%3A00%3A00.000Z&end=2025-05-31T08%3A00%3A00.000Z&asins=B08N5WRWNW%2CB07H8QMZPX&productIds=aa_86Rf07xd4ztfA13R%2Caa_42Bc03kl8mnxZ56T&limit=100&cursor=86Rf07xd4ztfA2ztfA' \
--header 'x-aa-authorization: Bearer aa.oa2.v1.xxx'

Response Example

200 - 成功示例

{
  "deals": [
    {
      "type": "",
      "productId": "",
      "asin": "",
      "productTitle": "",
      "startDate": "",
      "endDate": "",
      "fullPrice": 0.0,
      "finalPrice": 0.0,
      "currency": "",
      "discountPercentage": 0.0,
      "status": "",
      "promoCode": ""
    }
  ],
  "cursor": ""
}

Modified at 2025-11-26 02:27:36

List Product Variations

List Brands