Seller Selection Criteria - Zinc API Documentation

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

Attribute	Type	Description
`addon`	Boolean	(Amazon only) Specifies whether the selected offer should be an addon item
`buy_box`	Boolean	(Amazon only) Specifies whether the selected offer should be Amazon’s default buy box offer
`condition_in`	Array	An array of item conditions that the Zinc API must order from
`condition_not_in`	Array	An array of item conditions that the Zinc API must not order from
`first_party_seller`	Boolean	Is the seller first-party? e.g. sold by Walmart.com on walmart
`handling_days_max`	Number	The maximum number of allowable days for shipping and handling
`international`	Boolean	Specifies whether the item should come from an international supplier
`max_item_price`	Number	The maximum allowable price in cents for an item
`merchant_id_in`	Array	(Amazon only) An array of merchant ids that the Zinc API must order from
`merchant_id_not_in`	Array	(Amazon only) An array of merchant ids that the Zinc API must not order from
`merchant_name_not_in`	Array	(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_ratings`	Number	(Amazon only) The minimum number of ratings required for an Amazon seller’s offer to be selected
`min_seller_percent_positive_feedback`	Number	(Amazon only) The minimum percentage of positive ratings of an Amazon seller for their offer to be selected
`prime`	Boolean	(Amazon only) Specifies whether the selected offer should be an Amazon Prime offer
`allow_slow_prime`	Boolean	(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_badge`	Boolean	(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_oos`	Boolean	(Amazon only) Specifies whether we should still attempt to complete ordering with the cheapest offer if all offers appear unavailable

​Seller Selection Criteria Object

​Attributes

Seller Selection Criteria Object

Attributes