API: search
>> zurück zur Liste aller Schnittstellen
| Beschreibung | Suche in der booklooker-Datenbank |
|---|---|
| URL |
https://api.booklooker.de/2.0/search?token=REST_API_TOKEN
REST_API_TOKEN = Der von der Authentifizierung zurückgelieferte Token. |
| Methode | GET |
| Version | 2.0 |
Aufruf Limit
Die Schnittstelle kann bis zu 50 Mal pro 10 Minuten kostenlos aufgerufen werden. Wenn Sie mehr Aufrufe benötigen, können Sie ein kostenpflichtiges Kontingent buchen.
Optionale Parameter
| Parameter | Bedeutung | Default-Wert | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| medium |
Medientyp:
|
book | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 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 folgende Parameter ignoriert:
title, keyword, catID, subCatID, author, publisher, binding
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 Hinweise
|
|
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 |
|
Rückgabe
| Status | Rückgabewert | Beschreibung |
|---|---|---|
| OK | Es wird eine selbsterklärende Liste mit den gefundenen Artikeln zurückgeliefert. | |
| NOK | ENCODING_ERROR | Die Rückgabe enthält ungültige Zeichen. |
| NOK | INVALID_INTERFACE | Es wurde eine ungültige Schnittstelle verwendet. |
| NOK | INVALID_REQUEST_METHOD | Die Schnittstelle wurde mit einer ungültigen HTTP-Methode aufgerufen. |
| NOK | QUOTA_EXCEEDED | Die maximale Anzahl Abfragen/Minute wurde überschritten. |
| NOK | SERVER_DOWN | Aufgrund von Wartungsarbeiten ist die REST API momentan nicht verfügbar. |
| NOK | TEMPORARILY_BLOCKED | Der Zugang wurde vorübergehend gesperrt, bitte wenden Sie sich an unseren Kundensupport. |
| NOK | TOKEN_EXPIRED | Der Token ist nicht mehr gültig, eine erneute Authentifizierung ist notwendig. |
| NOK | TOKEN_MISSING | Der Token ist leer oder nicht vorhanden. |
| NOK | TOKEN_UNKNOWN | Der Token wurde nicht gefunden. |