Can I see more detailed affiliation and publisher information in the REST API?
DataCite added support for affiliation identifiers in Metadata Schema 4.3 and publisher identifiers in Metadata Schema 4.5. By default, this information is not visible in the JSON REST API to avoid breaking changes that could cause problems with existing API integrations. Additional parameters can be added to REST API requests to include affiliation and publisher identifiers in the response. This applies to all types of requests (GET, POST, and PUT) and only affects the response body.
Affiliation identifiers
Add the URL parameter &affiliation=true
to your REST API requests to include affiliation identifiers in the response. This parameter changes the affiliation structure from a string to an array of objects. The objects will include the affiliation name, affiliationIdentifier, affiliationIdentifierScheme, and schemeUri when these are part of the DOI metadata.
"affiliation": [
{
"name": "United States Geological Survey",
"schemeUri": "https://ror.org",
"affiliationIdentifier": "https://ror.org/035a68863",
"affiliationIdentifierScheme": "ROR"
}
]
Example requests
Display affiliation information for results of a query:
curl "https://api.test.datacite.org/dois?query=climate%20change&affiliation=true"
Display affiliation information for a specific DOI:
curl "https://api.test.datacite.org/dois/10.24427/8gt9-nk59?affiliation=true"
Search for a specific affiliation by name:
curl "https://api.datacite.org/dois?query=creators.affiliation.name:%22University%20of%20Kentucky%22*&affiliation=true"
Publisher identifiers
Add the URL parameter &publisher=true
to your REST API requests to include publisher identifiers in the response. This parameter changes the publisher structure from a string to an object. The object will include the publisher name, publisherIdentifier, publisherIdentifierScheme, schemeUri, and lang when these are part of the DOI metadata.
"publisher":
{
"name": "Dryad",
"schemeUri": "https://ror.org",
"publisherIdentifier": "https://ror.org/00x6h5n95",
"publisherIdentifierScheme": "ROR",
"lang": "en"
}
Example requests
Display publisher information for results of a query:
curl "https://api.test.datacite.org/dois?query=climate%20change&publisher=true"
Display publisher information for a specific DOI:
curl 'https://api.test.datacite.org/dois/10.24427/8gt9-nk59?publisher=true"
Updated 3 months ago