API: Artikelsuche / Partnerprogramm
| Beschreibung | Artikelsuche |
|---|---|
| URL | https://api.booklooker.de/interface/search.php |
| Methode | GET |
| Version | 1.2 |
Parameter
| Parameter | Bedeutung |
|---|---|
| pid | Partner-ID, muss separat bei booklooker beantragt werden |
Optionale Parameter
| Parameter | Bedeutung | Default-Wert | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| medium |
Medientyp:
|
book | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| encoding |
Wenn die Werte UTF-8-kodiert übergeben werden, muss als encoding der Wert utf8übergeben werden, andernfalls wird eine Kodierung in ISO-8859-1 erwartet. |
iso-8859-1 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| limit | maximale Anzahl der zurückgelieferten Ergebnisse (maximal 150) | 150 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| profOnly | 1: nur Angebote gewerblicher Anbieter | 0 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| privOnly | 1: nur Angebote privater Anbieter | 0 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| usedOnly | 1: nur gebrauchte Artikel | 0 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| newOnly | 1: nur Neuware | 0 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| showShippingPrice |
Zielland für die Angabe der Versandkosten, es werden nur die folgenden Länder unterstützt:
|
de | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| sortOrder |
Sortierung der Suchergebnisse nach:
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||
| sortDir |
Richtung der Sortierung:
|
asc | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| extraFields |
Liste zusätzlicher für das Such-Ergebnis gewünschter Felder, getrennt durch Beispiel: extraFields=Condition|SellerType|Weight
Achtung: Bei preisgebundener Neuware, werden die Elemente mit dem Wert
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||
| discardUnavailable |
Ausblendung von Artikeln, die aktuell nicht verfügbar sind, weil der Verkäufer gesperrt ist, oder die
Abwesenheitsfunktion nutzt
|
Allgemeines zu den Such-Parametern
Alle Such-Parameter werden stets per UND-Verknüpfung miteinander verbunden. Soll nach einem Suchbegriff in allen Feldern gesucht werden, so muss die Schnittstelle mehrmals hintereinander aufgerufen werden.
Es wird immer nach allen Worten in beliebiger Reihenfolge im Suchfeld gesucht. Um nach Wortteilen zu suchen, müssen
die Wörter mit * beendet werden (dies ist bei isbn
und ean
nicht möglich).
Beachten Sie: Wenn Sie als Such-Parameter isbn
oder ean
angeben, werden alle anderen
Parameter ignoriert!
Such-Parameter für alle Medientypen |
||
| Parameter | Suche nach | mögliche Werte |
|---|---|---|
| title | Titel | |
| keyword | Stichwort | |
| uID | booklooker-ID des Anbieters | |
| lfdnr | Bestell-Nummer des Anbieters | |
| catID | booklooker-ID der Obersparte | |
| subCatID | booklooker-ID der Untersparte | |
| dateFrom | nur Angebote ab dem angegebenen Datum im Format YYYY-MM-DD | |
Such-Parameter für Medientyp |
||
| Parameter | Suche nach | mögliche Werte |
| author | Autor | |
| publisher | Verlag | |
| isbn | ISBN | |
| yearFrom | Erscheinungsjahr ab | |
| yearTo | Erscheinungsjahr bis | |
| signed | Signierte Bücher | 1 |
| firstEdition | Erstausgaben | 1 |
| binding | Einband |
|
Such-Parameter für Medientyp |
||
| Parameter | Suche nach | mögliche Werte |
| author | Autor | |
| publisher | Verlag | |
| isbn | ISBN | |
Such-Parameter für Medientyp |
||
| Parameter | Suche nach | mögliche Werte |
| cast | Regisseur, Darsteller | |
| ean | EAN | |
| filmFormat | Format |
|
Such-Parameter für Medientyp |
||
| Parameter | Suche nach | mögliche Werte |
| artist | Künstler | |
| label | Label | |
| distributor | Vertrieb | |
| ean | EAN | |
| musicFormat | Format |
|
Such-Parameter für Medientyp |
||
| Parameter | Suche nach | mögliche Werte |
| author | Autor | |
| ean | EAN | |
| subCatID | Spieltyp |
|
Beispiele
https://api.booklooker.de/interface/search.php?pid=12345678&medium=book&author=Houellebecq&title=Element*
https://api.booklooker.de/interface/search.php?pid=12345678&medium=film&cast=Hitchcock,Grant&title=unsichtbar*&showShippingPrice=ch&limit=100
Rückgabe
Es wird ein selbsterklärendes XML-Dokument mit den gefundenen Artikeln zurückgeliefert.
Der Deep-Link zum Angebot bei booklooker.de befindet sich im Element <DetailLinkUrl>.
Webgains Partnerprogramm
Wenn Ihr Partner-Programm über Webgains abgerechnet wird, bauen Sie den Deep-Link zum Angebot bei uns wie folgt auf:
https://track.webgains.com/click.html?wgcampaignid=<IhreWebgainsID>&wgprogramid=275385&wgtarget=<DetailLinkUrl>
Tragen Sie als Parameter wgcampaignid Ihre Webgains-ID ein. Die ID unseres Partnerprogramms ist über den Parameter wgprogramid festgelegt. Das booklooker-Partnerprogramm hat die ID 275385.