Open data and APIs

Take this collection as data. Every surface below is open, needs no API key, and covers published records only - for researchers, developers, aggregators, and linked-data clients.

Licensed CC-BY-4.0 · No key required · Read-only, published records only

Linked-data graph

Fetch the catalogue as a machine-readable graph. The front door describes the whole dataset; each record is dereferenceable on its own. Content is negotiated by the Accept header (or a path suffix).

JSON-LD (default), Turtle, or RDF/XML

Open, no key. Published records only. CC-BY-4.0.

Dataset dumps

Download the whole published catalogue in one request to take it offline as data - a streamed CSV for spreadsheets and analysis, or a bounded JSON-LD @graph for linked-data tooling.

CSV (streamed) and JSON-LD

Open, no key. Published records only. CC-BY-4.0.

OAI-PMH harvesting

A standards-compliant Open Archives Initiative endpoint so aggregators and union catalogues can harvest the descriptions incrementally. Supports the usual OAI verbs (Identify, ListRecords, GetRecord, and so on).

OAI-PMH / XML (Dublin Core)

Open, no key. Published records only. CC-BY-4.0.

Discovery document

The single URL a standards-aware crawler dereferences when it knows nothing about this host. A VoID / DCAT dataset description that links on to the graph front door, the JSON-LD context, the crawl seed, and the sitemap.

VoID / DCAT in Turtle, plus an XML sitemap

Open, no key. Published records only. CC-BY-4.0.

API reference

Interactive documentation for the full read API, plus a machine-readable OpenAPI specification you can import into your own client generator or testing tool.

Swagger UI (HTML) and OpenAPI 3 (JSON)

Open, no key. Published records only. CC-BY-4.0.

Content Credentials API

Verify the provenance and authenticity of any image or document against its embedded Content Credentials (C2PA). A public check page accepts any upload; digital objects in the catalogue also expose an embeddable verification badge as JSON.

HTML check page and JSON badge

Open, no key. Published records only. CC-BY-4.0.

Knowledge graph (RiC)

Query the Records in Contexts (RiC) knowledge graph directly. A read-only SPARQL endpoint (SELECT / ASK / CONSTRUCT / DESCRIBE) lets federated linked-data clients ask their own questions across the catalogue's entities and relationships.

SPARQL 1.1 over RiC-O / RDF

Open, no key. Published records only. CC-BY-4.0.

ResourceSync

A ResourceSync source so downstream systems can mirror the collection and keep their copy in step - a capability list pointing at the resource list and a change list for incremental syncs.

ResourceSync / XML (Sitemap-based)

Open, no key. Published records only. CC-BY-4.0.

Try it

Ask the linked-data graph for Turtle instead of the default JSON-LD by setting the Accept header:

curl -H "Accept: text/turtle" https://heratio.artorius.co.za/api/v1/graph

Swap the header for application/ld+json (JSON-LD) or application/rdf+xml (RDF/XML), or append a .ttl / .jsonld / .rdf suffix to a per-record URL.

How to cite and license

This data is published under the Creative Commons Attribution 4.0 International licence (CC-BY-4.0). You are free to copy, redistribute, transform, and build on it for any purpose, including commercially, provided you give appropriate credit.

Please cite the holding institution and link back to the record or dataset URL you used. Example: "<Institution name>, <Collection or record title>, retrieved from <dataset or record URL>, licensed CC-BY-4.0."

Explore this collection