API para eBay: Anúncios vendidos
Obtenha anúncios do eBay vendidos recentemente para qualquer palavra-chave, com filtros opcionais de faixa de preço, condição, categoria, data de venda e ordenação, página por página (preço de venda, data da venda, condição, vendedor, detalhes do item); ideal para pesquisa de preços.
Preços
Um preço, em dólares
Teste
Faça sua primeira requisição
{
"data": {
"hasMore": true,
"items": [
{
"bestOfferAccepted": true,
"bidCount": 12500,
"condition": "example",
"countryCode": "US",
"epid": "a1b2c3d4",
"image": "https://example.com/image.jpg",
"images": [
"https://example.com/image.jpg"
],
"itemId": "a1b2c3d4",
"listingType": "general",
"sellerFeedbackCount": 12500,
"sellerFeedbackPercent": 12.5,
"sellerUsername": "alex_rivera",
"shippingCost": "19.99",
"soldCurrency": "USD",
"soldPrice": 19.99,
"soldUtc": 12.5,
"title": "Example title",
"url": "https://example.com/page"
}
]
},
"found": true,
"reason": "not_found"
}interface EbaySoldListingsResponse {
data: {
hasMore?: boolean;
items: {
bestOfferAccepted?: boolean;
bidCount?: number;
condition?: string;
countryCode?: string;
epid?: string;
image?: string;
images?: string[];
itemId: string;
listingType?: string;
sellerFeedbackCount?: number;
sellerFeedbackPercent?: number;
sellerUsername?: string;
shippingCost?: string;
soldCurrency?: string;
soldPrice?: number;
soldUtc?: number;
title: string;
url: string;
}[];
} | null;
found: boolean;
reason?: "not_found";
}Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.
Referência
Requisição, resposta e preço
Última verificação em 2026-09-29 · disponibilidade e latência medidas em 30dcurl -X POST https://api.getanyapi.com/v1/run/ebay.sold_listings \
-H "Authorization: Bearer $ANYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"limit":10,"query":"iphone 13 pro","sort":"ended_recently"}'| Campo | Tipo | Valor de exemplo |
|---|---|---|
| Corpo da requisição | ||
| query | string | "iphone 13 pro"Palavra-chave de busca para itens vendidos (ex.: iphone 13 pro). |
| categoryId | string | ID numérico opcional da categoria do eBay para buscar dentro dela (ex.: 9355 para Cell Phones & Smartphones, 9394 para Cell Phone Accessories). |
| condition | enum | Filtro de condição do item (ex.: used). |
| endDate | string | Retorna apenas anúncios vendidos nesta data ou antes, inclusive, no formato YYYY-MM-DD (ex.: 2026-09-15). Esse limite é aplicado a cada página depois de buscada, então uma página pode ter menos de limit anúncios, ou nenhum, enquanto hasMore ainda é true: continue pedindo a próxima página até hasMore ser false. |
| freeShipping | boolean | Não suportado pelas fontes atuais: só false (sem filtro) é aceito; true é recusado sem cobrança. |
| limit | integer | 10Número máximo de resultados a retornar (1-25, padrão 25). |
| listingType | enum | Restringe a um formato de anúncio; omita ou use all para ambos (ex.: auction para apenas vendas em leilão). |
| maxPrice | number | Preço máximo de venda opcional na moeda do site (ex.: 500). |
| minPrice | number | Preço mínimo de venda opcional na moeda do site (ex.: 200). |
| page | integer | Página de resultados, começando em 1. Use com hasMore na saída para paginar e mantenha query, filtros e limit iguais ao percorrer as páginas, porque limit define o tamanho da página. |
| returnsAccepted | boolean | Não suportado pelas fontes atuais: só false (sem filtro) é aceito; true é recusado sem cobrança. |
| seller | string | Não suportado pelas fontes atuais: uma requisição que o define é recusada sem cobrança. |
| site | enum | Site do eBay por país a ser buscado. A cobertura de anúncios vendidos é atualmente apenas dos EUA. |
| sort | enum | "ended_recently"Ordem dos resultados; se omitido, usa ended_recently (ex.: price_high ordena pelo maior preço de venda mais frete primeiro). |
| startDate | string | Retorna apenas anúncios vendidos nesta data ou depois, inclusive, no formato YYYY-MM-DD (ex.: 2026-09-01). |
| Resposta | ||
| data | object | |
| data.hasMore | boolean | True when another results page exists. With endDate set a page can be short or empty while this is still true; request page + 1 to continue. |
| data.items | object[] | Sold listing records: title, sold price, sale date, condition, seller, and item URL. Populated whenever the provider has data for the entity. |
| data.items[].bestOfferAccepted | boolean | True when eBay marked the sale as Best Offer accepted. Absent when the source could not tell. |
| data.items[].bidCount | integer | Number of bids the listing received, for auction sales. |
| data.items[].condition | string | Item condition as listed (e.g. Pre-Owned). |
| data.items[].countryCode | string | ISO country code of the eBay marketplace the sale happened on. |
| data.items[].epid | string | eBay catalog product identifier (ePID), when the listing is matched to a catalog product. |
| data.items[].image | string | Primary listing image URL. Populated whenever the provider has data for the entity. |
| data.items[].images | string[] | All listing image URLs, primary first. |
| data.items[].itemId | string | eBay item identifier. Populated whenever the provider has data for the entity. |
| data.items[].listingType | string | Sale format: Auction or Fixed price. |
| data.items[].sellerFeedbackCount | integer | Seller's lifetime feedback count. Populated whenever the provider has data for the entity. |
| data.items[].sellerFeedbackPercent | number | Seller's positive-feedback percentage. Populated whenever the provider has data for the entity. |
| data.items[].sellerUsername | string | Seller's eBay username. Populated whenever the provider has data for the entity. |
| data.items[].shippingCost | string | Shipping the buyer paid, in the site currency (e.g. "$5.55"; "$0" is free shipping). |
| data.items[].soldCurrency | string | ISO currency code of the sold price (e.g. USD). |
| data.items[].soldPrice | number | Final sold price in the site currency. When bestOfferAccepted is true this is the listing's asking price: eBay does not publish the accepted offer amount. |
| data.items[].soldUtc | number | UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. |
| data.items[].title | string | Listing title as it appeared on eBay. Populated whenever the provider has data for the entity. |
| data.items[].url | string | Canonical listing URL. Populated whenever the provider has data for the entity. |
| found | boolean | |
| 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. |
| Preço | ||
| Preço por requisição | USD | US$ 0,0135 |
| Preço /mil req. | USD | US$ 13,50 |
Dúvidas frequentes
Sobre o endpoint Anúncios vendidos da API para eBay
O endpoint Anúncios vendidos da AnyAPI para eBay retorna dados de eBay em JSON normalizado com uma chamada POST para /v1/run/ebay.sold_listings. Obtenha anúncios do eBay vendidos recentemente para qualquer palavra-chave, com filtros opcionais de faixa de preço, condição, categoria, data de venda e ordenação, página por página (preço de venda, data da venda, condição, vendedor, detalhes do item); ideal para pesquisa de preços. A AnyAPI retorna um schema normalizado, seja qual for a fonte que atende. Custa a partir de US$ 13,50 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 98,8% das chamadas ao endpoint Anúncios vendidos da API para eBay feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 8,5 segundos, em 165 chamadas medidas.