keepa.Keepa.seller_query#

Keepa.seller_query(seller_id: str | list[str], domain: str | Domain = 'US', to_datetime: bool = True, storefront: bool = False, update: int | None = None, wait: bool = True, typed: bool = False) → dict[str, dict[str, Any]] | dict[str, Seller]#

Receive seller information for a given seller id or ids.

If a seller is not found no tokens will be consumed.

Token cost: 1 per requested seller

Parameters:
seller_idstr or list[str]

The seller id of the merchant you want to request. For batch requests, you may submit a list of 100 seller_ids. The seller id can also be found on Amazon on seller profile pages in the seller parameter of the URL as well as in the offers results from a product query.

domainstr | keepa.Domain, default: ‘US’

A valid Amazon domain. See keepa.Domain.

to_datetimebool, default: True

When True casts the time values to datetime.datetime. For example datetime.datetime(2025, 10, 24, 10, 40). When False, the values are represented as numpy "<M8[m]".

storefrontbool, default: False

If specified the seller object will contain additional information about what items the seller is listing on Amazon. This includes a list of ASINs as well as the total amount of items the seller has listed. The following seller object fields will be set if data is available: asinList, asinListLastSeen, totalStorefrontAsinsCSV. If no data is available no additional tokens will be consumed. The ASIN list can contain up to 100,000 items. As using the storefront parameter does not trigger any new collection it does not increase the processing time of the request, though the response may be much bigger in size. The total storefront ASIN count will not be updated, only historical data will be provided (when available).

updateint, optional

Positive integer value. If the last live data collection from the Amazon storefront page is older than update hours force a new collection. Use this parameter in conjunction with the storefront parameter. Token cost will only be applied if a new collection is triggered.

Using this parameter you can achieve the following:

  • Retrieve data from Amazon: a storefront ASIN list containing up to 2,400 ASINs, in addition to all ASINs already collected through our database.

  • Force a refresh: Always retrieve live data with the value 0.

  • Retrieve the total number of listings of this seller: the totalStorefrontAsinsCSV field of the seller object will be updated.

waitbool, default: True

Wait for available tokens before querying the keepa backend.

typedbool, default: False

When True, return sellers as keepa.models.backend.Seller Pydantic models instead of dictionaries. Typed sellers use the raw backend time fields; to_datetime only applies to the default dictionary response.

Returns:
dict[str, dict[str, Any]] | dict[str, Seller]

One entry per input seller_id. Values are dictionaries by default and keepa.models.backend.Seller models when typed=True.

Notes

Seller data is not available for Amazon China.

Examples

Return the information from seller 'A2L77EE7U53NWQ'.

>>> import keepa
>>> key = "<REAL_KEEPA_KEY>"
>>> api = keepa.Keepa(key)
>>> seller_info = api.seller_query("A2L77EE7U53NWQ", "US")
>>> seller_info["A2L77EE7U53NWQ"]["sellerName"]
'Amazon Warehouse'