API: Artikelsuche / Partnerprogramm

Beschreibung

Artikelsuche

URL

https://api.booklooker.de/interface/search.php

Version

1.2

Argumente

Argument	Bedeutung
pid	Partner-ID, muss separat bei booklooker beantragt werden

Optionale Argumente

Argument	Bedeutung	Default-Wert
version	Version der Schnittstelle	1.2
medium	Medientyp: book (Buch) abook (Hörbuch) film (Film) music (Musik) game (Spiel)	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	max. Anzahl der zurückgelieferten Ergebnisse (max. 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: Deutschland at: Österreich ch: Schweiz	de
sortOrder	Sortierung der Suchergebnisse nach: price: Artikelpreis pricePlusShipping: Artikelpreis+Porto
sortDir	Richtung der Sortierung: asc: aufsteigend desc: absteigend	asc
extraFields	Liste zusätzlicher für das Such-Ergebnis gewünschter Felder, getrennt durch \| Mögliche Felder sind aktuell: Condition: Zustand des Artikels SellerType: 0=privat 1=gewerblich Format: Format des Buches (Freitextfeld) Weight: Gewicht des Artikels in Gramm PublisherPlace: Verlagsort EditionNo: Auflage (Freitextfeld) Achtung: Bei preisgebundener Neuware, werden die folgenden Elemente nicht zurückgeliefert, da der Deep-Link in diesem Fall auf eine Seite mit mehreren Anbietern führt, die unterschiedliche Konditionen haben können. Payment: Angebotene Zahlungsarten; zurückgegeben wird ein Element <PaymentList>, welches für jede angebotene Zahlungsart ein Element <Payment> enthält. OffererIsSmallBusiness: Anbieter nutzt Kleinunternehmerregelung bzgl. MwSt. (0=nein, 1=ja) MinimumOrderValue: Mindestbestellwert bei diesem Anbieter Absence: Es werden folgende zwei Felder zurückgegeben, falls eine aktuelle oder zukünftige Abwesenheit des Anbieters hinterlegt ist: <AbsentFrom> und <AbsentTo> GuaranteedDelivery: 1 = Artikel garantiert lieferbar InternationalDelivery: 1 = Internationale Lieferung möglich SellerCountry: Land des Anbieters (ISO 639-1) SubCatId: ID der booklooker-Untersparte, falls vergeben. Eine Liste der IDs finden Sie in unserer Excel-Vorlage (s. Menüpunkt Offline-Eingabe) MinOrderValue: Mindestbestellwert des Verkäufers Beispiel: extraFields=Condition\|SellerType Sollen grundsätzlich alle verfügbaren Felder zurückgegeben werden, so kann der Wert all übergeben werden; dies bezieht sich auch auf mögliche in der Zukunft zusätzlich aufgenommene Felder: Beispiel: extraFields=all
discardUnavailable	Ausblendung von Artikeln, die aktuell nicht verfügbar sind, weil der Verkäufer gesperrt ist, oder die Abwesenheitsfunktion nutzt 1: aktiviert, es werden keine Artikel von Anbietern ausgeblendet, die die Abwesenheitsfunktion nutzen und Bestellungen während der Abwesenheit erlauben. strict: aktiviert, es werden auch Artikel von Anbietern ausgeblendet, die die Abwesenheitsfunktion nutzen und Bestellungen während der Abwesenheit erlauben.

Argument

Bedeutung

Default-Wert

version

Version der Schnittstelle

1.2

medium

Medientyp:

book (Buch)
abook (Hörbuch)
film (Film)
music (Musik)
game (Spiel)

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

max. Anzahl der zurückgelieferten Ergebnisse (max. 150)

150

profOnly

1: nur Angebote gewerblicher Anbieter

privOnly

1: nur Angebote privater Anbieter

usedOnly

1: nur gebrauchte Artikel

newOnly

1: nur Neuware

showShippingPrice

Zielland für die Angabe der Versandkosten, es werden nur die folgenden Länder unterstützt:

de: Deutschland
at: Österreich
ch: Schweiz

sortOrder

Sortierung der Suchergebnisse nach:

price: Artikelpreis
pricePlusShipping: Artikelpreis+Porto

sortDir

Richtung der Sortierung:

asc: aufsteigend
desc: absteigend

asc

extraFields

Liste zusätzlicher für das Such-Ergebnis gewünschter Felder, getrennt durch |
Mögliche Felder sind aktuell:

Condition: Zustand des Artikels
SellerType: 0=privat 1=gewerblich
Format: Format des Buches (Freitextfeld)
Weight: Gewicht des Artikels in Gramm
PublisherPlace: Verlagsort
EditionNo: Auflage (Freitextfeld)

Achtung: Bei preisgebundener Neuware, werden die folgenden Elemente nicht zurückgeliefert, da der Deep-Link in diesem Fall auf eine Seite mit mehreren Anbietern führt, die unterschiedliche Konditionen haben können.

Payment: Angebotene Zahlungsarten; zurückgegeben wird ein Element <PaymentList>, welches für jede angebotene Zahlungsart ein Element <Payment> enthält.
OffererIsSmallBusiness: Anbieter nutzt Kleinunternehmerregelung bzgl. MwSt. (0=nein, 1=ja)
MinimumOrderValue: Mindestbestellwert bei diesem Anbieter
Absence: Es werden folgende zwei Felder zurückgegeben, falls eine aktuelle oder zukünftige Abwesenheit des Anbieters hinterlegt ist: <AbsentFrom> und <AbsentTo>
GuaranteedDelivery: 1 = Artikel garantiert lieferbar
InternationalDelivery: 1 = Internationale Lieferung möglich
SellerCountry: Land des Anbieters (ISO 639-1)
SubCatId: ID der booklooker-Untersparte, falls vergeben. Eine Liste der IDs finden Sie in unserer Excel-Vorlage (s. Menüpunkt Offline-Eingabe)
MinOrderValue: Mindestbestellwert des Verkäufers

Beispiel: extraFields=Condition|SellerType

Sollen grundsätzlich alle verfügbaren Felder zurückgegeben werden, so kann der Wert all übergeben werden; dies bezieht sich auch auf mögliche in der Zukunft zusätzlich aufgenommene Felder:

Beispiel: extraFields=all

discardUnavailable

Ausblendung von Artikeln, die aktuell nicht verfügbar sind, weil der Verkäufer gesperrt ist, oder die Abwesenheitsfunktion nutzt

1: aktiviert, es werden keine Artikel von Anbietern ausgeblendet, die die Abwesenheitsfunktion nutzen und Bestellungen während der Abwesenheit erlauben.
strict: aktiviert, es werden auch Artikel von Anbietern ausgeblendet, die die Abwesenheitsfunktion nutzen und Bestellungen während der Abwesenheit erlauben.

Allgemeines zu den Such-Argumenten

Alle Such-Argumente 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 das Such-Argument isbn oder ean angeben, werden alle anderen Argumente ignoriert!

Such-Argumente für alle Medientypen

Argument	Suche nach
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

Argument

Suche nach

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-Argumente für Medientyp book

Argument	Suche nach	mögliche Werte
author	Autor
publisher	Verlag
isbn	ISBN
binding	Einband	Softcover Hardcover Heft Flexi Leinen Leder Pergament Seide Brief CD-ROM Ringbindung Postkarte
yearFrom	Erscheinungsjahr ab
yearTo	Erscheinungsjahr bis
signed	Signierte Bücher	1
firstEdition	Erstausgaben	1

Argument

Suche nach

mögliche Werte

author

Autor

publisher

Verlag

isbn

ISBN

binding

Einband

Softcover
Hardcover
Heft
Flexi
Leinen
Leder
Pergament
Seide
Brief
CD-ROM
Ringbindung
Postkarte

yearFrom

Erscheinungsjahr ab

yearTo

Erscheinungsjahr bis

signed

Signierte Bücher

firstEdition

Erstausgaben

Such-Argumente für Medientyp abook

Argument	Suche nach
author	Autor
publisher	Verlag
isbn	ISBN

Argument

Suche nach

author

Autor

publisher

Verlag

isbn

ISBN

Such-Argumente für Medientyp film

Argument	Suche nach	mögliche Werte
cast	Regisseur, Darsteller
filmFormat	Format	DVD Blu-ray VHS Super-8 Video 2000 Laserdisc Zelluloid
ean	EAN

Argument

Suche nach

mögliche Werte

cast

Regisseur, Darsteller

filmFormat

Format

DVD
Blu-ray
VHS
Super-8
Video 2000
Laserdisc
Zelluloid

ean

EAN

Such-Argumente für Medientyp music

Argument	Suche nach	mögliche Werte
artist	Künstler
label	Label
distributor	Vertrieb
musicFormat	Format	CD Vinyl MC
ean	EAN

Argument

Suche nach

mögliche Werte

artist

Künstler

label

Label

distributor

Vertrieb

musicFormat

Format

CD
Vinyl
MC

ean

EAN

Such-Argumente für Medientyp game

Argument	Suche nach	mögliche Werte
author	Autor
subCatID	Spieltyp	102: Brettspiele 103: Kartenspiele 104: Sonstige Gesellschaftsspiele 105: PC-Spiele 106: Mac-Spiele 107: Playstation I 118: Playstation II 119: Playstation III 121: Playstation Portable 110: Nintendo DS 125: Nintendo 3DS 112: Nintendo Gamecube 120: Nintendo Gameboy Advance 111: Nintendo Gameboy 109: Wii 108: Xbox 122: Xbox 360 123: Sonstige Konsolen
ean	EAN

Argument

Suche nach

mögliche Werte

author

Autor

subCatID

Spieltyp

102: Brettspiele
103: Kartenspiele
104: Sonstige Gesellschaftsspiele
105: PC-Spiele
106: Mac-Spiele
107: Playstation I
118: Playstation II
119: Playstation III
121: Playstation Portable
110: Nintendo DS
125: Nintendo 3DS
112: Nintendo Gamecube
120: Nintendo Gameboy Advance
111: Nintendo Gameboy
109: Wii
108: Xbox
122: Xbox 360
123: Sonstige Konsolen

ean

EAN

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ückgabewert

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.