Ir para o conteúdo principal
Piloterr
Voltar à biblioteca

API eBay Search

API eBay Search: anúncios nos sites eBay suportados. Preço, vendedor e paginação (3 créditos).

Ativo3 créditos = 1 requisiçãoGET/v2/ebay/search

Visão Geral do Endpoint

Documentação detalhada, preços e exemplos de uso.

Visão geralLink to Visão geral

A API eBay Search devolve anúncios de uma pesquisa eBay. Passe uma palavra-chave ou um URL de pesquisa num site eBay suportado.

A Piloterr usa o webunlocker. 3 créditos por chamada bem-sucedida.

Uma palavra-chave pesquisa em https://www.ebay.com. Um URL completo mantém o host apenas se o site for suportado. Qualquer outro host, incluindo ebay.be, devolve 400.

Sites suportadosLink to Sites suportados

Site Moeda
www.ebay.com USD
www.ebay.co.uk GBP
www.ebay.fr EUR
www.ebay.de EUR
www.ebay.it EUR
www.ebay.es EUR
www.ebay.at EUR
www.ebay.ch CHF
www.ebay.nl EUR
www.ebay.pl PLN
www.ebay.ie EUR
www.ebay.ca CAD
www.ebay.com.au AUD

Início rápidoLink to Início rápido

GET https://api.piloterr.com/v2/ebay/search?query=laptop
GET https://api.piloterr.com/v2/ebay/search?query=https://www.ebay.fr/sch/i.html?_nkw=iphone
GET https://api.piloterr.com/v2/ebay/search?query=laptop&page=2

queryLink to query

Exemplo (palavra-chave):

laptop

Exemplo (URL de pesquisa):

https://www.ebay.fr/sch/i.html?_nkw=ordinateur

query é obrigatório. Há duas formas válidas.

Forma Exemplo Efeito
Palavra-chave laptop Pesquisa em https://www.ebay.com/sch/i.html
URL de pesquisa https://www.ebay.fr/sch/i.html?_nkw=ordinateur O host mantém-se se estiver na lista acima. O caminho tem de começar por /sch

Um URL de anúncio (/itm/…) devolve 400. Use eBay Product. Qualquer outro host devolve 400, incluindo ebay.be, benl.ebay.be e befr.ebay.be. Um valor vazio devolve 400.

page é opcional e define _pgn. Sem page, uma palavra-chave começa na página 1. Num URL, a página que já vem no URL mantém-se. Um valor inferior a 1 devolve 400.

ParâmetrosLink to Parâmetros

Parâmetro Tipo Obrigatório Descrição
query string sim Palavra-chave em ebay.com, ou URL /sch de um site suportado
page integer não Página (_pgn). Predefinição 1 para uma palavra-chave
return_page_source boolean não HTML em bruto em {"result": "..."}

Códigos de erroLink to Códigos de erro

Código Significado
400 Pedido vazio ou host eBay fora da lista
403 Página bloqueada
404 Nenhum anúncio interpretável
500 Falha na obtenção

APIs Relacionadas

Expanda suas capacidades de dados com essas ferramentas complementares.

Pronto para começar?

Sua API de web scraping está a um clique. Comece com +500 créditos, sem infraestrutura para configurar, sem proxies para gerenciar e sem cartão de crédito necessário.

  • +500 créditos
  • Sem cartão de crédito
  • Todos os endpoints incluídos