Skip to content

Search API

nilsw-ra edited this page Jun 28, 2023 · 3 revisions

Swedish version

The National Archives Search API is a REST API, giving external systems access to search functions like the web search service and provides public information as linked data (RDF). Presently (summer 2023) the Search API is a beta version.

Limitations in version 0.9:

  • The search only covers three object types
    • Archive records
    • Authorities (persons and organizations)
    • Topographies (places and administrative division)
  • The RDF representation is not complete
  • There are no RDF resources for concepts etc. (the URIs are not dereferencable)

API specification

OpenAPI definition

API methods

version

Method returning version number of the Search API.

http://data.riksarkivet.se/api/version

{
    "apiVersion": "0.9.0.1"
}

status

Method returning operational status for the API. This currently just a placeholder.

http://data.riksarkivet.se/api/status

{
    "operationalStatus": "ok"
}

records

Method for the actual search.

Linked data

The search result list contains basic data about the search hits. For complete information about specific records, there are links to an RDF representation of the records, serialized as RDF/XML and JSON-LD.

Beskrivning av RDF-representation