keepa.models.backend.Seller#

pydantic model keepa.models.backend.Seller#

Backend Seller model generated from the Keepa Java schema.

Fields:
field address: list[str | None] | None = None#

The business address. Each entry of the array contains one address line. The last entry contains the 2 letter country code. null if not available. Example: [123 Main Street, New York, NY, 10001, US]

field asinList: list[str | None] | None = None#

Only available if the storefront parameter was used and only updated if the update parameter was utilized.

String array containing up to 100,000 storefront ASINs, sorted by freshest first. The corresponding

time stamps can be found in the asinListLastSeen field.

Example: [“B00M0QVG3W”, “B00M4KCH2A”]

field asinListLastSeen: list[int | None] | None = None#

Only available if the storefront parameter was used and only updated if the update parameter was utilized.

Contains the last time (in Keepa Time minutes) we were able to verify each ASIN in the asinList field.

asinList and asinListLastSeen share the same indexation, so the corresponding time stamp

for asinList[10] would be asinListLastSeen[10].

Use KeepaTime.keepaMinuteToUnixInMillis(int) (long) to get an uncompressed timestamp (Unix epoch time).

Example: [2711319, 2711311]

field avgBuyBoxCompetitors: float | None = None#

Average number of sellers competing for the Buy Box of this seller’s products (this seller included).

field businessName: str | None = None#

The business name. null if not available. Example: Keepa GmbH

field businessType: str | None = None#

The business type. null if not available. Example: Unternehmen in Privatbesitz

field buyBoxNewOwnershipRate: int | None = None#

Average New Buy Box ownership percentage

field buyBoxUsedOwnershipRate: int | None = None#

Average Used Buy Box ownership percentage

field competitors: list[Competitors | None] | None = None#

The top five sellers most commonly offering the same products as this seller.

field csv: list[list[int | None] | None] | None = None#

Two dimensional history array that contains history data for this seller. First dimension index:

MerchantCsvType

0 - RATING: The merchant’s rating in percent, Integer from 0 to 100. 1 - RATING_COUNT: The merchant’s total rating count, Integer.

field currentRating: int | None = None#
field currentRatingCount: int | None = None#
field customerServicesAddress: list[str | None] | None = None#

The customer services address. Each entry of the array contains one address line. The last entry contains the 2 letter country code. null if not available. Example: [123 Main Street, New York, NY, 10001, US]

field domainId: int | None = None#

The domainId of the products Amazon locale AmazonLocale

field email: str | None = None#

The email address of the business. null if not available. Example: info@keepa.com

field hasFBA: bool | None = None#

Boolean value indicating whether or not the seller currently has FBA listings.

This value is usually correct, but could be set to false even if the seller has FBA listings, since we are not always aware of all

seller listings. This can especially be the case with sellers with only a few listings consisting of slow-selling products.

field lastRatingUpdate: int | None = None#

States the time of our last rating data update of this seller, in Keepa Time minutes.

Use KeepaTime.keepaMinuteToUnixInMillis(int) (long) to get an uncompressed timestamp (Unix epoch time).

field lastUpdate: int | None = None#

States the time of our last update of this seller, in Keepa Time minutes.

Use KeepaTime.keepaMinuteToUnixInMillis(int) (long) to get an uncompressed timestamp (Unix epoch time).

field negativeRating: list[int | None] | None = None#

Contains the negative percentage ratings for the last 30 days, 90 days, 365 days and lifetime, in that order. A negative rating is a 1 or 2 star rating. Example: [3, 1, 1, 3]

field neutralRating: list[int | None] | None = None#

Contains the neutral percentage ratings for the last 30 days, 90 days, 365 days and lifetime, in that order. A neutral rating is a 3 star rating. Example: [1, 1, 1, 2]

field phoneNumber: str | None = None#

The phone number. null if not available. Example: 800 1234 567

field positiveRating: list[int | None] | None = None#

Contains the positive percentage ratings for the last 30 days, 90 days, 365 days and lifetime, in that order. A positive rating is a 4 or 5 star rating. Example: [96, 98, 98, 95]

field ratingCount: list[int | None] | None = None#

Contains the rating counts for the last 30 days, 90 days, 365 days and lifetime, in that order. Example: [3, 10, 98, 321]

field ratingsLast30Days: int | None = None#
field recentFeedback: list[FeedbackObject | None] | None = None#

Contains up to 5 of the most recent customer feedbacks. Each feedback object in the array contains the following fields

field representative: str | None = None#

The name of the business representative. null if not available. Example: Max Mustermann

field sellerBrandStatistics: list[MerchantBrandStatistics | None] | None = None#

Statistics about the primary brands of this seller. Based on our often incomplete and outdated product offers data.

field sellerCategoryStatistics: list[MerchantCategoryStatistics | None] | None = None#

Statistics about the primary categories of this seller. Based on our often incomplete and outdated product offers data.

field sellerId: str | None = None#

The seller id of the merchant.

Example: A2L77EE7U53NWQ (Amazon.com Warehouse Deals)

field sellerName: str | None = None#

The name of seller.

Example: Amazon Warehouse Deals

field shareCapital: str | None = None#

The share capital. null if not available. Example: 25000

field shipsFromChina: bool | None = None#

Indicating whether or not this seller ships from China.

field totalStorefrontAsins: list[int | None] | None = None#

Contains the number of storefront ASINs, based on our database, if available and the last update of that metric.

Is null if not available (no storefront was ever retrieved). This field is available in the

default Request Seller Information (storefront parameter is not required).

Use KeepaTime.keepaMinuteToUnixInMillis(int) (long) to get an uncompressed timestamp (Unix epoch time).

Has the format: [ last update of the storefront in Keepa Time minutes, the count of storefront ASINs ]

Example: [2711319, 1200]

field totalStorefrontAsinsCSV: list[int | None] | None = None#

Only available if the storefront parameter was used and only updated if the update parameter was utilized.

Contains the total amount of listings of this seller. Includes historical data

asinList and asinListLastSeen share the same indexation, so the corresponding time stamp

for asinList[10] would be asinListLastSeen[10]. Has the format: Keepa Time minutes, count, …

Use KeepaTime.keepaMinuteToUnixInMillis(int) (long) to get an uncompressed timestamp (Unix epoch time).

Example: [2711319, 1200, 2711719, 1187]

field trackedSince: int | None = None#

States the time we have started tracking this seller, in Keepa Time minutes.

Use KeepaTime.keepaMinuteToUnixInMillis(int) (long) to get an uncompressed timestamp (Unix epoch time).

field tradeNumber: str | None = None#

The Trade Register Number. null if not available. Example: HRB 123 456

field vatID: str | None = None#

The VAT number. null if not available. Example: DE123456789