The Cancer Imaging Archive )TCIA) is a publisher of cancer related data. Each Collection is issued a Digital Object Identifier (DOI) through DataCIte. DataCIte provides a REST API that can be used to search metadata according to their published schema. Please note that this API was not developed by TCIA and is not supported through the TCIA help desk. Please refer to the following documentation for usage.
Please refer to the Documentation below for how to use the DataCite REST API to query TCIA metadata
DataCite REST API - https://support.datacite.org/reference/introduction
DataCite REST API Guide - https://support.datacite.org/docs/api
DataCite Schema - http://schema.datacite.org
The Cancer Imaging Archive is identified within DataCite as
prefix-id 10.7937
client-id = sml.tcia
provider-id = tciar
TCIA utilizes the following Properties of the DataCite schema.
Table 1: DataCite Mandatory Properties ID | ||
Property | Obligation | |
1 | Identifier (with mandatory type sub-property) | M |
2 | Creator (with optional given name, family name, name identifier and affiliation sub-properties) | M |
3 | Title (with optional type sub-properties) | M |
4 | Publisher | M |
5 | PublicationYear | M |
10 | ResourceType (with mandatory general type description sub-property) | M |
Table 2: DataCite Recommended and Optional Properties ID | ||
Property | Obligation | |
17 | Description (with type sub-property) | R |
Below is an example of how to retrieve a single DataCite record in JSON format. For this example we are using a Published Collection called "Pseudo-PHI-DICOM-Data"
# GET /dois
Return a list of DOIs using the TCIA provider id (tciar)
https://api.datacite.org/dois?provider-id=tciar
By default, only 25 records are returned. You can control the number of records returned using pagination options. For example, to return only 5 records
https://api.datacite.org/dois?provider-id=tciar&page[size]=5
or
Query on specific information populated in the DataCite schema, for instance return the records published by The Cancer Imaging Archive that were published in 2016
or