> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapeunblocker.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Scrape every offer (all sellers) for an Amazon product

> Returns the offers Amazon lists for a product under "All buying options", as JSON. Each offer has the seller (`sellerName`, `sellerId`, `sellerUrl`, `sellerRating`, `sellerRatingCount`, `sellerPositivePercent`), `price` + `currency`, `listPrice` and `savingsPercent`, `shippingPrice` and `totalPrice`, `condition` (as Amazon words it) with `conditionType` (new, used, collectible, refurbished) and the seller's `conditionNote`, `delivery` / `deliveryDate`, `alternativeDelivery` (the faster or Prime-member option Amazon also offers), `shipsFrom`, `soldByAmazon`, `fulfilledByAmazon`, `prime`, the `offerId` and a `buyBoxWinner` flag. The response also carries the product `title`, `rating`, `reviewCount`, `image` and `totalOffers`.

Page 1 starts with the Buy Box (featured) offer, also returned as `buyBox`; Amazon shows it whatever filter is set. Amazon lists 10 other offers per page: follow `nextPage`, or read up to 5 pages in one call with `pages`. Filter with `condition`, `free_shipping` and `prime`. `shippingPrice` is 0 for free delivery and null when Amazon shows no delivery promise for the location. `proxy_country` defaults to the marketplace's home country so prices and delivery are the ones a local shopper sees; the proxy that served the request is reported as `exitCountry` and `exitProvider`.



## OpenAPI

````yaml /api-reference/openapi.json post /marketplace/amazon-offers
openapi: 3.1.0
info:
  title: ScrapeUnblocker API
  description: >-
    Public API for the ScrapeUnblocker proxy/anti-bot service. Authenticate
    every request with the `x-scrapeunblocker-key` header. Documented here:
    page-source extraction, Google SERP scraping, image fetch, and the dedicated
    plugin endpoints (search engines, marketplaces, reviews, travel, social and
    more). All other paths exist for internal operations and are intentionally
    hidden from this spec.
  version: 3.0.0
servers:
  - url: https://api.scrapeunblocker.com
    description: Production
security: []
paths:
  /marketplace/amazon-offers:
    post:
      tags:
        - Plugins
      summary: Scrape every offer (all sellers) for an Amazon product
      description: >-
        Returns the offers Amazon lists for a product under "All buying
        options", as JSON. Each offer has the seller (`sellerName`, `sellerId`,
        `sellerUrl`, `sellerRating`, `sellerRatingCount`,
        `sellerPositivePercent`), `price` + `currency`, `listPrice` and
        `savingsPercent`, `shippingPrice` and `totalPrice`, `condition` (as
        Amazon words it) with `conditionType` (new, used, collectible,
        refurbished) and the seller's `conditionNote`, `delivery` /
        `deliveryDate`, `alternativeDelivery` (the faster or Prime-member option
        Amazon also offers), `shipsFrom`, `soldByAmazon`, `fulfilledByAmazon`,
        `prime`, the `offerId` and a `buyBoxWinner` flag. The response also
        carries the product `title`, `rating`, `reviewCount`, `image` and
        `totalOffers`.


        Page 1 starts with the Buy Box (featured) offer, also returned as
        `buyBox`; Amazon shows it whatever filter is set. Amazon lists 10 other
        offers per page: follow `nextPage`, or read up to 5 pages in one call
        with `pages`. Filter with `condition`, `free_shipping` and `prime`.
        `shippingPrice` is 0 for free delivery and null when Amazon shows no
        delivery promise for the location. `proxy_country` defaults to the
        marketplace's home country so prices and delivery are the ones a local
        shopper sees; the proxy that served the request is reported as
        `exitCountry` and `exitProvider`.
      operationId: amazon_offers_marketplace_amazon_offers_post
      parameters:
        - name: asin
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Amazon product id (10-char ASIN, e.g. 'B07VGRJDFY'; books use
              their ISBN-10). Give either `asin` (with `marketplace`) or a
              product `url`.
            title: Asin
          description: >-
            Amazon product id (10-char ASIN, e.g. 'B07VGRJDFY'; books use their
            ISBN-10). Give either `asin` (with `marketplace`) or a product
            `url`.
        - name: url
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Full Amazon product url, e.g.
              'https://www.amazon.de/dp/1847941834'. The ASIN and marketplace
              are read from it.
            title: Url
          description: >-
            Full Amazon product url, e.g. 'https://www.amazon.de/dp/1847941834'.
            The ASIN and marketplace are read from it.
        - name: marketplace
          in: query
          required: false
          schema:
            type: string
            description: >-
              Regional Amazon site whose offers to list. Prices, sellers and
              delivery differ per marketplace. One of: amazon.com, amazon.co.uk,
              amazon.de, amazon.fr, amazon.it, amazon.es, amazon.nl, amazon.se,
              amazon.pl, amazon.com.be, amazon.com.tr, amazon.ca, amazon.com.mx,
              amazon.com.br, amazon.co.jp, amazon.in, amazon.ae, amazon.sa,
              amazon.sg, amazon.com.au.
            default: amazon.com
            title: Marketplace
          description: >-
            Regional Amazon site whose offers to list. Prices, sellers and
            delivery differ per marketplace. One of: amazon.com, amazon.co.uk,
            amazon.de, amazon.fr, amazon.it, amazon.es, amazon.nl, amazon.se,
            amazon.pl, amazon.com.be, amazon.com.tr, amazon.ca, amazon.com.mx,
            amazon.com.br, amazon.co.jp, amazon.in, amazon.ae, amazon.sa,
            amazon.sg, amazon.com.au.
        - name: condition
          in: query
          required: false
          schema:
            type: string
            description: >-
              Only offers in this condition: all, new, used, used_like_new,
              used_very_good, used_good, used_acceptable. Default 'all'.
            default: all
            title: Condition
          description: >-
            Only offers in this condition: all, new, used, used_like_new,
            used_very_good, used_good, used_acceptable. Default 'all'.
        - name: free_shipping
          in: query
          required: false
          schema:
            type: boolean
            description: Only offers with free delivery.
            default: false
            title: Free Shipping
          description: Only offers with free delivery.
        - name: prime
          in: query
          required: false
          schema:
            type: boolean
            description: Only Prime-eligible offers.
            default: false
            title: Prime
          description: Only Prime-eligible offers.
        - name: page
          in: query
          required: false
          schema:
            type: integer
            description: >-
              1-based offers page to start at. Amazon lists 10 offers per page
              (page 1 also carries the Buy Box offer and the product header).
            default: 1
            title: Page
          description: >-
            1-based offers page to start at. Amazon lists 10 offers per page
            (page 1 also carries the Buy Box offer and the product header).
        - name: pages
          in: query
          required: false
          schema:
            type: integer
            description: >-
              How many consecutive pages to read in this call (1-5). Reading
              stops early at the last page. Each page delivered is billed as one
              request.
            default: 1
            title: Pages
          description: >-
            How many consecutive pages to read in this call (1-5). Reading stops
            early at the last page. Each page delivered is billed as one
            request.
        - name: proxy_country
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE').
              Defaults to the marketplace's home country, so prices, shipping
              costs and delivery dates are the ones a local shopper sees.
            title: Proxy Country
          description: >-
            Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE').
            Defaults to the marketplace's home country, so prices, shipping
            costs and delivery dates are the ones a local shopper sees.
      responses:
        '200':
          description: Offers parsed (the list can be empty when nobody sells the product).
          content:
            application/json:
              schema: {}
        '400':
          description: No/invalid ASIN or url, or an unsupported parameter value.
        '404':
          description: Amazon has no product with this ASIN on this marketplace.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: >-
            Blocked by Amazon, no offers panel returned, or the call did not
            finish in time.
      security:
        - ScrapeUnblockerKey: []
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ScrapeUnblockerKey:
      type: apiKey
      in: header
      name: x-scrapeunblocker-key
      description: Your ScrapeUnblocker API key. Apply on every request.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.