Die eBay Search API liefert eBay-Suchanzeigen. Übergeben Sie ein Stichwort oder eine Such-URL auf einem unterstützten eBay-Marktplatz.
Piloterr nutzt den Webunlocker. 3 Credits pro erfolgreichem Aufruf.
Ein Stichwort sucht auf https://www.ebay.com. Eine volle URL behält den Host nur, wenn der Marktplatz unterstützt ist. Jeder andere Host, einschließlich ebay.be, liefert 400.
| Site |
Währung |
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.de/sch/i.html?_nkw=laptop
GET https://api.piloterr.com/v2/ebay/search?query=laptop&page=2
Beispiel (Stichwort):
laptop
Beispiel (Such-URL):
https://www.ebay.de/sch/i.html?_nkw=laptop
query ist Pflicht. Zwei Formen sind gültig.
| Form |
Beispiel |
Wirkung |
| Stichwort |
laptop |
Suche auf https://www.ebay.com/sch/i.html |
| Such-URL |
https://www.ebay.de/sch/i.html?_nkw=laptop |
Der Host bleibt, wenn er in der Liste oben steht. Der Pfad muss mit /sch beginnen |
Eine Artikel-URL (/itm/…) ergibt hier 400. Dafür eBay Product nutzen. Jeder andere Host ergibt 400, auch ebay.be, benl.ebay.be und befr.ebay.be. Ein leerer Wert ergibt 400.
page ist optional und setzt _pgn. Ohne page startet ein Stichwort auf Seite 1. Bei einer URL bleibt die Seite aus der URL. Ein Wert unter 1 ergibt 400.
| Parameter |
Typ |
Pflicht |
Beschreibung |
query |
string |
ja |
Stichwort auf ebay.com oder /sch-URL eines unterstützten Marktes |
page |
integer |
nein |
Seite (_pgn). Standard 1 bei einem Stichwort |
return_page_source |
boolean |
nein |
Rohes HTML als {"result": "..."} |
| Code |
Bedeutung |
400 |
Leere Anfrage oder eBay-Host nicht in der Liste |
403 |
Seite blockiert |
404 |
Keine auswertbaren Anzeigen |
500 |
Abruf fehlgeschlagen |