APIs
This page contains documentation for using web services provided by Kerameikos and how to access machine readable serializations through REST and content negotiation.
APIs
OpenRefine Reconciliation Service
Data Access
APIs
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.
Example: api/getRdf?identifiers=attica|black_figure|exekias
OpenRefine Reconciliation Service
Service URI: https://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 https://kerameikos.org/id/. Requesting an unsupported content type will result in an HTTP 406: Not Acceptable error.
| Model | REST | Content Type |
|---|---|---|
| HTML | https://kerameikos.org/id/{$id} | text/html |
| NUDS/XML | https://kerameikos.org/id/{$id}.xml | application/xml |
| KML | https://kerameikos.org/id/{$id}.kml | application/vnd.google-earth.kml+xml |
| RDF/XML | https://kerameikos.org/id/{$id}.rdf | application/rdf+xml |
| Turtle | https://kerameikos.org/id/{$id}.ttl | text/turtle |
| JSON-LD | https://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, https://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 | https://kerameikos.org/results | text/html |
| Atom | https://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.