The BuyBox is a mechanism to determine the best offer for a customer. The offer of the BuyBox winner will be shown as main offer for a product on refurbed. The BuyBox allows merchants to compete for customers on refurbed products. refurbed determines the ranking of the BuyBox by an algorithm that takes many different aspects into account, such as the quality of the products, good inventory management, fast shipping times, and quick response times to customer tickets, to just mention a few.

All services and operations concerning the shipping profiles must be called with OfferService in the URL followed by the command/operation.

E.g.: https://api.refurbed.com/refb.merchant.v1.OfferService/ListOffers

All calls must be done using POST method.

Read (OfferService / MarketOfferService)

refurbed provides BuyBox-related information for your market offers. There you can see for example whether your offer won the BuyBox for a specific market or whether it could win it with a price adjustment. This BuyBox-specific state and information can help you to adjust your market offer min prices and potentially win the BuyBox.

If your market offer is visible, the BuyBox-specific information is divided into the BuyBox state and the BuyBox information.

There are different ways to poll for BuyBox-related information. You can use the ListOffers / GetOffer / BatchGetOffers endpoints of the OfferService to read the BuyBox data for all your offers and markets. Or you can filter for specific SKUs, markets, market offer visibility and/or BuyBox state with the ListMarketOffers / GetMarketOffer / BatchGetMarketOffer endpoints of the MarketOfferService.

If you want to compete effectively for the buybox we suggest to use ListMarketOffers and apply the following filter in the request:

{
  "filter": {
    "market_price_instance_buybox_state": {
      "any_of": [
        "ELIGIBLE"
      ]
    }
  }
}

This request will only return you market offers that are eligible to win the buybox including suggested prices that you can set in a follow-up batch update call.

<aside> ⚠️

Polling for all your market offers using the MarketOfferService can quickly add up to too many API requests. We always recommend filtering e.g. like above or for specific SKUs. Please make sure to comply with our rate limits.

</aside>

‣ Market prices

The market_price gives you information about the specific market offer, whether refurbed has a localized website for the market, whether the market price is calculated by refurbed or set by the seller themselves, and the market-specific price and currency.

If the market price is calculated by refurbed (is_calculated is true), refurbed uses the offer’s reference_price, reference_min_price (if available), and reference_currency_code as reference. Otherwise (is_calculated is false) the price, min price, and currency code that are set by the seller are returned.

If refurbed has a localized website for the market (is_site_market is true) also the currency code, price, and min price in the currency of the site market are shown.

‣ Market Offer visibility