N.B.: This API is still in development.
Ecartico API documentation
The Ecartico search API will let you find specific persons: 'Find people named Nicolaas Witsen, born between 1640 and 1645', or larger sets of people: 'Find artists born in Haarlem between 1580 and 1600 whose place of death is Amsterdam'.
The searchURI API will find persons identified by a URI: 'Find the person identified by https://rkd.nl/nl/explore/artists/85163'.
Example calls
API response
The API returns zero, one or more found persons, always starting with the number of hits.
{
hits: 1,
persons: [
{
uri: "http://www.vondel.humanities.uva.nl/ecartico/persons/8368",
full_name: "Nicolaes Cornelisz Witsen",
title: "",
firstname: "Nicolaes",
patronym: "Cornelisz",
prefix: "",
surname: "Witsen",
organization: "no",
gender: "male",
birth_date_modifier: "Exactly date 1",
birth_date_begin: "1641-05-08",
birth_date_end: "0000-00-00",
death_date_modifier: "Exactly date 1",
death_date_begin: "1717-08-10",
death_date_end: "0000-00-00",
birthplace: "Amsterdam",
deathplace: "Amsterdam"
}
]
}
API parameters with /search/
| Parameter | Format | Description |
|---|---|---|
| name | urlencoded string | searches in full_name field (combines firstname, patronym and surname fields; includes name variants). With fuzzy matching 'wytsen, nicolaas' will find 'Nicolaes Witsen' |
| firstname | string | searches in firstname field. With fuzzy matching 'nicolaas' will also find 'Nicolaes' |
| patronym | string | searches in patronym field. With fuzzy matching 'harmensz' will also find 'Harmens' and 'Hermans' |
| surname | string | searches in surname field. With fuzzy matching 'reijn' will also find 'Rijn' |
| birthdateFrom | yyyy-mm-dd | |
| birthdateBefore | yyyy-mm-dd | |
| deathdateFrom | yyyy-mm-dd | |
| deathdateBefore | yyyy-mm-dd | |
| birthplace | string | |
| deathplace | string | |
| gender | 'male','female' | |
| fuzzyMatching | boolean | if fuzzyMatching=0, fuzzy matching is of; defaults to 1 |
| start | integer | first result to retrieve, defaults to 0 |
| limit | integer | number of results to retrieve, defaults to 100 |
| TODO: updatedAfter | yyyy-mm-dd | only give records updated after this moment |
API parameters with /searchURI/
| Parameter | Format | Description |
|---|---|---|
| uri | Valid URI, e.g. 'https://rkd.nl/nl/explore/artists/85163' | URI identifying a person (Wikipedia-, DBpedia-, RKDartists- & Amsterdam museum URI's are the most frequently found within our data). Search for 'http://' will find both 'http://' and 'https://' and vv. Trailing slashes are optional. |
| domain | returns all uris from a certain domain, e.g. 'http://www.biografischportaal.nl' | |
| start | integer | first result to retrieve, defaults to 0 |
| limit | integer | number of results to retrieve, defaults to 100 |