User story
As an administrator for the University of Oxford I am interested in the reuse of research outputs from our university, so that I can help identify the most interesting research outputs.
Query strategy
We will query for research outputs where at least one author is affiliated with the University of Oxford, using the Research Organization Registry (ROR) identifier. We will ask for resource type (e.g. publication or dataset), the number of citations, views and downloads, and the authors and affiliations of the authors.
As ROR adoption is at an early stage and for example not yet implemented for Crossref DOIs as of April 2020, the returned research outputs will only be a small subset of the total number of research outputs from the University of Oxford. We further filter the results to only return research outputs with at least 100 views, according to the COUNTER Code of Practice.
Why GraphQL
The query combines the results from queries to two separate services (ROR and DataCite DOIs API). In addition, it combines DOI metadata with citation and usage data, the latter provided by the repository where the research output is hosted. GraphQL not only allows for a single query to fetch this information but also only returns the fields needed in the user story.
The output from the query is standard JSON and can be further processed by for example a Jupyter notebook.
Use the following query in the GraphQL client at https://api.datacite.org/graphql
{
organization(id: "https://ror.org/052gg0110") {
id
name
alternateName
citationCount
viewCount
downloadCount
works(hasViews: 100, first: 100) {
totalCount
years {
title
count
}
resourceTypes {
title
count
}
nodes {
id
type
publisher
publicationYear
titles {
title
}
creators {
id
name
affiliation {
id
name
}
}
citationCount
viewCount
downloadCount
}
}
}
}