View on GitHub


Overview of how data is modelled in

< Back | Home | Edit page | 🙋 Check for open issues |

Reconciliation API

The Reconciliation Service can be used to add Artsdata IDs to your structured data.

Supported entity types include:

Give it a try using the Test bench!

This API follows the documentation provided by the W3C Entity Reconciliation Community Group.

The reconciliation service endpoint is

Manual reconciliation

To manually add Artsdata IDs to your structured data:

  1. Open the Test bench
  2. Select a radio button for the type of entity you want to reconcile. For example ‘Place’.
  3. Enter the name of the entity. For example ‘Salle André-Mathieu’.
  4. Click the ‘Reconcile’ button to search Artsdata.
  5. Select the URI for the matching entity ID. The search results are shown on the right side of the screen sorted by score. Be sure the copy the entire URI. For example:
  6. Add the URI to your structured data using ‘sameAs’.

Adding additional properties

In addition to the type of entity, you can add additional properties to improve the accuracy of the reconiliation.

For example to add a postal code when reconiling places, add the property id “schema:address/schema:postalCode” and the postal code. Screenshot 2024-01-31 at 4 02 49 PM Screenshot 2024-01-31 at 4 02 38 PM

Example of structred data with added ‘sameAs’

Example for an event’s location linked to an Artdata URI. The "sameAs": "" has been added.

  "@context": "",
  "@type": "Event",
  "name": {
    "@language": "fr",
    "@value": "Diane Dufresne | Sur rendez-vous"
  "startDate": "2025-07-21T19:00-05:00",
  "location": {
    "@type": "Place",
    "name": {
      "@language": "fr",
      "@value": "Salle André-Mathieu"
    "address": {
      "@type": "PostalAddress",
      "addressLocality": "Laval",
      "addressCountry": "CA",
      "streetAddress": "475 Bd de l'Avenir",
      "postalCode": "H7N 5H9",
      "addressRegion": "Québec"
    "sameAs": ""

Batch reconciliation

To batch reconcile, use tools like OpenRefine and point the reconilication tool to the Artsdata reconciliation endpoint. View this screen recording.

Reconciliation service endpoint:

Upcoming tools

Here is a sneek video preview of a prototype plug-in to Airtable