Reconciliation API
The Artsdata.ca Reconciliation Service can be used to add Artsdata IDs to your structured data.
Supported entity types include:
- Event
- Place
- Person
- Organization
- Agent (Person or Organization/Group)
- Concept (Event type, Genre, etc.)
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 https://api.artsdata.ca/recon.
Manual reconciliation using the Test Bench
To manually add Artsdata IDs to your structured data:
- Open the Test bench
- Select a radio button for the type of entity you want to reconcile. For example ‘Place’.
- Enter the name of the entity. For example ‘Salle André-Mathieu’. Or enter the official website url.
- Click the ‘Reconcile’ button to search Artsdata.
- 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: http://kg.artsdata.ca/resource/K11-211
- 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. The additional properties are required to be in the returned entities. Any entity that does not match the additional property will be exluded from the reconciliation results.
For example to add a postal code when reconiling places, add the property id “schema:address/schema:postalCode” and the postal code.
Example of structured data with added ‘sameAs’
Example for an event’s location linked to an Artdata URI. The "sameAs": "http://kg.artsdata.ca/resource/K11-211" has been added.
{
"@context": "https://schema.org",
"@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": "http://kg.artsdata.ca/resource/K11-211"
}
Artsdata batch reconciliation tool
Logged in users may use to Artsdata Batch Reconciliation Tool to quickly reconcile entire datasets.
The tool can be accessed via the kg.artsdata.ca interface menu. Documentation will be published soon.
Batch reconciliation using Open Refine
To batch reconcile, you may also use tools like OpenRefine and point the reconilication tool to the Artsdata reconciliation endpoint. View this screen recording.
Reconciliation service endpoint: https://api.artsdata.ca/recon
Manual reconciliation within the Artsdata interface
The reconciliation service is also used by several features in the Artsdata interface. For example, a logged-in user may reconcile entities from a previously uploaded data source using the following methods:
- Manually mint/link a top-level or nested entity with the “Minter” feature, if the entity is assigned a persistent URI by the source (i.e. a local URI) or as part of the Extract-Transform-Load process;
- Manually add a sameAs to a nested entity as part of the “Mint from blank node” suite of features, if the entity is a nested blanked node in the uploaded graph.
These features are useful when entities come back recurrently within a data source.