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.
| 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 |
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
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â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ó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 |