La API eBay Search devuelve anuncios de una búsqueda en eBay. Pase una palabra clave o una URL de búsqueda en un sitio eBay admitido.
Piloterr usa el webunlocker. 3 créditos por llamada correcta.
Una palabra clave busca en https://www.ebay.com. Una URL completa conserva el host solo si el sitio está admitido. Cualquier otro host, incluido ebay.be, devuelve 400.
| Sitio |
Moneda |
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.es/sch/i.html?_nkw=iphone
GET https://api.piloterr.com/v2/ebay/search?query=laptop&page=2
Ejemplo (palabra clave):
laptop
Ejemplo (URL de búsqueda):
https://www.ebay.es/sch/i.html?_nkw=portatil
query es obligatorio. Valen dos formas.
| Forma |
Ejemplo |
Efecto |
| Palabra clave |
laptop |
Búsqueda en https://www.ebay.com/sch/i.html |
| URL de búsqueda |
https://www.ebay.es/sch/i.html?_nkw=portatil |
El host se conserva si está en la lista de arriba. La ruta debe empezar por /sch |
Una URL de anuncio (/itm/…) devuelve 400. Use eBay Product. Cualquier otro host devuelve 400, incluido ebay.be, benl.ebay.be y befr.ebay.be. Un valor vacío devuelve 400.
page es opcional y fija _pgn. Sin page, una palabra clave empieza en la página 1. En una URL se conserva la página que ya trae. Un valor menor que 1 devuelve 400.
| Parámetro |
Tipo |
Obligatorio |
Descripción |
query |
string |
sí |
Palabra clave en ebay.com, o URL /sch de un sitio admitido |
page |
integer |
no |
Página (_pgn). Por defecto 1 si es una palabra clave |
return_page_source |
boolean |
no |
HTML en bruto como {"result": "..."} |
| Código |
Significado |
400 |
Consulta vacía o host eBay fuera de la lista |
403 |
Página bloqueada |
404 |
Ningún anuncio interpretable |
500 |
Fallo de obtención |