Search DataCite datasets and software, fetch DOI metadata, trace relations, format citations.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Render one DataCite DOI as a formatted citation in a CSL style and locale (APA in US English by default), or as a machine-readable record: CSL JSON, BibTeX, RIS, DataCite JSON or XML, Schema.org JSON-LD, Codemeta, or JATS. A style the upstream renderer does not support — an unknown id or a dependent journal style — is rejected instead of silently rendered as APA. Formatted text comes back as plain text alongside the upstream HTML markup. A DOI DataCite does not hold returns found: false naming the registration agency that does.
The DataCite DOI, e.g. 10.5061/dryad.234. Accepted bare, with doi: or info:doi/ prefixes, as a doi.org / dx.doi.org URL, or %2F-encoded; case-insensitive.
CSL style id for format text, e.g. apa (default), ieee, chicago-author-date, modern-language-association, vancouver, nature. Lowercased. A style that would silently fall back to APA is rejected. Verified ids: datacite_list_reference topic citation_styles.
text (formatted citation, default), csl_json, bibtex, ris, datacite_json, datacite_xml, schema_org, codemeta, or jats.
CSL locale for format text, e.g. en-GB, de-DE, fr-FR, or a bare language (de → de-DE); any case. Omitted: en-US. List: datacite_list_reference topic citation_locales.
Render one DataCite DOI as a formatted citation in a CSL style and locale (APA in US English by default), or as a machine-readable record: CSL JSON, BibTeX, RIS, DataCite JSON or XML, Schema.org JSON-LD, Codemeta, or JATS. A style the upstream renderer does not support — an unknown id or a dependent journal style — is rejected instead of silently rendered as APA. Formatted text comes back as plain text alongside the upstream HTML markup. A DOI DataCite does not hold returns found: false naming the registration agency that does.
| Argument | Type | Description |
|---|---|---|
| doi* | string | The DataCite DOI, e.g. 10.5061/dryad.234. Accepted bare, with doi: or info:doi/ prefixes, as a doi.org / dx.doi.org URL, or %2F-encoded; case-insensitive. |
| style | string | CSL style id for format text, e.g. apa (default), ieee, chicago-author-date, modern-language-association, vancouver, nature. Lowercased. A style that would silently fall back to APA is rejected. Verified ids: datacite_list_reference topic citation_styles. |
| format | string | text (formatted citation, default), csl_json, bibtex, ris, datacite_json, datacite_xml, schema_org, codemeta, or jats. |
| locale | string | CSL locale for format text, e.g. en-GB, de-DE, fr-FR, or a bare language (de → de-DE); any case. Omitted: en-US. List: datacite_list_reference topic citation_locales. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"doi"
],
"properties": {
"doi": {
"type": "string",
"pattern": "^\\s*(?:[Hh][Tt][Tt][Pp][Ss]?:\\/\\/(?:[Dd][Xx]\\.)?[Dd][Oo][Ii]\\.[Oo][Rr][Gg]\\/)?(?:[Dd][Oo][Ii]:\\s*|[Ii][Nn][Ff][Oo]:[Dd][Oo][Ii]\\/)?10\\.\\S+\\s*$",
"maxLength": 500,
"description": "The DataCite DOI, e.g. 10.5061/dryad.234. Accepted bare, with doi: or info:doi/ prefixes, as a doi.org / dx.doi.org URL, or %2F-encoded; case-insensitive."
},
"style": {
"type": "string",
"pattern": "^\\s*[A-Za-z0-9-]+\\s*$",
"maxLength": 200,
"description": "CSL style id for format text, e.g. apa (default), ieee, chicago-author-date, modern-language-association, vancouver, nature. Lowercased. A style that would silently fall back to APA is rejected. Verified ids: datacite_list_reference topic citation_styles."
},
"format": {
"enum": [
"text",
"csl_json",
"bibtex",
"ris",
"datacite_json",
"datacite_xml",
"schema_org",
"codemeta",
"jats"
],
"type": "string",
"description": "text (formatted citation, default), csl_json, bibtex, ris, datacite_json, datacite_xml, schema_org, codemeta, or jats."
},
"locale": {
"type": "string",
"pattern": "^\\s*[A-Za-z]{2,3}(?:[-_][A-Za-z0-9]{2,4}){0,2}\\s*$",
"description": "CSL locale for format text, e.g. en-GB, de-DE, fr-FR, or a bare language (de → de-DE); any case. Omitted: en-US. List: datacite_list_reference topic citation_locales."
}
},
"additionalProperties": false
}Fetch the full deposited DataCite metadata for one DOI: titles, creators and contributors with ORCID iDs and ROR affiliations, publisher, dates, version, subjects, descriptions, funding, geolocations, rights, sizes and formats, related identifiers with their relation types, repository and provider, and citation, reference, version, part, view, and download counts. Long lists are capped with exact list/offset continuation recipes; select a list to retrieve later entries without losing the other metadata. datacite_trace_relations maps a bounded graph (at most 100 nodes and 1,000 edges). A DOI DataCite does not hold returns found: false naming the registration agency that does, or saying the DOI does not exist.
| Argument | Type | Description |
|---|---|---|
| doi* | string | The DOI, e.g. 10.5061/dryad.234: 10., a 4–9 digit registrant, a slash, and a suffix. Accepted bare, with doi: or info:doi/ prefixes, as a doi.org / dx.doi.org URL, or %2F-encoded; case-insensitive. |
| list | string | One capped list to page in deposit order; other record fields keep their default caps. |
| offset | integer | Zero-based offset into valid mapped entries of list. Defaults to zero with list; requires list. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"doi"
],
"properties": {
"doi": {
"type": "string",
"pattern": "^\\s*(?:[Hh][Tt][Tt][Pp][Ss]?:\\/\\/(?:[Dd][Xx]\\.)?[Dd][Oo][Ii]\\.[Oo][Rr][Gg]\\/)?(?:[Dd][Oo][Ii]:\\s*|[Ii][Nn][Ff][Oo]:[Dd][Oo][Ii]\\/)?10\\.\\S+\\s*$",
"maxLength": 500,
"description": "The DOI, e.g. 10.5061/dryad.234: 10., a 4–9 digit registrant, a slash, and a suffix. Accepted bare, with doi: or info:doi/ prefixes, as a doi.org / dx.doi.org URL, or %2F-encoded; case-insensitive."
},
"list": {
"enum": [
"creators",
"contributors",
"relatedIdentifiers",
"subjects",
"fundingReferences",
"relatedItems",
"geoLocations"
],
"type": "string",
"description": "One capped list to page in deposit order; other record fields keep their default caps."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based offset into valid mapped entries of list. Defaults to zero with list; requires list."
}
},
"additionalProperties": false
}Look up the controlled vocabularies and identifier forms the other datacite_* tools accept: resource types, relation types with their inverses and groups, related-identifier types, date and contributor types, fields of science, common license ids, repository types, certificates, software platforms, client types, sort orders, query-syntax field paths, citation formats, verified citation styles and locales, accepted identifier forms (DOI, ORCID iD, ROR ID, Crossref Funder ID, country, language, repository, and provider ids), and coverage and rate-limit rules. Offline; makes no upstream request.
| Argument | Type | Description |
|---|---|---|
| topic* | string | Which vocabulary or rule set to return. identifier_types lists related-identifier types (the relatedIdentifierType values datacite_trace_relations reports as node idType); identifier_formats lists the accepted input forms of DOIs, ORCID iDs, ROR IDs, Crossref Funder IDs, country and language codes, and repository and provider ids; query_syntax lists the field paths and operators of the datacite_search_works query input; coverage states what DataCite holds, the paging and facet limits, citation accrual, Event Data scope, and rate limits. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"topic"
],
"properties": {
"topic": {
"enum": [
"resource_types",
"relation_types",
"identifier_types",
"date_types",
"contributor_types",
"fields_of_science",
"licenses",
"repository_types",
"certificates",
"software_platforms",
"client_types",
"sort_orders",
"query_syntax",
"citation_formats",
"citation_styles",
"citation_locales",
"identifier_formats",
"coverage"
],
"type": "string",
"description": "Which vocabulary or rule set to return. identifier_types lists related-identifier types (the relatedIdentifierType values datacite_trace_relations reports as node idType); identifier_formats lists the accepted input forms of DOIs, ORCID iDs, ROR IDs, Crossref Funder IDs, country and language codes, and repository and provider ids; query_syntax lists the field paths and operators of the datacite_search_works query input; coverage states what DataCite holds, the paging and facet limits, citation accrual, Event Data scope, and rate limits."
}
},
"additionalProperties": false
}Find DataCite repository accounts by name or description text, field of science, repository type, certification (e.g. CoreTrustSeal), software platform, client type, or parent provider, or look up known repository IDs. Returns each repository's repositoryId — the value datacite_search_works takes in repository_ids — with its providerId, name, type, certificates, software, subjects, homepage, and re3data link. To rank repositories by how many works they hold on a topic, run datacite_search_works with that topic and include_facets: true; its repositories facet lists the top ten with counts.
| Argument | Type | Description |
|---|---|---|
| page | integer | Page number. Past the last page the list is empty. |
| limit | integer | Requested repositories per page, 1–10,000; values above 100 apply 100 with a notice. |
| query | string | Text matched against repository names, alternate names, and descriptions. Query-string syntax is accepted. |
| software | string | Software platform slug, lowercased: dataverse, dspace, invenio, ckan, open_journal_systems_ojs, … (free-form upstream; see datacite_list_reference topic software_platforms). |
| client_type | string | Account type: repository, periodical, igsnCatalog, or raidRegistry. Omitted: all. |
| provider_id | string | Parent provider id, e.g. dryad — the providerId a repository carries. Any case. |
Search DataCite DOI metadata for datasets, software, samples, workflows, and other research outputs. Combine plain words (`text`) or OpenSearch query syntax (`query`) with filters for resource type, creator (ORCID iD or name), affiliation (ROR ID or name), affiliation country, funder (ROR ID, Crossref Funder ID, or name), subject, field of science, repository, provider, license, language, geographic place, publication-year range, and minimum citation count. Returns the total match count and compact rows — DOI, title, first creators, year, type, repository, licenses, and citation/view/download counts — plus optional top facet counts. Page numbers reach the first 10,000 ranked matches; pass cursor "*" to walk any result set in full, in registration order.
| Argument | Type | Description |
|---|---|---|
| page | integer | Ranked page number, 1 when omitted. page × limit may not exceed 10,000; not with cursor. |
| sort | string | relevance, newest, oldest, recently_updated, most_cited, most_viewed, or most_downloaded. Omitted: relevance when text or query is set, else newest. Not with cursor. |
| text | string | Plain words and phrases, searched literally: every query-syntax character is escaped, so "Climate change: impacts" works and text can never cause a syntax error. Terms are ANDed. |
| limit | integer | Requested rows per page, 1–10,000; values above 100 apply 100 with a notice. |
| place | string | A geographic place phrase, matched against deposited place names. |
Map the relation graph around one DOI — versions, parts, supplements, derivations, documentation, citations, references, and every other DataCite relation type — as nodes and directed edges that keep the relationType exactly as asserted and name each edge's source: the DOI's own metadata, other DataCite records that point at it, or DataCite Event Data (citation links harvested from Crossref and other sources). Accepts any DOI, including a journal article's DOI, to find the datasets and software it cites and those that cite, supplement, or derive from it. DataCite DOIs are hydrated with title, type, year, repository, and citation count; other identifiers stay leaf nodes. Depth 1 by default, at most 2, with a node cap (default 50, max 100) disclosed when it binds. An absent edge is not evidence that no relationship exists.
| Argument | Type | Description |
|---|---|---|
| doi* | string | The root DOI — any agency's, e.g. a DataCite dataset 10.5061/dryad.234 or a journal article's DOI. Bare, doi:, or a doi.org URL; case-insensitive. |
| depth | integer | Hops from the root: 1 (default) or 2. Depth 2 expands at most 10 DataCite neighbours through their own and reverse metadata, and runs only while max_nodes has room after the first hop. |
| max_nodes | integer | Requested node cap including the root, 1–10,000 (default 50); values above 100 apply 100 with a notice. Filled in order: own-metadata targets, records pointing at the root, Event Data endpoints, then the second hop. |
| event_offset | integer | Absolute zero-based Event Data position, 0–9,999. Presence, including 0, selects Event-Data-only mode: no metadata edges or depth-2 expansion. Reads one 100-event upstream page, starting within it. Continue with coverage.eventData.nextEventOffset and the same doi and filters; ordering can change between calls, so this is not a snapshot. |
| certificates | array | Certificates (any match): CoreTrustSeal, WDS, DSA, DINI, RatSWD, CLARIN, DIN 31644; any case. |
| repository_ids | array | Known repository ids, shaped provider.repository (e.g. dryad.dryad); any case. Up to 1,000 inputs; queries the first 25 distinct normalized ids and names omitted ids. Use alone — an id lookup ignores query and filters. |
| field_of_science | string | An OECD Fields of Science id or label the repository lists among its subjects, e.g. earth_and_related_environmental_sciences. List: datacite_list_reference topic fields_of_science. |
| repository_types | array | Repository types (any match): institutional, disciplinary, multidisciplinary, project-related, governmental, other. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"default": 1,
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number. Past the last page the list is empty."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 10000,
"minimum": 1,
"description": "Requested repositories per page, 1–10,000; values above 100 apply 100 with a notice."
},
"query": {
"type": "string",
"maxLength": 2000,
"description": "Text matched against repository names, alternate names, and descriptions. Query-string syntax is accepted."
},
"software": {
"type": "string",
"maxLength": 500,
"description": "Software platform slug, lowercased: dataverse, dspace, invenio, ckan, open_journal_systems_ojs, … (free-form upstream; see datacite_list_reference topic software_platforms)."
},
"client_type": {
"enum": [
"repository",
"periodical",
"igsnCatalog",
"raidRegistry"
],
"type": "string",
"description": "Account type: repository, periodical, igsnCatalog, or raidRegistry. Omitted: all."
},
"provider_id": {
"type": "string",
"pattern": "^\\s*[A-Za-z0-9-]+\\s*$",
"maxLength": 100,
"description": "Parent provider id, e.g. dryad — the providerId a repository carries. Any case."
},
"certificates": {
"type": "array",
"items": {
"enum": [
"CoreTrustSeal",
"WDS",
"DSA",
"DINI",
"RatSWD",
"CLARIN",
"DIN 31644"
],
"type": "string"
},
"maxItems": 7,
"description": "Certificates (any match): CoreTrustSeal, WDS, DSA, DINI, RatSWD, CLARIN, DIN 31644; any case."
},
"repository_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\s*[A-Za-z0-9-]+\\.[A-Za-z0-9-]+\\s*$",
"maxLength": 100
},
"maxItems": 1000,
"description": "Known repository ids, shaped provider.repository (e.g. dryad.dryad); any case. Up to 1,000 inputs; queries the first 25 distinct normalized ids and names omitted ids. Use alone — an id lookup ignores query and filters."
},
"field_of_science": {
"enum": [
"natural_sciences",
"mathematics",
"computer_and_information_sciences",
"physical_sciences",
"chemical_sciences",
"earth_and_related_environmental_sciences",
"biological_sciences",
"other_natural_sciences",
"engineering_and_technology",
"civil_engineering",
"electrical_engineering_electronic_engineering_information_engineering",
"mechanical_engineering",
"chemical_engineering",
"materials_engineering",
"medical_engineering",
"environmental_engineering",
"environmental_biotechnology",
"industrial_biotechnology",
"nanotechnology",
"other_engineering_and_technologies",
"medical_and_health_sciences",
"basic_medicine",
"clinical_medicine",
"health_sciences",
"medical_biotechnology",
"other_medical_sciences",
"agricultural_sciences",
"agriculture_forestry_and_fisheries",
"animal_and_dairy_science",
"veterinary_science",
"agricultural_biotechnology",
"other_agricultural_sciences",
"social_sciences",
"psychology",
"economics_and_business",
"educational_sciences",
"sociology",
"law",
"political_science",
"social_and_economic_geography",
"media_and_communications",
"other_social_sciences",
"humanities",
"history_and_archaeology",
"languages_and_literature",
"philosophy_ethics_and_religion",
"arts_arts_history_of_arts_performing_arts_music",
"other_humanities"
],
"type": "string",
"description": "An OECD Fields of Science id or label the repository lists among its subjects, e.g. earth_and_related_environmental_sciences. List: datacite_list_reference topic fields_of_science."
},
"repository_types": {
"type": "array",
"items": {
"enum": [
"institutional",
"disciplinary",
"multidisciplinary",
"project-related",
"governmental",
"other"
],
"type": "string"
},
"maxItems": 6,
"description": "Repository types (any match): institutional, disciplinary, multidisciplinary, project-related, governmental, other."
}
},
"additionalProperties": false
}| query | string | OpenSearch query-string syntax — field paths (titles.title:"…", creators.name:…, relatedIdentifiers.relationType:…), AND/OR/NOT, ranges, wildcards. Field paths: datacite_list_reference topic query_syntax. ANDed with text and the filters. |
| cursor | string | Cursor walk over the full result set in registration order: "*" to start, then the nextCursor of the previous page, unchanged, with the same query and filters. Not with page or sort. |
| funder | string | A funder ROR ID, a Crossref Funder ID (10.13039/100000001, its doi.org URL, or the bare digits), or a funder name. |
| creator | string | A creator ORCID iD (0000-0002-1825-0097, 16 digits, or an orcid.org URL; checksum verified) or a name — every name token must appear in one creator field. |
| subject | string | A subject phrase, matched case-insensitively against subject terms. |
| language | string | ISO 639-1 language code of the work, any case (en, de). |
| licenses | array | The work's own license ids (any match), e.g. cc-by-4.0, cc0-1.0, cc0 1.0, mit. Trimmed and lowercased, then matched exactly, preserving internal spaces; reuse ids from the licenses facet or datacite_list_reference topic licenses. |
| affiliation | string | A ROR ID (021nxhr62 or a ror.org URL) — matches creator and contributor affiliations — or an affiliation name phrase. |
| provider_ids | array | Provider ids (any match), e.g. dryad — the providerId datacite_search_repositories returns. Any case. |
| published_to | integer | Latest publication year (inclusive). Alone, the range is open-ended. |
| min_citations | integer | Only works DataCite records at least this many citations for. |
| include_facets | boolean | Add top facet counts (resource types, years, repositories, providers, affiliations, fields of science, licenses). Adds 2–8 s. |
| published_from | integer | Earliest publication year (inclusive). Alone, the range is open-ended. |
| repository_ids | array | Repository ids (any match), shaped provider.repository — e.g. dryad.dryad or cern.zenodo — as datacite_search_repositories returns them in repositoryId. Any case. |
| resource_types | array | resourceTypeGeneral values (any match): dataset, software, computational-notebook, workflow, model, physical-object, … PascalCase accepted. Full list: datacite_list_reference topic resource_types. |
| fields_of_science | array | OECD Fields of Science ids or labels (any match), e.g. computer_and_information_sciences or "Earth and related environmental sciences". List: datacite_list_reference topic fields_of_science. |
| affiliation_country | string | ISO 3166-1 alpha-2 country of a creator or contributor affiliation, any case (DE, us). Alpha-3 codes and names are rejected. |
| include_child_funders | boolean | Also match the ROR funder's child organizations. Only with a ROR funder. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Ranked page number, 1 when omitted. page × limit may not exceed 10,000; not with cursor."
},
"sort": {
"enum": [
"relevance",
"newest",
"oldest",
"recently_updated",
"most_cited",
"most_viewed",
"most_downloaded"
],
"type": "string",
"description": "relevance, newest, oldest, recently_updated, most_cited, most_viewed, or most_downloaded. Omitted: relevance when text or query is set, else newest. Not with cursor."
},
"text": {
"type": "string",
"maxLength": 2000,
"description": "Plain words and phrases, searched literally: every query-syntax character is escaped, so \"Climate change: impacts\" works and text can never cause a syntax error. Terms are ANDed."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 10000,
"minimum": 1,
"description": "Requested rows per page, 1–10,000; values above 100 apply 100 with a notice."
},
"place": {
"type": "string",
"maxLength": 500,
"description": "A geographic place phrase, matched against deposited place names."
},
"query": {
"type": "string",
"maxLength": 2000,
"description": "OpenSearch query-string syntax — field paths (titles.title:\"…\", creators.name:…, relatedIdentifiers.relationType:…), AND/OR/NOT, ranges, wildcards. Field paths: datacite_list_reference topic query_syntax. ANDed with text and the filters."
},
"cursor": {
"type": "string",
"pattern": "^\\s*(?:\\*|[A-Za-z0-9_-]+)\\s*$",
"maxLength": 2048,
"description": "Cursor walk over the full result set in registration order: \"*\" to start, then the nextCursor of the previous page, unchanged, with the same query and filters. Not with page or sort."
},
"funder": {
"type": "string",
"maxLength": 500,
"description": "A funder ROR ID, a Crossref Funder ID (10.13039/100000001, its doi.org URL, or the bare digits), or a funder name."
},
"creator": {
"type": "string",
"maxLength": 500,
"description": "A creator ORCID iD (0000-0002-1825-0097, 16 digits, or an orcid.org URL; checksum verified) or a name — every name token must appear in one creator field."
},
"subject": {
"type": "string",
"maxLength": 500,
"description": "A subject phrase, matched case-insensitively against subject terms."
},
"language": {
"type": "string",
"pattern": "^\\s*[A-Za-z]{2}\\s*$",
"description": "ISO 639-1 language code of the work, any case (en, de)."
},
"licenses": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\s*[A-Za-z0-9.+_-](?:[A-Za-z0-9.+_ -]*[A-Za-z0-9.+_-])?\\s*$",
"maxLength": 100
},
"maxItems": 10,
"description": "The work's own license ids (any match), e.g. cc-by-4.0, cc0-1.0, cc0 1.0, mit. Trimmed and lowercased, then matched exactly, preserving internal spaces; reuse ids from the licenses facet or datacite_list_reference topic licenses."
},
"affiliation": {
"type": "string",
"maxLength": 500,
"description": "A ROR ID (021nxhr62 or a ror.org URL) — matches creator and contributor affiliations — or an affiliation name phrase."
},
"provider_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\s*[A-Za-z0-9-]+\\s*$",
"maxLength": 100
},
"maxItems": 10,
"description": "Provider ids (any match), e.g. dryad — the providerId datacite_search_repositories returns. Any case."
},
"published_to": {
"type": "integer",
"maximum": 2100,
"minimum": 1000,
"description": "Latest publication year (inclusive). Alone, the range is open-ended."
},
"min_citations": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Only works DataCite records at least this many citations for."
},
"include_facets": {
"type": "boolean",
"default": false,
"description": "Add top facet counts (resource types, years, repositories, providers, affiliations, fields of science, licenses). Adds 2–8 s."
},
"published_from": {
"type": "integer",
"maximum": 2100,
"minimum": 1000,
"description": "Earliest publication year (inclusive). Alone, the range is open-ended."
},
"repository_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\s*[A-Za-z0-9-]+\\.[A-Za-z0-9-]+\\s*$",
"maxLength": 100
},
"maxItems": 10,
"description": "Repository ids (any match), shaped provider.repository — e.g. dryad.dryad or cern.zenodo — as datacite_search_repositories returns them in repositoryId. Any case."
},
"resource_types": {
"type": "array",
"items": {
"enum": [
"audiovisual",
"award",
"book",
"book-chapter",
"collection",
"computational-notebook",
"conference-paper",
"conference-proceeding",
"data-paper",
"dataset",
"dissertation",
"event",
"image",
"instrument",
"interactive-resource",
"journal",
"journal-article",
"model",
"other",
"output-management-plan",
"peer-review",
"physical-object",
"poster",
"preprint",
"presentation",
"project",
"report",
"service",
"software",
"sound",
"standard",
"study-registration",
"text",
"workflow"
],
"type": "string"
},
"maxItems": 10,
"description": "resourceTypeGeneral values (any match): dataset, software, computational-notebook, workflow, model, physical-object, … PascalCase accepted. Full list: datacite_list_reference topic resource_types."
},
"fields_of_science": {
"type": "array",
"items": {
"enum": [
"natural_sciences",
"mathematics",
"computer_and_information_sciences",
"physical_sciences",
"chemical_sciences",
"earth_and_related_environmental_sciences",
"biological_sciences",
"other_natural_sciences",
"engineering_and_technology",
"civil_engineering",
"electrical_engineering_electronic_engineering_information_engineering",
"mechanical_engineering",
"chemical_engineering",
"materials_engineering",
"medical_engineering",
"environmental_engineering",
"environmental_biotechnology",
"industrial_biotechnology",
"nanotechnology",
"other_engineering_and_technologies",
"medical_and_health_sciences",
"basic_medicine",
"clinical_medicine",
"health_sciences",
"medical_biotechnology",
"other_medical_sciences",
"agricultural_sciences",
"agriculture_forestry_and_fisheries",
"animal_and_dairy_science",
"veterinary_science",
"agricultural_biotechnology",
"other_agricultural_sciences",
"social_sciences",
"psychology",
"economics_and_business",
"educational_sciences",
"sociology",
"law",
"political_science",
"social_and_economic_geography",
"media_and_communications",
"other_social_sciences",
"humanities",
"history_and_archaeology",
"languages_and_literature",
"philosophy_ethics_and_religion",
"arts_arts_history_of_arts_performing_arts_music",
"other_humanities"
],
"type": "string"
},
"maxItems": 10,
"description": "OECD Fields of Science ids or labels (any match), e.g. computer_and_information_sciences or \"Earth and related environmental sciences\". List: datacite_list_reference topic fields_of_science."
},
"affiliation_country": {
"type": "string",
"pattern": "^\\s*[A-Za-z]{2}\\s*$",
"description": "ISO 3166-1 alpha-2 country of a creator or contributor affiliation, any case (DE, us). Alpha-3 codes and names are rejected."
},
"include_child_funders": {
"type": "boolean",
"default": false,
"description": "Also match the ROR funder's child organizations. Only with a ROR funder."
}
},
"additionalProperties": false
}| relation_types | array | Only these relation types (IsVersionOf, HasPart, IsSupplementTo, IsDerivedFrom, Cites, IsCitedBy, …), any case, read from the traced DOI's side: HasPart keeps the DOI's own HasPart assertions and the records asserting IsPartOf it, each edge shown as asserted. IsPublishedIn and Other have no inverse and match on either side. A second hop reads them from each expanded neighbour's side. Omitted: all. Groups: datacite_list_reference topic relation_types. |
| include_event_data | boolean | Add Event Data citation links (mostly harvested from Crossref). Citation relation types only. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"doi"
],
"properties": {
"doi": {
"type": "string",
"pattern": "^\\s*(?:[Hh][Tt][Tt][Pp][Ss]?:\\/\\/(?:[Dd][Xx]\\.)?[Dd][Oo][Ii]\\.[Oo][Rr][Gg]\\/)?(?:[Dd][Oo][Ii]:\\s*|[Ii][Nn][Ff][Oo]:[Dd][Oo][Ii]\\/)?10\\.\\S+\\s*$",
"maxLength": 500,
"description": "The root DOI — any agency's, e.g. a DataCite dataset 10.5061/dryad.234 or a journal article's DOI. Bare, doi:, or a doi.org URL; case-insensitive."
},
"depth": {
"type": "integer",
"default": 1,
"maximum": 2,
"minimum": 1,
"description": "Hops from the root: 1 (default) or 2. Depth 2 expands at most 10 DataCite neighbours through their own and reverse metadata, and runs only while max_nodes has room after the first hop."
},
"max_nodes": {
"type": "integer",
"default": 50,
"maximum": 10000,
"minimum": 1,
"description": "Requested node cap including the root, 1–10,000 (default 50); values above 100 apply 100 with a notice. Filled in order: own-metadata targets, records pointing at the root, Event Data endpoints, then the second hop."
},
"event_offset": {
"type": "integer",
"maximum": 9999,
"minimum": 0,
"description": "Absolute zero-based Event Data position, 0–9,999. Presence, including 0, selects Event-Data-only mode: no metadata edges or depth-2 expansion. Reads one 100-event upstream page, starting within it. Continue with coverage.eventData.nextEventOffset and the same doi and filters; ordering can change between calls, so this is not a snapshot."
},
"relation_types": {
"type": "array",
"items": {
"enum": [
"HasVersion",
"IsVersionOf",
"IsNewVersionOf",
"IsPreviousVersionOf",
"HasPart",
"IsPartOf",
"Cites",
"IsCitedBy",
"References",
"IsReferencedBy",
"IsSupplementTo",
"IsSupplementedBy",
"IsDerivedFrom",
"IsSourceOf",
"Documents",
"IsDocumentedBy",
"Describes",
"IsDescribedBy",
"HasMetadata",
"IsMetadataFor",
"Continues",
"IsContinuedBy",
"Compiles",
"IsCompiledBy",
"IsVariantFormOf",
"IsOriginalFormOf",
"IsIdenticalTo",
"Reviews",
"IsReviewedBy",
"Requires",
"IsRequiredBy",
"Obsoletes",
"IsObsoletedBy",
"Collects",
"IsCollectedBy",
"HasTranslation",
"IsTranslationOf",
"IsPublishedIn",
"Other"
],
"type": "string"
},
"maxItems": 39,
"description": "Only these relation types (IsVersionOf, HasPart, IsSupplementTo, IsDerivedFrom, Cites, IsCitedBy, …), any case, read from the traced DOI's side: HasPart keeps the DOI's own HasPart assertions and the records asserting IsPartOf it, each edge shown as asserted. IsPublishedIn and Other have no inverse and match on either side. A second hop reads them from each expanded neighbour's side. Omitted: all. Groups: datacite_list_reference topic relation_types."
},
"include_event_data": {
"type": "boolean",
"default": true,
"description": "Add Event Data citation links (mostly harvested from Crossref). Citation relation types only."
}
},
"additionalProperties": false
}