Kerameikos Documentation

This page contains documentation for using web services provided by Kerameikos and how to access machine readable serializations through REST and content negotiation.

APIs

API XML JSON Turtle
getRdf RDF/XML JSON-LD RDF/TTL

Get RDF

Aggregate RDF or JSON-LD for Kerameikos ids.
Webservice Type : REST
Url : kerameikos.org/getRdf?
Parameters : identifiers (Kerameikos ids divided by a pipe '|'), format ('xml', 'ttl', 'json', default 'xml')
Result : RDF/XML, RDF/TTL, JSON-LD.
Examples: api/getRdf?identifiers=attica|black_figure|exekias

OpenRefine Reconciliation Service

Service URI: http://kerameikos.org/apis/reconcile

Kerameikos supports the following reconciliation services for OpenRefine:

  • Main Reconciliation Service
  • Preview API
  • Entity Suggestion API (for autosuggest on matching terms)

All API responses are in JSON. Please see the API documentation and usage documentation for more details. The blog post, Nomisma launches OpenRefine reconciliation service, contains further information about this particular implementation in Kerameikos.


Data Access

Individual Records

Numishare supports delivery of individual records in a variety of models and serializations through both REST and content negotiation. Content negotiation (with the accept header) requests should be sent to the URI space http://kerameikos.org/id/. Requesting an unsupported content type will result in an HTTP 406: Not Acceptable error.

Model REST Content Type
HTML http://kerameikos.org/id/{$id} text/html
NUDS/XML http://kerameikos.org/id/{$id}.xml application/xml
KML http://kerameikos.org/id/{$id}.kml application/vnd.google-earth.kml+xml
RDF/XML http://kerameikos.org/id/{$id}.rdf application/rdf+xml
Turtle http://kerameikos.org/id/{$id}.ttl text/turtle
JSON-LD http://kerameikos.org/id/{$id}.jsonld application/ld+json

Search Results

Search results (the browse page) are returned in HTML5, but Numishare supports Atom and RSS via REST, as well as Atom and raw Solr XML via content negotiation of the browse page URL, http://kerameikos.org/results. The REST-based Atom feed sorts by the Lucene syntax 'timestamp desc' by default, but the sort parameter may be provided manually to alter the default field and order.

Model REST Content Type
HTML http://kerameikos.org/results text/html
Atom http://kerameikos.org/feed application/atom+xml
Solr/XML N/A application/xml

Kerameikos Concept RDF Dump

Data dumps conforming the Kerameikos Metadata Application Profile (primarily SKOS with classes from CIDOC-CRM and the Kerameikos ontology) are available as RDF/XML.

Pelagios RDF Dump: Kerameikos Geographic Concepts as Gazetteer Places

Data dumps conforming to the Pelagios 3 model are linked on the index page. At present, these files are only available in RDF/XML.