eBay support is coming to PriceFetch. This guide covers how auction prices, buy-it-now, and international eBay domains will work with the API.
eBay pricing is fundamentally different from retailers like Amazon or Walmart. Instead of a single fixed price, eBay listings can be auctions (dynamic bidding), buy-it-now (fixed price), or a hybrid of both. This creates unique challenges for price APIs.
PriceFetch is adding eBay support with a clear approach: return the current actionable price. For buy-it-now listings, that's the buy-it-now price. For auctions, it's the current bid amount. For hybrid listings, both values will be available.
This guide covers how eBay data will work when support launches. Sign up for 500 free credits to be ready when it goes live.
Try it yourself — 500 free API credits, no credit card required.
Start FreeeBay has three pricing models, and each requires different handling:
**Buy-It-Now (Fixed Price):** Works like any other retailer — the product has a set price. The API will return this price directly. Most commercial eBay sellers use buy-it-now exclusively.
**Auction:** The price changes as bidders compete. The API will return the current bid amount and the number of bids. The price is only meaningful in the context of the auction's remaining time — a $5 bid with 3 days left will likely go higher.
**Best Offer:** Some listings accept offers below the listed price. The API will return the listed price, with a flag indicating that offers are accepted. The actual sold price depends on negotiation and isn't knowable via the listing page.
For price comparison and monitoring use cases, buy-it-now listings are the most useful since the price is definitive. Auction prices are snapshots that change constantly.
eBay operates on many country-specific domains, each with local currency pricing. Planned domain support includes:
- ebay.com (US, USD) - ebay.co.uk (UK, GBP) - ebay.de (Germany, EUR) - ebay.fr (France, EUR) - ebay.it (Italy, EUR) - ebay.es (Spain, EUR) - ebay.com.au (Australia, AUD) - ebay.ca (Canada, CAD) - ebay.co.jp (Japan, JPY)
Like Amazon, the API will detect the domain from the URL and return the appropriate local currency. Cross-domain price comparison will require your own currency conversion.
eBay's Global Shipping Program (GSP) adds international shipping costs that aren't part of the item price. The API will return the item price only, not shipping or import fees.
Several eBay-specific factors make price data more complex than standard retail:
**Condition:** eBay sells new, refurbished, and used items. The same product can have wildly different prices based on condition. The API response will include condition information.
**Shipping costs:** Unlike Amazon (where many items have free shipping), eBay listings often have separate shipping costs that significantly affect the total price. The API will return the item price and shipping cost as separate fields.
**Multi-quantity listings:** A single eBay listing can offer multiple items. The API will return the per-unit price.
**Ended listings:** eBay keeps ended listings visible with their final price. The API will return an appropriate status for ended listings rather than treating them as "in stock."
**Promoted listings:** eBay sellers can pay for listing promotion, which affects search ranking but not price. The API returns the same price regardless of promotion status.
The eBay response will follow PriceFetch's standard envelope format with additional eBay-specific fields. The core fields (price, currency, in_stock, retailer) stay the same for compatibility with multi-retailer code.
Additional fields planned for eBay include listing type (auction/buy-it-now/best-offer), condition (new/refurbished/used), shipping cost, bid count (for auctions), and time remaining (for auctions). These will be nested under a `retailer_data` field to keep the top-level response consistent across retailers.
# Planned eBay response format (subject to change)
{
"success": true,
"data": {
"url": "https://www.ebay.com/itm/123456789",
"price": 299.99,
"currency": "USD",
"in_stock": true,
"retailer": "ebay",
"timestamp": "2026-03-22T14:00:00Z"
},
"credits_remaining": 490,
"request_id": "req_ghi789"
}Sign up in 30 seconds. No credit card required. One credit per successful API call.