API para eBay

API para eBay: Buscar

Busque anúncios ativos do eBay por palavra-chave, com filtros opcionais de faixa de preço, condição do item, tipo de anúncio e ordenação, e receba título, preço, condição, frete e vendedor em uma resposta normalizada.

POST/v1/run/ebay.search
Disponibilidade
100,00%
30d · 95 chamadas
Requisições
95
30d · semanal, últimas 12 sem.
Resposta
7,7s
mediana · 30d

Rede de provedores

Provedores ordenados por tráfego

Provedores
Octopus68 atendidas100,00% de disponibilidade7567ms p5071,6%US$ 2,62/mil resultadosaté US$ 0,0655 / requisiçãoBadgerTentado primeiro23 atendidas65,71% de disponibilidade5564ms p5024,2%US$ 0,50/mil req.preço fixoChameleon4 atendidas100,00% de disponibilidade4657ms p504,2%US$ 1,75/mil req.preço fixo

Teste

Faça sua primeira requisição

conditionarray
Filtra por uma ou mais condições do item; omita para todas as condições (ex.: ["new", "open_box"]).
requireFieldsarray
Opcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `sellerName`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir ausente em um anúncio que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança.
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": {
    "items": [
      {
        "bidCount": 12500,
        "condition": "example",
        "currency": "USD",
        "image": "https://example.com/image.jpg",
        "itemId": "a1b2c3d4",
        "listingType": "general",
        "price": 19.99,
        "sellerFeedbackCount": 12500,
        "sellerFeedbackPercent": 12.5,
        "sellerName": "Example title",
        "shippingCost": "19.99",
        "title": "Example title",
        "url": "https://example.com/page"
      }
    ]
  },
  "found": true,
  "reason": "not_found"
}
Interface da resposta
interface EbaySearchResponse {
  data: {
    items: {
      bidCount?: number;
      condition?: string;
      currency?: string;
      image?: string;
      itemId: string;
      listingType?: string | null;
      price?: number;
      sellerFeedbackCount?: number | null;
      sellerFeedbackPercent?: number | null;
      sellerName?: string | null;
      shippingCost?: string;
      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.search
curl -X POST https://api.getanyapi.com/v1/run/ebay.search \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":3,"query":"nintendo switch","sort":"price_low"}'
CampoTipoValor de exemplo
Corpo da requisição
querystring"nintendo switch"Palavras-chave de busca, ex.: "nintendo switch" ou "vintage levis 501".
conditionarrayFiltra por uma ou mais condições do item; omita para todas as condições (ex.: ["new", "open_box"]).
limitinteger3Número máximo de resultados a retornar (1 a 25, padrão 25).
listingTypeenumRestringe a um formato de anúncio; omita ou use all para ambos (ex.: buy_it_now para apenas preço fixo).
maxPriceintegerPreço máximo opcional do item em USD.
minPriceintegerPreço mínimo opcional do item em USD.
requireFieldsarrayOpcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `sellerName`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir ausente em um anúncio que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança.
sortenum"price_low"Ordem dos resultados; omita para usar a Melhor correspondência do eBay (ex.: price_low ordena pelo menor preço mais frete primeiro).
Resposta
dataobject
data.itemsobject[]Listing records: title, price, condition, shipping cost, seller info, image, and item URL. Populated whenever the provider has data for the entity.
data.items[].bidCountintegerBids placed so far, for auction listings.
data.items[].conditionstring
data.items[].currencystringISO currency code of the price (e.g. USD).
data.items[].imagestringPrimary listing image URL. Populated whenever the provider has data for the entity.
data.items[].itemIdstringeBay item identifier. Populated whenever the provider has data for the entity.
data.items[].listingTypepode ser exigidostringAuction, FixedPrice, etc. Null when the serving source does not publish the listing format.
data.items[].pricenumberListing price.
data.items[].sellerFeedbackCountpode ser exigidonumberSeller's lifetime feedback count, or null when the serving source does not publish it.
data.items[].sellerFeedbackPercentpode ser exigidonumberSeller positive-feedback percentage, or null when the serving source does not publish it.
data.items[].sellerNamepode ser exigidostringSeller username, or null when the serving source does not publish the seller.
data.items[].shippingCoststringShipping cost or free-delivery label.
data.items[].titlestringPopulated whenever the provider has data for the entity.
data.items[].urlstringPopulated 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,0005
Preço /mil req.USDUS$ 0,50

Dúvidas frequentes

Sobre o endpoint Buscar da API para eBay

O endpoint Buscar da AnyAPI para eBay retorna dados de eBay em JSON normalizado com uma chamada POST para /v1/run/ebay.search. Busque anúncios ativos do eBay por palavra-chave, com filtros opcionais de faixa de preço, condição do item, tipo de anúncio e ordenação, e receba título, preço, condição, frete e vendedor em uma resposta normalizada. A AnyAPI distribui cada requisição entre 3 fontes, com failover automático quando uma falha. Custa a partir de US$ 0,50 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint Buscar da API para eBay feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 7,7 segundos, em 95 chamadas medidas.

Custa a partir de US$ 0,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.

Busque anúncios ativos do eBay por palavra-chave, com filtros opcionais de faixa de preço, condição do item, tipo de anúncio e ordenação, e receba título, preço, condição, frete e vendedor em uma resposta normalizada. 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, 100,0% das chamadas ao endpoint Buscar da API para eBay feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 7,7 segundos, em 95 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.
Mais para chamar

Outros endpoints de eBay

Produtoa partir de US$ 0,50 /mil req.Produto (versão completa)a partir de US$ 1,80 /mil req.Anúncios vendidosa partir de US$ 13,50 /mil req.Anúncios vendidos (versão resumida)a partir de US$ 13,50 /mil req.