API para 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.
Preços
Preços do endpoint Accepted offers da API para eBay
Teste
Obtenha Accepted offers do eBay em uma só requisição
{
"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"
}Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.
Referência
Uma requisição, um formato de resposta.
Cada campo que você envia e cada campo que você recebe, cada um com um exemplo real.
Última verificação em 2026-11-20 · disponibilidade e latência medidas em 30d
Corpo da requisição
JSON, enviado via POST para este endpoint.
- querystring
Gibson Les Paul Standard 60s
Search keyword for completed eBay sales (e.g. Gibson Les Paul Standard 60s).
- conditionenum
used
Filtro de condição do item (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.
Resposta
JSON, um valor de exemplo por campo.
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.
Dúvidas frequentes
Sobre o endpoint Accepted offers da API para eBay
O endpoint Accepted offers da AnyAPI para eBay retorna dados de eBay em JSON normalizado com uma chamada POST para /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. A AnyAPI retorna um schema normalizado, seja qual for a fonte que atende. Custa a partir de US$ 3 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint Accepted offers da API para eBay feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 2,3 segundos, em 7 chamadas medidas.