eBay Accepted offers API
Retrieve completed eBay sales for any keyword with the price the buyer actually paid, including accepted Best Offer amounts where available, plus the sale date, units sold, shipping, and format. History is available back to December 2023. Auctions are never Best Offers, so look at fixed-price sales. Results come back newest first, so with a small limit the sales can cover only the last few days of a date window; raise limit (up to 240) to cover more of it.
Tarifs
Tarifs de l’API eBay Accepted offers
Essayer
Obtenez eBay Accepted offers en une requête
{
"data": {
"items": [
{
"bestOfferAccepted": true,
"bidCount": 12500,
"condition": "example",
"image": "https://example.com/image.jpg",
"itemId": "a1b2c3d4",
"listingType": "general",
"shippingCost": "19.99",
"soldCurrency": "USD",
"soldPrice": 19.99,
"soldUtc": 12.5,
"title": "Example title",
"totalSales": 12500,
"unitsSold": 42,
"url": "https://example.com/page"
}
]
},
"found": true,
"reason": "not_found"
}Référence complète des paramètres et de la réponse : chaque champ, type et exemple de cet endpoint.
Référence
Une requête, une seule forme de réponse.
Chaque champ que vous envoyez et chaque champ que vous recevez, avec un vrai exemple.
Dernière vérification : 2026-11-20 · disponibilité et latence mesurées sur 30d
Corps de la requête
JSON, envoyé à cet endpoint.
- querystring
Gibson Les Paul Standard 60s
Search keyword for completed eBay sales (e.g. Gibson Les Paul Standard 60s).
- conditionenum
used
Filtre d’état de l’article (p. ex. used).
- endDatestring
Last sale day to include, as YYYY-MM-DD (e.g. 2026-10-31).
- limitinteger
10
Maximum number of sales to return (1-240, default 240). Sales without a listing title or image are left out, so a page can hold fewer.
- maxPricenumber
Optional maximum price paid, in USD (e.g. 2000). It trims the returned page; it does not search all history for sales at that price.
- minPricenumber
Optional minimum price paid, in USD (e.g. 200). It trims the returned page; it does not search all history for sales at that price.
- startDatestring
First sale day to include, as YYYY-MM-DD (e.g. 2026-10-01). History is available back to December 2023. With neither date set, the last 90 days are searched.
Réponse
JSON, une valeur d’exemple par champ.
Completed eBay sales, newest first: title, the price the buyer actually paid, sale date, units sold, shipping, format, and item URL. Populated whenever the provider has data for the entity.
- bestOfferAcceptedboolean
True when the sale was identified as a Best Offer the seller accepted, so soldPrice is the accepted offer (on a multi-unit listing, the rounded average paid per unit). Auctions are never Best Offers, so it is true only on fixed-price sales. False when it was not identified as one, which does not prove a full-price sale; sales from the last few hours are often not flagged yet. Absent when it could not be determined: on busy searches some older date windows come back with no Best Offer flag at all.
- bidCountinteger
Number of bids the listing received, for auction sales.
- conditionstring
Item condition (new or used), returned only when the request filtered by condition.
- imagestring
Primary listing image URL. Populated whenever the provider has data for the entity.
- itemIdstring
eBay item identifier. Populated whenever the provider has data for the entity.
- listingTypestring
Sale format: Auction or Fixed price.
- shippingCoststring
Shipping the buyer paid, in USD (e.g. "$18"; "$0" is free shipping).
- soldCurrencystring
ISO currency code of the price paid (USD).
- soldPricenumber
Price the buyer actually paid, in USD. On a Best Offer sale this is the accepted offer where available; when a listing sold more than one unit it is the average per unit (see unitsSold and totalSales).
- soldUtcnumber
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
- titlestring
Listing title as it appeared on eBay. Populated whenever the provider has data for the entity.
- totalSalesnumber
Total paid across all units sold, in USD, as the listing reported it. soldPrice is this total divided by unitsSold, rounded, so their product can differ slightly.
- unitsSoldinteger
Units sold in this sale; above 1 for a multi-unit listing.
- urlstring
Canonical listing URL. Populated whenever the provider has data for the entity.
- foundboolean
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
FAQ
À propos de l’API eBay Accepted offers
L’API eBay Accepted offers d’AnyAPI renvoie des données eBay en JSON normalisé à partir d’un appel POST à /v1/run/ebay.accepted_offers. Retrieve completed eBay sales for any keyword with the price the buyer actually paid, including accepted Best Offer amounts where available, plus the sale date, units sold, shipping, and format. History is available back to December 2023. Auctions are never Best Offers, so look at fixed-price sales. Results come back newest first, so with a small limit the sales can cover only the last few days of a date window; raise limit (up to 240) to cover more of it. AnyAPI renvoie un schéma normalisé unique quelle que soit la source qui répond. Elle coûte à partir de 3 $US pour 1 000 requêtes, en dollars US, sans abonnement et sans minimum mensuel. Ces 30 derniers jours, 100,0% des appels eBay Accepted offers passés par AnyAPI ont réussi, avec un temps de réponse médian de 2,3 secondes, sur 7 appels mesurés.