> ## Documentation Index
> Fetch the complete documentation index at: https://www.zinc.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Seller Selection Criteria

> Seller selection criteria object structure and attributes

## Seller Selection Criteria Object

```json Example Seller Selection Criteria Object theme={null}
{
  "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                                                                                                     |