Skip to main content

​
Seller Selection Criteria Object

Example Seller Selection Criteria Object
{
  "addon": false,
  "condition_in": ["New"],
  "handling_days_max": 6,
  "max_item_price": 5350,
  "min_seller_num_ratings": 100,
  "prime": true
}
Seller selection criteria allow you to filter multiple offers for a product from a retailer. They give you fine grained control when a retailer has multiple offers for a single product. This happens frequently when third party or affiliated merchants are selling on a platform, such as on Amazon. The seller selection criteria serve as a series of optional filters to narrow down the potential set of offers to something reasonable. After all the filters have been applied, Zinc will select the cheapest offer that is still available. For example, if "handling_days_max": 6 is applied, then the Zinc API will order the cheapest offer where the shipping will arrive in 6 days or less.

​
Attributes

AttributeTypeDescription
addonBoolean(Amazon only) Specifies whether the selected offer should be an addon item
buy_boxBoolean(Amazon only) Specifies whether the selected offer should be Amazon’s default buy box offer
condition_inArrayAn array of item conditions that the Zinc API must order from
condition_not_inArrayAn array of item conditions that the Zinc API must not order from
first_party_sellerBooleanIs the seller first-party? e.g. sold by Walmart.com on walmart
handling_days_maxNumberThe maximum number of allowable days for shipping and handling
internationalBooleanSpecifies whether the item should come from an international supplier
max_item_priceNumberThe maximum allowable price in cents for an item
merchant_id_inArray(Amazon only) An array of merchant ids that the Zinc API must order from
merchant_id_not_inArray(Amazon only) An array of merchant ids that the Zinc API must not order from
merchant_name_not_inArray(Amazon only) An array of seller names to exclude. If a seller’s name matches any string in this list, their offer will be rejected. Useful when you want to exclude specific sellers but don’t have their merchant ID.
min_seller_num_ratingsNumber(Amazon only) The minimum number of ratings required for an Amazon seller’s offer to be selected
min_seller_percent_positive_feedbackNumber(Amazon only) The minimum percentage of positive ratings of an Amazon seller for their offer to be selected
primeBoolean(Amazon only) Specifies whether the selected offer should be an Amazon Prime offer
allow_slow_primeBoolean(Amazon only) When true, allows Prime offers even if their delivery time exceeds handling_days_max, as long as delivery is within 7 days. Useful when you want to prioritize Prime eligibility over strict delivery speed requirements.
require_fba_badgeBoolean(Amazon only) When true, requires the offer to be Fulfilled by Amazon (FBA). Offers from third-party sellers not using FBA will be rejected, unless the seller is Amazon itself.
allow_oosBoolean(Amazon only) Specifies whether we should still attempt to complete ordering with the cheapest offer if all offers appear unavailable