# Best Sellers Object

Source: https://env.7xmtools.com/api-docs/best-sellers-object.html

A list of best-selling ASINs for a specific category, ordered from the best-selling product (lowest sales rank) downwards.

JSON Object · Returned by: Best Sellers

The Best Sellers Object is returned by the [Best Sellers](https://env.7xmtools.com/api-docs/best-sellers.html) request. It contains the Amazon locale, the requested category and a ranked list of ASINs.

## Format

```json
{
    "domainId": Integer,
    "lastUpdate": Integer,
    "categoryId": Long,
    "asinList": String[]
}
```

## Fields

| Field | Type | Description |
| --- | --- | --- |
| `domainId` | Integer | The Amazon locale this list belongs to. See the [valid domain IDs](https://env.7xmtools.com/api-docs/best-sellers-object.html#domain-ids) below. |
| `lastUpdate` | Integer | The last time the list was updated, in [Keepa Time minutes](https://env.7xmtools.com/api-docs/best-sellers-object.html#keepa-time-minutes). Example: `2711319` |
| `categoryId` | Long | The category node ID used in the request, representing the category identifier. Example: `281052` ([Amazon category link](http://www.amazon.com/b/?node=281052)) |
| `asinList` | String\[\] | A list of ASINs, starting with the best-selling product (lowest sales rank). |

### Valid domain IDs

| Domain ID | Locale |
| --- | --- |
| **1** | com |
| **2** | co.uk |
| **3** | de |
| **4** | fr |
| **5** | co.jp |
| **6** | ca |
| **8** | it |
| **9** | es |
| **10** | in |
| **11** | com.mx |
| **12** | com.br |

## Keepa Time Minutes

Time format used for all timestamps. To convert to an uncompressed Unix epoch time:

- **For milliseconds:** `(keepaTime + 21564000) * 60000`
- **For seconds:** `(keepaTime + 21564000) * 60`

```python
# Convert Keepa Time minutes to a Python datetime
from datetime import datetime, timezone

def keepa_minutes_to_datetime(keepa_time):
    return datetime.fromtimestamp((keepa_time + 21564000) * 60, tz=timezone.utc)

print(keepa_minutes_to_datetime(7663000))  # illustrative value (mid 2026)
```

## Example

A Best Sellers Object as returned inside the `bestSellersList` field of a [Best Sellers](https://env.7xmtools.com/api-docs/best-sellers.html) response:

```json
{
  "domainId": 1,
  "lastUpdate": 7662840,
  "categoryId": 281052,
  "asinList": [
    "B0BDHWDR12",
    "B09XS7JWHH",
    "B08N5WRWNW",
    "B07YN82X3B",
    "B01M0AGIKS"
  ]
}
```

*Response shortened for readability; illustrative values.* A real list can contain far more ASINs.