Edelfelt REST API

API Contents

The metadata and pictures of this website is freely available through a REST API with most content licensed as CC0 1.0 universal (CC0 1.0). The API is experimental and we welcome ideas and feedback ( ). If you do something cool with our data, please let us know!

Pictures of artworks provided by the Finnish National Gallery are not available through our API. You can however access their metadata through FNG API links provided (also open data). Note that you need to request an API key from FNG to use it.

The Finnish National Gallery has their pictures available online on their site which is also linked to by us in the API. Please refer to FNG for licensing information concerning their API and website.

Accessing the API

Currently no access key or registration is required to access our API. The API is browsable at http://edelfelt.sls.fi/api/

Graph of the API layout.

The easiest way to learn how to use the API is to use the browsable interface which shows you the GET url.

You can list an object type at /api/objectname, e.g. /api/events/. To open a specific object just append its id, e.g. /api/events/13841/, which will return something like this:

{
    "url": "http://edelfelt.sls.fi/api/events/13841/",
    "id": 13841,
    "title": "Edelfelt och ellan har \"kostat på sig lyxen\" att köpa ett turkiskt draperi för att klä över en smutsig \"liggsoffa\", schäslong, som fanns kvar efter Munthe [vars lägenhet de hyrde]; Ellan och Edelfelt har tillsammans egenhändigt klätt över en spegelram med gult siden; de har hängt tavlor på väggarna och möblerat om i Munthes väntrum.",
    "letter": "http://edelfelt.sls.fi/api/letters/35492/",
    "order": null,
    "persons": [
        "http://edelfelt.sls.fi/api/persons/3036/",
        "http://edelfelt.sls.fi/api/persons/1178/"
    ],
    "year": 1888,
    "month": 2,
    "day": 8,
    "mentioned_locations": [
        "http://edelfelt.sls.fi/api/locations/6376/"
    ]
}
                   

Retrieve json without the human readable page by appending a format parameter like this: /api/events/11084/?format=json. Click Filters to see how to search and filter different pages.