API-Suche

Das Schweizerische Bundesarchiv (BAR) stellt eine Programmierschnittstelle (API) für die Metadaten auf recherche.bar.admin.ch zur Verfügung. Mit der API können Sie Ihre eigenen Anwendungen aufbauend auf der BAR-Suchmaschine erstellen.

Zur API-Dokumentation (auf Englisch)  

Alle öffentlich zugänglichen Metadaten in der Online-Suche des Bundesarchivs sind über die API verfügbar. Direkter Zugriff auf Primärdaten ist nicht möglich, da dieser nur angemeldeten Nutzerinnen und Nutzer erlaubt ist.. Es ist kein Login oder API-Schlüssel erforderlich. Die API wurde für die gezielte Stichwortsuche entwickelt. Sie ist nicht auf Massendownloads ausgelegt. Alle öffentlich verfügbaren Metadaten des BAR können bequem über die Plattform OpenData.swiss in einer einzigen ZIP-Datei heruntergeladen werden (504.0MB).

Technische Angaben

Host: "https://www.recherche.bar.admin.ch/recherche/api/v1/"
API type: RESTful.
Austauschformat: JSON
Zeichenkodierung: UTF-8.

  • Einen Datensatz über seine ID abrufen: GET "https://www.recherche.bar.admin.ch/recherche/api/v1/entities/{id}"
  • Mehrere Datensätze abrufen: GET www.recherche.bar.admin.ch/recherche/api/v1/entities
  • Einen Datensatz suchen POST-Abfrage mit Header {‘content-type’ : ‘application/json; charset=utf-8'} to "https://www.recherche.bar.admin.ch/recherche/api/v1/entities/Search"