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.

Comece grátisBaixar amostraou JSON

US$ 0,75/mil req., pague por requisição, sem assinatura.

nintendo switch | eBay
ebay.com/sch/i.html?_nkw=nintendo+switch
Hi! Sign inor registerDaily DealsBrand OutletGift CardsHelp & ContactShip toSellWatchlistMy eBay
ebay
All Categoriesnintendo switch
Advanced
3+ results for nintendo switch

Condition

Buying format

Price

Item location

photo

Nintendo Switch Lite Handheld Console - Turquoise - Used

Used · 12 bids

$129.5

+$8.99 shipping

retro_games_hub (3204) 97.8%

photo

Nintendo Switch Console (Original 2017 Model) - Neon Red/Blue

Used

$179.99

Free shipping

consoleworld_usa (9871) 98.1%

photo

Nintendo Switch OLED Model Console - White

New

$249.99

Free shipping

game_deals_plus (41209) 99.5%

O que a API retornouitems[0]
{
"itemId": "225876341102",
"title": "Nintendo Switch Lite Handheld Console - Turquoise - Used",
"url": "https://www.ebay.com/itm/225876341102",
"price": 129.5,
"condition": "Used",
"listingType": "Auction",
"sellerName": "retro_games_hub",
"sellerFeedbackPercent": 97.8,
+5 campos a mais
}
Disponibilidade
100,00%
30d · 19.316 chamadas
Requisições
19.316
30d · semanal, últimas 12 sem.
Resposta
3,8s
mediana · 30d

Preços e provedores

Preços do endpoint Buscar da API para eBay: uma API, 3 provedores intercambiáveis

O provedor mais barato atende primeiro. Se ele falhar, o próximo assume na mesma chamada.

Provedor
1BadgerAtende primeiro99,63% de disponibilidade3671ms p5098,3% das chamadasUS$ 0,75/mil req.flat2ChameleonReserva 198,85% de disponibilidade4426ms p501,3% das chamadasUS$ 1,75/mil req.flat3OctopusReserva 2100,00% de disponibilidade7733ms p500,4% das chamadasUS$ 2,62/mil resultadosaté US$ 0,0655 / requisição
Você paga
US$ 7,50
US$ 0,75/mil req., só pelo que você usar. Sem plano mensal.
Suas primeiras 133 requisições são grátis com o saldo inicial de US$ 0,10.

Teste

Obtenha Buscar do eBay em uma só 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.
{
  "found": true,
  "data": {
    "items": [
      {
        "itemId": "225876341102",
        "title": "Nintendo Switch Lite Handheld Console - Turquoise - Used",
        "url": "https://www.ebay.com/itm/225876341102",
        "price": 129.5,
        "condition": "Used",
        "listingType": "Auction",
        "sellerName": "retro_games_hub",
        "sellerFeedbackPercent": 97.8,
        "shippingCost": "$8.99",
        "image": "https://i.ebayimg.com/images/g/3xkAAOSwLmhk3z4A/s-l500.jpg",
        "currency": "USD",
        "bidCount": 12,
        "sellerFeedbackCount": 3204
      },
      {
        "itemId": "205512873341",
        "title": "Nintendo Switch Console (Original 2017 Model) - Neon Red/Blue",
        "url": "https://www.ebay.com/itm/205512873341",
        "price": 179.99,
        "condition": "Used",
        "listingType": "FixedPrice",
        "sellerName": "consoleworld_usa",
        "sellerFeedbackPercent": 98.1,
        "shippingCost": "$0.00",
        "image": "https://i.ebayimg.com/images/g/7wYAAOSwXqhk3z4B/s-l500.jpg",
        "currency": "USD",
        "sellerFeedbackCount": 9871
      },
      {
        "itemId": "204521873366",
        "title": "Nintendo Switch OLED Model Console - White",
        "url": "https://www.ebay.com/itm/204521873366",
        "price": 249.99,
        "condition": "New",
        "listingType": "FixedPrice",
        "sellerName": "game_deals_plus",
        "sellerFeedbackPercent": 99.5,
        "shippingCost": "Free",
        "image": "https://i.ebayimg.com/images/g/5vNAAOSwZthk3z4C/s-l500.jpg",
        "currency": "USD",
        "sellerFeedbackCount": 41209
      }
    ]
  }
}

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-10-11 · disponibilidade e latência medidas em 30d

Corpo da requisição

JSON, enviado via POST para este endpoint.

  • querystring

    nintendo switch

    Palavras-chave de busca, ex.: "nintendo switch" ou "vintage levis 501".

  • conditionarray

    Filtra por uma ou mais condições do item; omita para todas as condições (ex.: ["new", "open_box"]).

  • limitinteger

    3

    Número máximo de resultados a retornar (1 a 25, padrão 25).

  • listingTypeenum

    Restringe a um formato de anúncio; omita ou use all para ambos (ex.: buy_it_now para apenas preço fixo).

  • maxPriceinteger

    Preço máximo opcional do item em USD.

  • minPriceinteger

    Preço mínimo opcional do item em USD.

  • 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.

  • 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).

Você envia. Um corpo JSON pequeno. Os valores mostrados são exemplos para você trocar pelos seus.

Resposta

JSON, um valor de exemplo por campo.

  • foundboolean

    true

each itemdata.items[]
  • itemIdstring

    225876341102

  • titlestring

    Nintendo Switch Lite Handheld Console - Turquoise - Used

  • urlstring

    https://www.ebay.com/itm/225876341102

  • pricenumber

    129.5

  • conditionstring

    Used

  • listingTypestringpode ser exigido

    Auction

  • sellerNamestringpode ser exigido

    retro_games_hub

  • sellerFeedbackPercentnumberpode ser exigido

    97.8

  • shippingCoststring

    $8.99

  • imagestring

    https://i.ebayimg.com/images/g/3xkAAOSwLmhk3z4A/s-l500.jpg

  • currencystring

    USD

  • bidCountnumber

    12

  • sellerFeedbackCountnumberpode ser exigido

    3204

Você recebe. Campos nomeados e tipados, no mesmo formato, seja qual for a fonte que responder.

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,75 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 3,8 segundos, em 19.316 chamadas medidas.

Custa a partir de US$ 0,75 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 3,8 segundos, em 19.316 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.

Sim. Uma conta nova da AnyAPI começa com US$ 0,10 de saldo grátis, sem cartão, o que cobre 133 chamadas de Buscar do eBay a US$ 0,00075 cada.

A AnyAPI consulta a próxima das suas 3 fontes na mesma requisição, começando pela mais barata, então a queda de uma fonte não derruba sua chamada.

Envie uma requisição POST para https://api.getanyapi.com/v1/run/ebay.search com sua chave da AnyAPI em um cabeçalho "Authorization: Bearer" e a entrada como corpo JSON. A mesma chave e a mesma carteira funcionam em todos os endpoints da AnyAPI.

Não. Você adiciona dólares a um único saldo pré-pago da AnyAPI e cada requisição desconta dele. Não há plano mensal nem mínimo, e o mesmo saldo paga todos os endpoints da AnyAPI.

Sim. Instale @getanyapi/sdk pelo npm para TypeScript ou getanyapi pelo pip para Python. Os dois chamam todos os endpoints da AnyAPI com a mesma chave, e qualquer cliente HTTP também funciona.

Sim. Um agente pode se conectar ao servidor MCP da AnyAPI em https://api.getanyapi.com/mcp, ou criar a própria chave de teste grátis com um único POST sem autenticação para https://api.getanyapi.com/agent/signup e chamar este endpoint por HTTP.
Mais para chamar

Outros endpoints de eBay

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