L'API eBay Search renvoie les annonces d'une recherche eBay. Passez un mot-clé ou une URL de recherche sur un site eBay pris en charge.
Le fetch passe par le webunlocker (3 crédits par appel réussi).
Un mot-clé interroge https://www.ebay.com. Une URL complète garde son hôte seulement s'il est pris en charge. Tout autre hôte, y compris ebay.be, renvoie 400.
| Site |
Devise |
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
Exemple (mot-clé) :
laptop
Exemple (URL de recherche) :
https://www.ebay.fr/sch/i.html?_nkw=ordinateur
query est obligatoire. Deux formes passent.
| Forme |
Exemple |
Effet |
| Mot-clé |
laptop |
Recherche sur https://www.ebay.com/sch/i.html |
| URL de recherche |
https://www.ebay.fr/sch/i.html?_nkw=ordinateur |
L'hôte est conservé s'il est dans la liste ci-dessus. Le chemin doit commencer par /sch |
Une URL d'annonce (/itm/…) renvoie 400. Utilisez eBay Product. Tout autre hôte renvoie 400, y compris ebay.be, benl.ebay.be et befr.ebay.be. Une valeur vide renvoie 400.
page est optionnel. Il fixe _pgn. Sans page, un mot-clé part de la page 1. Sur une URL, la page déjà présente est conservée. Une valeur inférieure à 1 renvoie 400.
| Paramètre |
Type |
Requis |
Description |
query |
string |
oui |
Mot-clé sur ebay.com, ou URL /sch d'un site pris en charge |
page |
integer |
non |
Page (_pgn). Défaut 1 pour un mot-clé |
return_page_source |
boolean |
non |
HTML brut dans {"result": "..."} |
| Code |
Signification |
400 |
Requête vide, ou hôte eBay hors liste |
403 |
Page bloquée |
404 |
Aucune annonce exploitable |
500 |
Échec du fetch |