API basics

Query all fields
Query with pagination


Query "name" field
Query nested "fundertype.label.de" field

You can find a detailed description of the supported queries in the Lucene query string syntax documentation.

In particular note that when querying for URLs, special characters like colons, dashes, and slashes have to be escaped:

URL query: "classification.id:http\:\/\/purl.org\/lobid\/libtype%23n65"

Location based queries

Query with polygon ("location": coordinates of polygon points "lat,lon")
Query with distance ("location": coordinate of a point and a distance in km "lat,lon,distance")

Content types

By default, this service returns structured API responses (as JSON):

curl http://lobid.org/organisations/DE-6

It supports content negotiation based on the "Accept" header to serve JSON (application/json), CSV (text/csv), JSON lines (application/x-jsonlines), or HTML (text/html):

curl --header "Accept: text/csv" http://lobid.org/organisations/search?q=kunst

curl --header "Accept: application/x-jsonlines" http://lobid.org/organisations/search?q=kunst > kunst.jsonl

An optional "format" query parameter can be used to override the "Accept" header, e.g. to display JSON in a browser: /organisations/DE-6?format=json

For individual organisations, the format parameter values can be used as file extensions in URLs: /organisations/DE-6.json

For larger requests, the response can be compressed as gzip:

curl --header "Accept-Encoding: gzip" "http://lobid.org/organisations/search?q=museum&format=bulk" > museum.gz

Individual organisations additionally support different RDF serializations (see section on JSON-LD).

CSV export

Default fields ("format=csv")
Custom fields ("format": fields to use, with dots for nested fields "csv:field1,field2.subfield")


The API supports a response format for auto-complete suggestions using a specified field:

Suggest name: "format=json:name"
Suggest classification: "format=json:classification"

This can be used to set up an auto-complete search function that inserts an ID for the label that the user selected:

This sample is implemented with JavaScript and JQuery UI like this:

    source : function(request, response) {
            url : "http://lobid.org/organisations/search",
            dataType : "jsonp",
            data : {
                q : request.term,
                format : "json:name"
            success : function(data) {
    select: function(event, ui) {


JSON API calls serve JSON-LD (JSON for Linking Data). You can experiment with that by pasting responses or URLs in the JSON-LD Playground.

JSON-LD Context
RDF conversion
Use a JSON-LD processor to convert responses to RDF, e.g. to N-Quads, an N-Triples superset, with jsonld-cli:

jsonld format --nquads http://lobid.org/organisations/DE-6

Using the Accept header, individual organisations can be requested directly as RDF/XML, Turtle, or N-Triples:

curl --header "Accept: application/rdf+xml" http://lobid.org/organisations/DE-6

curl --header "Accept: text/turtle" http://lobid.org/organisations/DE-6

curl --header "Accept: application/n-triples" http://lobid.org/organisations/DE-6

As described in the section on content types, these are also supported in the format query parameter and as file extensions in URLs:




Sample document
The JSON-LD document below exemplifies the fields and content of an API response for a single organization.
  "linkedTo" : {
    "id" : "http://lobid.org/organisations/DE-605#!",
    "label" : "Hochschulbibliothekszentrum des Landes Nordrhein-Westfalen (hbz)"
  "rs" : "053150000000",
  "telephone" : "0049 221 4 78-7070",
  "alternateName" : [ "ZB MED - Informationszentrum Lebenswissenschaften, Köln", "Köln ZB MED" ],
  "mainEntityOfPage" : {
    "dateCreated" : "18-11-99",
    "dateModified" : "09-01-18",
    "id" : "http://lobid.org/organisations/DE-38M"
  "type" : "Library",
  "classification" : {
    "id" : "http://purl.org/lobid/libtype#n15",
    "type" : "Concept",
    "label" : {
      "de" : "Zentrale Fachbibliothek",
      "en" : "Central Subject Library"
  "@context" : "http://lobid.org/organisations/context.jsonld",
  "url" : "https://www.zbmed.de",
  "provides" : "https://www.livivo.de/?idb=ZBMED",
  "name" : "Deutsche Zentralbibliothek für Medizin - Informationszentrum Lebenswissenschaften, Köln",
  "containedIn" : "http://sws.geonames.org/6553049/",
  "location" : [ {
    "type" : "Place",
    "address" : {
      "postalCode" : "50931",
      "streetAddress" : "Gleueler Str. 60",
      "addressLocality" : "Köln",
      "addressCountry" : "DE",
      "type" : "PostalAddress"
    "openingHoursSpecification" : {
      "type" : "OpeningHoursSpecification",
      "comment" : "Ausleihe/Allg. Information: Mo-Fr 9.00-19.00, Sa 9.00-12.00; Fachauskunft: Mo-Fr 9.00-16.00; weitere Schließtage s.Homepage",
      "description" : "Mo-Fr 9.00-21.00, Sa 9.00-17.00, So und Feiertags 12.00-17.00 (Lesesaal)"
    "geo" : {
      "lat" : "50.92466",
      "lon" : "6.91666"
  } ],
  "id" : "http://lobid.org/organisations/DE-38M#!",
  "isil" : "DE-38M",
  "fundertype" : {
    "id" : "http://purl.org/lobid/fundertype#n06",
    "type" : "Concept",
    "label" : {
      "de" : "Sonstige öffentliche Trägerschaft",
      "en" : "Other Public Sector Funder"
  "collects" : {
    "type" : "Collection",
    "extent" : {
      "id" : "http://purl.org/lobid/stocksize#n09",
      "type" : "Concept",
      "label" : {
        "de" : "300.001 - 1.000.000",
        "en" : "300,001 - 1,000,000"
    "subject" : [ "Medizin" ]
  "email" : "mailto:info@zbmed.de",
  "dbsID" : "BJ038",
  "name_en" : "German National Library of Medicine - Information Centre for Life Sciences, Cologne",
  "sameAs" : [ "http://www.wikidata.org/entity/Q1204536", "http://ld.zdb-services.de/resource/organisations/DE-38M" ]


The lobid-organisations service implements the OpenRefine Reconciliation API. Follow these instructions to use it.

Reconciliation metadata request ("callback": optional JSONP callback to wrap the response into)
Reconciliation multi query request (expects form data via HTTP POST, use this URL in OpenRefine)