OffersV2

The OffersV2 resource contains various resources related to offer listings for an item.

We recommend using OffersV2 over Offers where possible. Eventually, OffersV2 will completely replace the existing Offers API. All new Item Offer features will be added here. In addition to the data fields themselves, V2 also has increased reliability and data quality compared to V1.

This is a new API which will evolve over time - check this page for changes and updates.

We would love to hear your feedback on OffersV2, including asks for additional fields!

Resources

• Listings
  • Availability
    • MaxOrderQuantity
    • MinOrderQuantity
    • Type
  • Condition
    • ConditionNote
    • SubCondition
    • Value
  • IsBuyBoxWinner
  • LoyaltyPoints
    • Points
  • MerchantInfo
    • Name
  • Price
    • Money
    • PricePerUnit
    • SavingBasis
      • Money
      • SavingBasisType
      • SavingBasisTypeLabel
    • Savings
      • Money
      • Percentage
  • Type
  • ViolatesMAP

Listings

Specifies the various offer listings associated with the product.

Sample Response

{
  "ItemsResult": {
    "Items": [{
      "ASIN": "B00MNV8E0C",
      "DetailPageURL": "https://www.amazon.com/dp/B00MNV8E0C?tag=example&linkCode=ogi&th=1&psc=1",
      "OffersV2": {
        "Listings": [{
          "Availability": {
            "MaxOrderQuantity": 1,
            "MinOrderQuantity": 1,
            "Type": "IN_STOCK"
          },
          "Condition": {
            "ConditionNote": "",
            "SubCondition": "Unknown",
            "Value": "New"
          },
          "DealDetails": {
            "AccessType": "PRIME_EXCLUSIVE",
            "EndTime": "2024-11-06T05:35Z",
            "PercentClaimed": 38,
            "StartTime": "2024-11-05T18:05Z"
          },
          "IsBuyBoxWinner": true,
          "MerchantInfo": {
            "Name": "Amazon.com"
          },
          "Price": {
            "Money": {
              "Amount": 59.49,
              "Currency": "USD",
              "DisplayAmount": "$59.49"
            },
            "PricePerUnit": {
              "Amount": 29.75,
              "Currency": "USD",
              "DisplayAmount": "$29.75 / Count"
            },
            "SavingBasis": {
              "Money": {
                "Amount": 69.99,
                "Currency": "USD",
                "DisplayAmount": "$69.99"
              },
              "SavingBasisType": "LIST_PRICE",
              "SavingBasisTypeLabel": "List Price"
            },
            "Savings": {
              "Money": {
                "Amount": 10.5,
                "Currency": "USD",
                "DisplayAmount": "$10.50"
              },
              "Percentage": 15
            }
          },
          "Type": "LIGHTNING_DEAL",
          "ViolatesMAP": false
        }]
      }
    }]
  }

Availability

Sample Response

{
  "ItemsResult": {
    "Items": [
      {
        "ASIN": "B0CNY1L5LP",
        "DetailPageURL": "https://www.amazon.com/dp/B0CNY1L5LP?tag=baba&linkCode=ogi&th=1&psc=1",
        "OffersV2": {
          "Listings": [
            {
              "Availability": {
                "MaxOrderQuantity": 1,
                "MinOrderQuantity": 1,
                "Type": "IN_STOCK"
              }
            }
          ]
        }
      }
    ]
  }
}

Condition

Sample Response

{
  "Condition": {
    "ConditionNote": "",
    "SubCondition": "Unknown",
    "Value": "New"
  }
}

DealDetails

This field will only be populated if there is a deal associated with the listing. The existence of this field (when requested) implies the existence of a deal.

The easiest way to find deals on Amazon is by visiting https://www.amazon.com/deals, or the appropriate equivalent in your marketplace of choice.

Sample Response

{
  "DealDetails": {
    "AccessType": "PRIME_EXCLUSIVE",
    "EndTime": "2024-11-06T05:35Z",
    "PercentClaimed": 38,
    "StartTime": "2024-11-05T18:05Z"
  }
}

LoyaltyPoints

Loyalty Points is an Amazon Japan only program. See https://www.amazon.co.jp/-/en/gp/help/customer/display.html?nodeId=GGB6FCM85P9UKC7T

Sample Response

{
  "LoyaltyPoints": {
    "Points": 10
  }
}

MerchantInfo

Sample Response

{
  "MerchantInfo": {
    "Name": "Amazon.com"
  }
}

Price

Sample Response

{
  "Price": {
    "Money": {
      "Amount": 59.49,
      "Currency": "USD",
      "DisplayAmount": "$59.49"
    },
    "PricePerUnit": {
      "Amount": 29.75,
      "Currency": "USD",
      "DisplayAmount": "$29.75 / Count"
    },
    "SavingBasis": {
      "Money": {
        "Amount": 69.99,
        "Currency": "USD",
        "DisplayAmount": "$69.99"
      },
      "SavingBasisType": "LIST_PRICE",
      "SavingBasisTypeLabel": "List Price"
    },
    "Savings": {
      "Money": {
        "Amount": 10.5,
        "Currency": "USD",
        "DisplayAmount": "$10.50"
      },
      "Percentage": 15
    }
  }
}

SavingBasis

Reference Value Which is used to calculate savings against

Sample Response

{
  "SavingBasis": {
    "Money": {
      "Amount": 69.99,
      "Currency": "USD",
      "DisplayAmount": "$69.99"
    },
    "SavingBasisType": "LIST_PRICE",
    "SavingBasisTypeLabel": "List Price"
  }
}

Savings

Savings of an Offer

Sample Response

{
  "Savings": {
    "Money": {
      "Amount": 10.5,
      "Currency": "USD",
      "DisplayAmount": "$10.50"
    },
    "Percentage": 15
  }
}

Money

Common Struct used for representing money

Relevant Operations

Operations that can use these resources include:

• GetItems

Changelog

11/05/2024

Not currently supported request parameters

• Condition (only returning NEW as of today)
• Merchant (returns all offerings regardless of merchant, does not support Amazon only)
• OfferCount (returns all offers that would appear on detail page)
  • tends to be 1-3 offers

Appendix

Minimum Advertising Price

Some manufacturers have a minimum advertised price (MAP) that can be displayed on Amazon.com. When the Amazon price is lower than the MAP, the manufacturer does not allow the price to be shown until the customer takes further action, such as placing the item in their shopping cart, or in some cases, proceeding to the final checkout stage. Customers need to go to Amazon to see the price on the retail website, but won't be required to purchase the product.