Bioport API Documentation

BioDes

The information about persons and their biographies is downloadable in XML (BioDes format) as in JSON.

The database can be queried by sending appproate GET requests to http://www.biografischportaal.nl/personen/biodes See below for the various parameters.

The BioDes format is documented here.

JSON

The same data are also availabe in JSON format, at this location: http://www.biografischportaal.nl/personen/json.  

API

The results are returned in alphabetical order. The following query parameters can be used:

size

value: an integer. The number of results that are returned. Default value is 100. Setting it to -1 will return all results.

start

value: an integer. Will return results starting at this number. For example, http:/www.biografischportaal.nl/personen/json?start=10&size=10 will return results 10 to 19. 

source_id

values: an id of a collection of data that is included in the Biographical Portal. A list of values can be found at http://www.biografischportaal.nl/source_ids. More information about those collections can be found here.

birth_min, birth_max, death_min, death_max:

values: a date in YYYY-MM-DD format. For example, http://www.biografischportaal.nl/personen/biodes?birth_min=1800&birth_max=1800 will retrieve BioDes documents for persons born in the year 1800.

birth_place

A string. http://www.biografischportaal.nl/personen/json?birth_place=amsterdam returns all people born in Amsterdam.

death_place

A string. http://www.biografischportaal.nl/personen/json?birth_place=den%20haag returns all people died in Den Haag.

sex

Values: 1 is male, 2 is female.

search_name

values: a string. Searches for people with a name similar to the passed string. http://www.biografischportaal.nl/personen/json?search_name=gerbrandy returns a JSON file with information about all persons with a name similar to "gerbrandy".