Overview
Fee estimate and competitive price of a listing.
Before changing a price, the seller wants to know what the marketplace charges and which price wins the dispute. Two routes answer this per listing.
Where this fits in the journey: Grow and track.
Endpoints
| Method | Path | What it does |
|---|---|---|
POST | /v1/listings/{listingId}/fee-estimates | Estimate fees |
GET | /v1/listings/{listingId}/competitive-prices | Get competitive prices |
All of them need Authorization: Bearer mk_your_api_key. See Authentication.
Fee estimate
You send a price (or use the current one) and get the fees in cents: commission, fixed_fee, shipping and others. You also get the net amount: netAmountInCents = priceInCents × quantity - totalFeesInCents. It is a job, and the result is in the item. It works before publishing.
Competitive price
Shows, per binding, the status in the dispute (winning, competing, not_competing…), the priceToWinInCents and the suggestedPriceInCents. Reads our database, kept fresh by sync. A marketplace that does not report a field returns null.
A marketplace without these operations returns 422. See the capabilities of the Connection.