# All Offers

> Source: https://scrape.do/documentation/amazon-scraper-api/offer-listing/

Get all seller offers for any Amazon product

The All Offers endpoint retrieves every seller listing for a specific product, including pricing, shipping costs, seller information, and Buy Box status. This is the same data you see on Amazon's "All Offers" page (structured as JSON for easy price comparison, seller analysis, and competitive intelligence).

---

## Endpoint

```
GET https://api.scrape.do/plugin/amazon/offer-listing
```

---

## Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `token` | string | * | Your Scrape.do API authentication token |
| `asin` | string | * | Amazon Standard Identification Number (10-character product ID) |
| `geocode` | string | * | Amazon marketplace country code (e.g., `us`, `gb`, `de`, `jp`) |
| `zipcode` | string | | Postal code formatted according to country requirements for ZIP-level marketplaces. Use either `zipcode` or `countryName`, not both. |
| `countryName` | string | | Country-level location for marketplaces without ZIP-level delivery. Passing the marketplace's own country name (for example, `countryName=Turkey` with `geocode=tr`) is unnecessary and ignored. |
| `super` | boolean | | Enable residential/mobile proxies for higher success rates. Costs 10x credits (default: `false`) |
| `include_html` | boolean | | When `true`, the response includes the full raw HTML of the page after the structured JSON output (default: `false`) |
| `device` | string | | Device profile for the request. Use `desktop` or `mobile` (default: `desktop`) |

---

## Response Parameters

| Field | Type | Description |
|-------|------|-------------|
| `asin` | string | Product ASIN number |
| `status` | string | Request status (`success` or `error`) |
| `errorMessage` | string | Error message if request failed |
| `html` | string | Full raw HTML of the Amazon page (only present when `include_html=true`) |
| `offers` | array | List of all seller offers |

### Offer Object Fields

| Field | Type | Description |
|-------|------|-------------|
| `condition` | string | Product condition (`New`, `Used`, `Refurbished`, etc.) |
| `offerHeader` | string | Offer header text |
| `sellerId` | string | Unique seller identifier |
| `merchantName` | string | Seller/merchant display name |
| `shippingTime` | object | Shipping time details including `deliveryDate` |
| `listingPrice` | object | Current offer price with `currencyCode` and `amount` |
| `listPrice` | object | Original list price (if discounted) |
| `discount` | object | Discount details with `percentage`, `amount`, and `currencyCode` |
| `shipping` | object | Shipping cost with `currencyCode` and `amount` |
| `shipsFrom` | string | Shipping origin location |
| `isFulfilledByAmazon` | boolean | Whether the offer is FBA (Fulfilled by Amazon) |
| `primeInformation` | object | Prime eligibility details |
| `isBuyBoxWinner` | boolean | Whether this offer holds the Buy Box |
| `quantity` | number | Available stock quantity |

---

## Example Usage

### Step 1: Find the Target Product

Navigate to any Amazon product page or the "All Offers" page. For this example, we'll check all sellers for a Bluetooth headphone:

![Amazon All Offers Page](/uploads/amazon-sellers-scraper.png)

### Step 2: Get the ASIN

Extract the ASIN from the product URL:
- URL: `amazon.com/dp/B0DGJ7HYG1` (the ASIN is `B0DGJ7HYG1`)

### Step 3: Send the API Request

**cURL (API mode)**

```bash
curl --location --request GET 'https://api.scrape.do/plugin/amazon/offer-listing?token=<SDO-token>&asin=B0DGJ7HYG1&geocode=US'
```

**Python (API mode)**

```python
import requests
import json

token = "<SDO-token>"
asin = "B0DGJ7HYG1"
geocode = "US"

url = f"https://api.scrape.do/plugin/amazon/offer-listing?token={token}&asin={asin}&geocode={geocode}"

response = requests.request("GET", url)

print(json.dumps(response.json(), indent=2))
```

**Node.js (API mode)**

```javascript
const axios = require('axios');

const token = "<SDO-token>";
const asin = "B0DGJ7HYG1";
const geocode = "US";

const url = `https://api.scrape.do/plugin/amazon/offer-listing?token=${token}&asin=${asin}&geocode=${geocode}`;

axios.get(url)
  .then(response => {
    console.log(JSON.stringify(response.data, null, 2));
  })
  .catch(error => {
    console.error(error);
  });
```

*(Go, Ruby, Java, C#, PHP examples are also available on the HTML version.)*

### Step 4: Receive All Seller Offers

The API returns a complete list of all sellers with their pricing and fulfillment details:

```json
{
  "asin": "B0DGJ7HYG1",
  "status": "success",
  "errorMessage": null,
  "offers": [
    {
      "condition": "New",
      "offerHeader": "New",
      "merchantName": "Amazon Resale",
      "shippingTime": {
        "minimumHours": 72,
        "maximumHours": 168,
        "deliveryDate": "December 23 - 29"
      },
      "listingPrice": {
        "currencyCode": "USD",
        "amount": 99.99
      },
      "listPrice": {
        "currencyCode": "USD",
        "amount": 179.00
      },
      "discount": {
        "percentage": 44.14,
        "amount": 79.01,
        "currencyCode": "USD"
      },
      "shipping": {
        "currencyCode": "USD",
        "amount": 0.00
      },
      "shipsFrom": "United States",
      "isFulfilledByAmazon": true,
      "primeInformation": {
        "isPrime": true,
        "isNationalPrime": true
      },
      "isBuyBoxWinner": true,
      "quantity": 3
    },
    {
      "condition": "New",
      "offerHeader": "New",
      "sellerId": "ALAQLAKJ574UN",
      "merchantName": "6ave",
      "shippingTime": {
        "minimumHours": 24,
        "maximumHours": 48,
        "deliveryDate": "Thursday, December 11"
      },
      "listingPrice": {
        "currencyCode": "USD",
        "amount": 196.98
      },
      "shipping": {
        "currencyCode": "USD",
        "amount": 0.00
      },
      "shipsFrom": "United States",
      "isFulfilledByAmazon": false,
      "primeInformation": {
        "isPrime": false
      },
      "isBuyBoxWinner": false,
      "quantity": 30
    }
  ]
}
```

> [!NOTE]
> The `isBuyBoxWinner` field indicates which seller currently holds the Buy Box (the default seller when customers click "Add to Cart"). This is valuable for competitive pricing analysis.

> [!WARNING]
> Response is limited to a maximum of 4MB. Offers are returned with complete price, seller, and shipping information.

> [!NOTE]
> Add `include_html=true` to your request to receive the full raw HTML of the Amazon offers page alongside the structured JSON output. The HTML will be included in an `html` field at the end of the response.