Skip to content
Docs

Offer Response

result contains a summary of the product and the list of seller offers for the requested ASIN. Every response uses the shared response envelope (request_info, request_parameters, request_metadata, result).

Response structure

result
├── product                     Product summary
└── offer
    ├── offer_results[]         One object per seller offer
    │   ├── offer_id, offer_asin, position, buybox_winner, is_prime, source_page
    │   ├── price
    │   ├── prices[]
    │   ├── discount_info
    │   ├── promotion
    │   ├── condition
    │   ├── delivery
    │   │   └── price
    │   ├── minimum_order_quantity
    │   ├── maximum_order_quantity
    │   └── seller
    ├── available_filters       Filter types that apply to the listing
    └── pagination[]            One object per requested page

Result fields

Some offer fields appear only when Amazon shows the data for that offer, for example discount_info, prices[], delivery.date, condition.comments and the seller rating fields. Treat every nested field as optional.

result.product

FieldTypeDescription
asinstringASIN of the product.
titlestringFull product title.
linkstringURL of the product detail page.
imagestringAmazon image ID, for example 31J5v542jbL. Not a full URL.
ratingnumber or numeric stringAverage customer rating, for example 4.5.
ratings_totalintegerTotal number of customer ratings.
offer_countintegerNumber of offers available for the product.

result.offer

FieldTypeDescription
offer_resultsarraySeller offers. See offer_results[].
available_filtersobjectFilter types that apply to the listing. See result.offer.available_filters.

offer_results[]

FieldTypeDescription
offer_idstringURL-encoded identifier of the offer.
offer_asinstringASIN the offer belongs to.
positionintegerPosition of the offer in the list, starting at 0.
buybox_winnerbooleantrue if this offer holds the Buy Box.
is_primebooleantrue if the offer is Prime-eligible.
promotion.has_couponbooleantrue if a coupon is available for the offer.
minimum_order_quantity.valueintegerMinimum quantity per order.
maximum_order_quantity.valueintegerMaximum quantity per order.
source_pageintegerOffer page the offer was read from.

offer_results[].price

FieldTypeDescription
symbolstringCurrency symbol, for example $.
valuestringNumeric price as a string, for example "45.00".
currencystringCurrency code, for example USD.
rawstringPrice as shown on Amazon, for example $45.00.

offer_results[].prices[]

FieldTypeDescription
is_rrpbooleantrue if this entry is the list price (recommended retail price).
symbolstringCurrency symbol.
valuestringNumeric price as a string.
currencystringCurrency code.
rawstringPrice as shown on Amazon.

offer_results[].discount_info

FieldTypeDescription
discount_percentnumberDiscount as a percentage of the list price.
discount_amountnumberDiscount amount in the offer currency.
rawstringDiscount as shown on Amazon, for example -8%.

offer_results[].condition

FieldTypeDescription
is_newbooleantrue if the item is new.
titlestringCondition label, for example New or Used - Good.
commentsstringSeller notes on the condition, usually for used items.

offer_results[].delivery

FieldTypeDescription
fulfilled_by_amazonbooleantrue if Amazon fulfills the offer (FBA).
shipped_from_outside_countrybooleantrue if the item ships from outside the marketplace country.
datestringDelivery date as shown on Amazon.
countdownstringTime left to order for the shown delivery date, for example 3 hrs 33 mins.
price.symbolstringCurrency symbol of the shipping cost.
price.valuestringNumeric shipping cost as a string. Empty when shipping is free.
price.currencystringCurrency code of the shipping cost.
price.rawstringShipping cost as shown on Amazon, for example FREE.
price.is_freebooleantrue if shipping is free.

offer_results[].seller

FieldTypeDescription
idstringAmazon seller ID.
namestringSeller display name.
linkstringURL of the seller page on Amazon.
ratingnumber or numeric stringSeller rating, for example "5.0".
ratings_percentage_positivenumberShare of positive seller ratings, in percent.
ratings_totalintegerTotal number of seller ratings.

result.offer.available_filters

FieldTypeDescription
offers_primebooleantrue if the Prime filter applies to the listing.
offers_free_shippingbooleantrue if the free shipping filter applies.
offers_condition_newbooleantrue if the New condition filter applies.
offers_condition_usedbooleantrue if a Used condition filter applies.
offers_condition_used_like_newbooleantrue if the Used - Like New filter applies.
offers_condition_used_very_goodbooleantrue if the Used - Very Good filter applies.
offers_condition_used_goodbooleantrue if the Used - Good filter applies.
offers_condition_used_acceptablebooleantrue if the Used - Acceptable filter applies.

Sample response

The sample shows the result object only; the envelope fields are left out.

Sample response (OFFER, .com)
{
  "result": {
    "product": {
      "title": "Stanley Quencher H2.0 Tumbler with Handle and Straw 40 oz | Flowstate 3-Position Lid | Cup Holder Compatible for Travel | Insulated Stainless Steel Cup | BPA-Free | Toast",
      "rating": 4.5,
      "ratings_total": 58883,
      "image": "31J5v542jbL",
      "asin": "B0DQY6J9TL",
      "link": "https://amazon.com/dp/B0DQY6J9TL",
      "offer_count": 2
    },
    "offer": {
      "offer_results": [
        {
          "offer_id": "%2FawUBrUy1tL1HtpUTwqrYqS0Rh9756vboab8%2Fj3fodnmDS5OS1q9ZZi6Y2RwM3gSWOQzgLWLMHNLtDtneLUK%2BqNdlmsmxAtbTnHoOfCA46c9AlXy%2B5xRJ3iZtmP0eG08BDgrHlLXylyMqALuZP6jNQ%3D%3D",
          "is_prime": true,
          "offer_asin": "B0DQY6J9TL",
          "position": 0,
          "buybox_winner": true,
          "promotion": {
            "has_coupon": false
          },
          "price": {
            "symbol": "$",
            "value": "45.00",
            "currency": "USD",
            "raw": "$45.00"
          },
          "minimum_order_quantity": {
            "value": 1
          },
          "maximum_order_quantity": {
            "value": 2
          },
          "condition": {
            "is_new": true,
            "title": "New"
          },
          "delivery": {
            "fulfilled_by_amazon": true,
            "shipped_from_outside_country": false,
            "countdown": "3 hrs 33 mins",
            "price": {
              "symbol": "$",
              "value": "",
              "currency": "USD",
              "raw": "FREE",
              "is_free": true
            }
          },
          "seller": {
            "name": "Amazon.com",
            "link": "https://amazon.com"
          }
        },
        {
          "offer_id": "%2FawUBrUy1tL1HtpUTwqrYqS0Rh9756vbroWJ2Xr%2FcmaPa21a18TIeMcZzck2ITnUm%2BoknPHlOvGLsnbKiltKOGLwJ0MugJxk92efDv2DGF%2B9oFCn6XlT%2BWEVsgREfu8zpafU9EGspidwHGAKIq%2BDSZcKcHCnRF3Ea79VJ%2FqmQPQlAjPPklzYDA06oOoMkcb3",
          "is_prime": true,
          "offer_asin": "B0DQY6J9TL",
          "position": 1,
          "buybox_winner": false,
          "promotion": {
            "has_coupon": false
          },
          "price": {
            "symbol": "$",
            "value": "38.54",
            "currency": "USD",
            "raw": "$38.54"
          },
          "minimum_order_quantity": {
            "value": 1
          },
          "maximum_order_quantity": {
            "value": 1
          },
          "condition": {
            "is_new": false,
            "title": "Used - Good",
            "comments": "Minor cosmetic damage on top, front or side of the item. Item may not come in original packaging."
          },
          "delivery": {
            "fulfilled_by_amazon": true,
            "shipped_from_outside_country": false,
            "countdown": "3 hrs 33 mins",
            "price": {
              "symbol": "$",
              "value": "",
              "currency": "USD",
              "raw": "FREE",
              "is_free": true
            }
          },
          "seller": {
            "name": "Amazon Resale",
            "link": "https://www.amazon.com/Warehouse-Deals/b?ie=UTF8&node=10158976011"
          }
        }
      ],
      "available_filters": {
        "offers_prime": false,
        "offers_free_shipping": false,
        "offers_condition_new": false,
        "offers_condition_used": false,
        "offers_condition_used_like_new": false,
        "offers_condition_used_very_good": false,
        "offers_condition_used_good": false,
        "offers_condition_used_acceptable": false
      }
    }
  }
}

Notes

Pagination details

result.offer.pagination is an array with one object per requested page, in page order. A requested page beyond the last one still gets an entry, with current_offer_count 0, and is still charged.

FieldTypeDescription
current_pageintegerPage number of this entry.
current_offer_countintegerNumber of offers on this page.
total_pagesintegerNumber of offer pages Amazon has for the product.
total_resultsintegerTotal number of offers Amazon has for the product.
not_matcharrayNames of expected fields that were not found on this page, for example available_filters.

To read all offers, check total_pages in the first response and request only the pages that exist. In Data Service results, pagination can be a single object with the same fields.

Errors

  • Always check request_info.success and request_info.error_details, even when the HTTP status is 200. On failure, result is an empty object.
  • Request validation errors (page window, language) are listed on the Request page.
Privacy Policy© 2026 Easyparser