API para eBay

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.

POST/v1/run/ebay.sold_listings
Disponibilidade
98,79%
30d · 165 chamadas
Requisições
165
30d · semanal, últimas 12 sem.
Resposta
8,5s
mediana · 30d

Preços

Um preço, em dólares

Teste

Faça sua primeira requisição

Abrir em
Obter chave grátis
Resposta de exemplo
Execuções grátis retornam só os primeiros 3 resultados. Recarregue uma chave para receber a resposta completa.
{
  "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 da resposta
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 30d
POST /v1/run/ebay.sold_listings
curl -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"}'
CampoTipoValor de exemplo
Corpo da requisição
querystring"iphone 13 pro"Palavra-chave de busca para itens vendidos (ex.: iphone 13 pro).
categoryIdstringID numérico opcional da categoria do eBay para buscar dentro dela (ex.: 9355 para Cell Phones & Smartphones, 9394 para Cell Phone Accessories).
conditionenumFiltro de condição do item (ex.: used).
endDatestringRetorna 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.
freeShippingbooleanNão suportado pelas fontes atuais: só false (sem filtro) é aceito; true é recusado sem cobrança.
limitinteger10Número máximo de resultados a retornar (1-25, padrão 25).
listingTypeenumRestringe a um formato de anúncio; omita ou use all para ambos (ex.: auction para apenas vendas em leilão).
maxPricenumberPreço máximo de venda opcional na moeda do site (ex.: 500).
minPricenumberPreço mínimo de venda opcional na moeda do site (ex.: 200).
pageintegerPá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.
returnsAcceptedbooleanNão suportado pelas fontes atuais: só false (sem filtro) é aceito; true é recusado sem cobrança.
sellerstringNão suportado pelas fontes atuais: uma requisição que o define é recusada sem cobrança.
siteenumSite do eBay por país a ser buscado. A cobertura de anúncios vendidos é atualmente apenas dos EUA.
sortenum"ended_recently"Ordem dos resultados; se omitido, usa ended_recently (ex.: price_high ordena pelo maior preço de venda mais frete primeiro).
startDatestringRetorna apenas anúncios vendidos nesta data ou depois, inclusive, no formato YYYY-MM-DD (ex.: 2026-09-01).
Resposta
dataobject
data.hasMorebooleanTrue 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.itemsobject[]Sold listing records: title, sold price, sale date, condition, seller, and item URL. Populated whenever the provider has data for the entity.
data.items[].bestOfferAcceptedbooleanTrue when eBay marked the sale as Best Offer accepted. Absent when the source could not tell.
data.items[].bidCountintegerNumber of bids the listing received, for auction sales.
data.items[].conditionstringItem condition as listed (e.g. Pre-Owned).
data.items[].countryCodestringISO country code of the eBay marketplace the sale happened on.
data.items[].epidstringeBay catalog product identifier (ePID), when the listing is matched to a catalog product.
data.items[].imagestringPrimary listing image URL. Populated whenever the provider has data for the entity.
data.items[].imagesstring[]All listing image URLs, primary first.
data.items[].itemIdstringeBay item identifier. Populated whenever the provider has data for the entity.
data.items[].listingTypestringSale format: Auction or Fixed price.
data.items[].sellerFeedbackCountintegerSeller's lifetime feedback count. Populated whenever the provider has data for the entity.
data.items[].sellerFeedbackPercentnumberSeller's positive-feedback percentage. Populated whenever the provider has data for the entity.
data.items[].sellerUsernamestringSeller's eBay username. Populated whenever the provider has data for the entity.
data.items[].shippingCoststringShipping the buyer paid, in the site currency (e.g. "$5.55"; "$0" is free shipping).
data.items[].soldCurrencystringISO currency code of the sold price (e.g. USD).
data.items[].soldPricenumberFinal 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[].soldUtcnumberUTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
data.items[].titlestringListing title as it appeared on eBay. Populated whenever the provider has data for the entity.
data.items[].urlstringCanonical 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.
Preço
Preço por requisiçãoUSDUS$ 0,0135
Preço /mil req.USDUS$ 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.

Custa a partir de US$ 13,50 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Você recarrega uma carteira em dólares e cada chamada desconta dela. Algumas requisições pagas pela carteira que falham geram cobranças de processamento, que repassamos pelo custo, sem margem; a resposta de erro mostra o valor cobrado.

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 resposta é JSON normalizado, com o mesmo envelope que todo endpoint da AnyAPI retorna, então processar um segundo endpoint é só trocar a URL, e nada mais.

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. Estas são medições da própria AnyAPI sobre o tráfego que passa pelo gateway, recalculadas continuamente, e não uma meta de nível de serviço publicada.