GET /api/amazon/product/offers — Third-Party Seller Offers

Retrieve all third-party seller offers listed for a given Amazon product. For each offer you get the price, delivery details, seller profile (name, rating, feedback count), and whether that offer currently holds the buybox. Results are paginated, allowing you to walk through large offer sets with the page parameter.

Request

GET https://api.glade.dev/api/amazon/product/offers

Query Parameters

string

default:"US"

The Amazon marketplace to query. Accepted values: US UK CA DE FR IT ES AU IN MX BR JP PL. Defaults to US when omitted.

string

The Amazon Standard Identification Number (e.g. B09XS7JWHH). Provide at least one of asin, url, or gtin.

string

A full Amazon product URL. Provide at least one of asin, url, or gtin.

string

A Global Trade Item Number (barcode). Provide at least one of asin, url, or gtin.

integer

default:"1"

Page number of results to return. Minimum value is 1.

Response

Paginated offers are returned under data.amazonProduct.offersPaginated.

object

Hide offersPaginated fields

object[]

Show offer item fields

string

Unique identifier for this offer.

object

Show price fields

string

Currency symbol, e.g. $.

number

Numeric price value.

string

ISO 4217 currency code.

string

Human-readable price string.

integer

Minimum number of units required per order.

integer

Maximum number of units allowed per order.

boolean

true if the item condition is new; false for used, refurbished, or open-box.

string

Offer title or condition note provided by the seller.

object

Show delivery fields

boolean

true if Amazon handles fulfilment (FBA).

boolean

true if the item ships from outside the destination country.

string

Delivery urgency text, e.g. Order within 3 hrs 20 mins.

string

Additional delivery notes, e.g. Arrives tomorrow.

object

Show delivery price fields

string

Currency symbol.

number

Shipping cost value.

string

ISO 4217 currency code.

string

Human-readable shipping cost, e.g. FREE or $4.99.

string

An optional upsell message, e.g. Join Prime for free delivery.

object

Show seller fields

string

Seller display name.

string

URL to the seller’s Amazon storefront.

number

Seller rating on a 0–5 scale.

number

Percentage of positive ratings, e.g. 97.

integer

Total lifetime ratings for the seller.

string

Unique Amazon seller ID.

string

URL to the seller’s logo image.

boolean

true if this offer qualifies for Prime shipping.

boolean

true if this offer currently holds the Amazon buybox.

object

Show pageInfo fields

integer

The page number returned.

integer

Total number of pages available.

integer

Total number of offers across all pages.

boolean

true if a subsequent page exists.

boolean

true if a previous page exists.

Example Response

{
  "data": {
    "amazonProduct": {
      "offersPaginated": {
        "offers": [
          {
            "id": "offer_ATVP_B09XS7JWHH",
            "price": {
              "symbol": "$",
              "value": 279.99,
              "currency": "USD",
              "display": "$279.99"
            },
            "minimumOrderQuantity": 1,
            "maximumOrderQuantity": 10,
            "conditionIsNew": true,
            "title": "New",
            "delivery": {
              "fulfilledByAmazon": true,
              "shippedFromOutsideCountry": false,
              "countdown": "Order within 2 hrs 45 mins",
              "comments": "Arrives tomorrow",
              "price": {
                "symbol": "$",
                "value": 0,
                "currency": "USD",
                "display": "FREE"
              },
              "upsell": null
            },
            "seller": {
              "name": "Amazon.com",
              "link": "https://www.amazon.com/s?me=ATVPDKIKX0DER",
              "rating": 4.8,
              "ratingsPercentagePositive": 98,
              "ratingsTotal": 2489031,
              "id": "ATVPDKIKX0DER",
              "imageUrl": "https://images-na.ssl-images-amazon.com/images/G/01/marketplace/images/seller/amazon_logo.png"
            },
            "isPrime": true,
            "buyboxWinner": true
          },
          {
            "id": "offer_A1VC38T7YXB5HJ_B09XS7JWHH",
            "price": {
              "symbol": "$",
              "value": 261.49,
              "currency": "USD",
              "display": "$261.49"
            },
            "minimumOrderQuantity": 1,
            "maximumOrderQuantity": 5,
            "conditionIsNew": true,
            "title": "New — ships from authorized reseller",
            "delivery": {
              "fulfilledByAmazon": false,
              "shippedFromOutsideCountry": false,
              "countdown": null,
              "comments": "Usually ships within 2–3 business days",
              "price": {
                "symbol": "$",
                "value": 4.99,
                "currency": "USD",
                "display": "$4.99"
              },
              "upsell": "Join Prime for free delivery"
            },
            "seller": {
              "name": "TechDeals Direct",
              "link": "https://www.amazon.com/s?me=A1VC38T7YXB5HJ",
              "rating": 4.6,
              "ratingsPercentagePositive": 94,
              "ratingsTotal": 8312,
              "id": "A1VC38T7YXB5HJ",
              "imageUrl": "https://images-na.ssl-images-amazon.com/images/G/01/marketplace/images/seller/placeholder.png"
            },
            "isPrime": false,
            "buyboxWinner": false
          }
        ],
        "pageInfo": {
          "currentPage": 1,
          "totalPages": 4,
          "totalResults": 31,
          "hasNextPage": true,
          "hasPrevPage": false
        }
      }
    }
  }
}

Error Handling

All errors follow a consistent envelope. The HTTP status code mirrors the code field inside the errors array.

Status	Meaning
`400`	Bad request — a required parameter is missing or malformed.
`401`	Unauthorized — your API key is missing or invalid.
`402`	Payment required — your plan limit has been reached.
`429`	Too many requests — you have exceeded the rate limit for your plan.
`502`	Bad gateway — Amazon returned an unexpected response; retry with exponential back-off.

{
  "success": false,
  "errors": [
    {
      "code": 400,
      "message": "Missing required parameter: asin, url, or gtin must be provided"
    }
  ]
}

curl Example

curl --request GET \
  --url 'https://api.glade.dev/api/amazon/product/offers?asin=B09XS7JWHH&domain=US&page=1' \
  --header 'API-KEY: YOUR_API_KEY'

Products

Search & Discovery

Sellers & Categories

GET /api/amazon/product/offers — Third-Party Seller Offers

Request

Query Parameters

Response

Example Response

Error Handling

curl Example

​Request

​Query Parameters

​Response

​Example Response

​Error Handling

​curl Example

Request

Query Parameters

Response

Example Response

Error Handling

curl Example