Einbinden

Zugang anfordern

Sie möchten den Buchhandlungsfinder auf Ihrer Website einbinden? Über 4.000 stationäre Buchhandlungen sind in dem Buchhandlungsfinder vertreten und zeigen so auf einen Blick die Vielfalt der deutschen Buchhandelslandschaft. Damit bieten Sie Ihren Kunden und Lesern einen zusätzlichen Service und unterstützen sie bei der Suche nach der nächstgelegenen Buchhandlung.

Neben einer einfachen Verlinkung zu buchhandlung-finden.de bieten wir Ihnen verschiedene Möglichkeiten die Buchhandlungsdaten auf Ihrer Homepage zu integrieren. Kurze Anleitungen und Erklärungen zu den unterschiedlichen Einbindungen finden Sie hier. Fordern Sie einfach Ihren API-Schlüssel, falls Sie den Buchhandlungsfinder via JSON-API einbinden möchten, an oder lassen Sie sich von uns persönlich beraten.


iFrame Einbindung einfach

Die Einbindung per iFrame ist die einfachste Methode den Buchhandlungsfinder in Ihrer Webseite zu integrieren.
Folgender HTML-Code zeigt zum Beispiel alle Buchhandlungen in Frankfurt am Main an.

<iframe src="https://www.buchhandlung-finden.de/suche?q=Frankfurt%20am%20Main" width="500" height="300"></iframe>

Query-Parameter

Name Pflichtangabe Standardwert Bemerkung
q Nein Deutschland

Der Paramater q kann ein Teilfragment einer Adresse, oder eine vollständige Adresse sein. Zum Beispiel eine Stadt, eine Postleitzahl oder/und eine Straße.

Beispiele:

  • q=Frankfurt%20am%20Main
  • q=60486
  • q=Solmsstraße%2075,%2060486%20Frankfurt%20am%20Main

JSON-API

Wenn Sie die volle Kontrolle über die optische Darstellung der Einbindung haben möchten, empfehlen wir Ihnen die Einbindung per JSON-API. Sie haben zudem die Möglichkeit spezifischer nach Buchhandlungen zu filtern, zum Beispiel nach Region oder nach Name.
Folgender JavaScript-Code ruft, mithilfe von jQuery, einen Teil der Buchhandlungen, welche mit Ihrem API Schlüssel abrufbar sind, ab.

"use strict";
$(document).ready(function () {
    var apiKey = 'YOUR_API_KEY';

    $.get({
        url: 'https://www.buchhandlung-finden.de/api/bookstores.json?apiKey=' + apiKey,
        success: function(response) {
            // In der Eigenschaft response.bookstores befindet sich eine Liste von Buchhandlungen.
            //
            // Eine Buchhandlung hält folgende Eigenschaften:
            // vewaAddressNumber, verkehrsnummer, name, phoneNumber, emailAddress, street, zipcode, city,
            // homepage, webshop, facebookPage, instagramPage, youTubePage
            console.log(response.bookstores);

            // In der Eigenschaft response.links, befinden sich Links, mit welchen Sie über das ganze Set iterieren können,
            // da immer nur eine Teilmenge an Buchhandlungen zurückgegeben wird.
            //
            // Die Eigenschaft zur jeweiligen Seite ist nur vorhanden, sofern die jeweilige Seite auch existiert.
            //
            // Falls Sie zur nächsten Seite blättern möchten, rufen Sie den Link in response.links.nextPage ab.
            // Falls Sie zur vorherigen Seite blättern möchten, rufen Sie den Link in response.links.previousPage ab.
            console.log(response.links);
        }
    });
});

Query-Parameter

Name Pflichtangabe Standardwert Bemerkung
apiKey Ja Kein Standardwert

Der API-Schlüssel, welchen Sie von uns erhalten haben.

Sie haben noch keinen API-Schlüssel?
Fordern Sie jetzt gerne einen, wie oben beschrieben, an.

address Nein Kein Standardwert

Der Parameter address kann ein Teilfragment einer Adresse, oder eine vollständige Adresse sein. Zum Beispiel eine Stadt, eine Postleitzahl oder/und eine Straße.

Wenn Sie diesen Parameter angeben, werden die Buchhandlungen im Umkreis von 20 Kilometern angezeigt. Die Buchhandlungen werden zudem automatisch sortiert. Der Adresse am nähesten gelegene Buchhandlungen, werden zuerst angezeigt.

Beispiele:

  • address=Frankfurt%20am%20Main
  • address=60486
  • address=Solmsstraße%2075,%2060486%20Frankfurt%20am%20Main
zipcode Nein Kein Standardwert

Der Parameter zipcode kann ein Anfang einer Postleitzahl, oder eine vollständige Postleitzahl sein.

Somit haben Sie die Möglichkeit alle Buchhandlungen in einem Postleitzahlengebiet, oder einer direkten Postleitzahl zu suchen.

Beispiele:

  • zipcode=60
  • zipcode=60486
name Nein Kein Standardwert

Der Parameter name kann ein Teilstück des Namens einer Buchhandlung sein.

Somit haben Sie die Möglichkeit alle Buchhandlungen, welche dieses bestimmte Teilstück des Namens beinhalten, zu finden.