DataCite API Guide

DataCite API Guide

Overview

DataCite is a leading global DOI registration agency focused on research data. While CrossRef primarily handles DOIs for publications, DataCite specializes in assigning persistent identifiers to datasets, software, samples, instruments, and other research outputs. DataCite has registered over 50 million DOIs from thousands of data repositories worldwide.

The DataCite REST API provides access to metadata for all DataCite DOIs. It is essential for researchers and developers working with research data discovery, data citation, FAIR (Findable, Accessible, Interoperable, Reusable) data practices, and repository integration. The metadata follows the DataCite Metadata Schema, which is designed specifically for describing research data and includes fields for resource types, funding references, geolocation, and related identifiers.

The API is free, open, and requires no authentication. It returns JSON responses following the JSON:API specification, with robust filtering, faceting, and pagination support.

Authentication

No authentication required. The DataCite API is fully open and free to use. No API key, registration, or email is needed. For write operations (DOI registration and metadata updates), authentication via DataCite member credentials is required, but read-only access is completely open.

Core Endpoints

DOIs: Search and Retrieve Dataset Metadata

• URL: GET https://api.datacite.org/dois
• Parameters:

  Param	Type	Required	Description
  query	string	No	Full-text search query
  resource-type-id	string	No	Filter by resource type (dataset, software, text, etc.)
  affiliation-id	string	No	Filter by creator affiliation ROR ID
  registered	string	No	Filter by registration year (e.g., 2024)
  page[size]	integer	No	Results per page (default: 25, max: 1000)
  page[number]	integer	No	Page number for pagination
  sort	string	No	Sort field: relevance, created, -created, updated

• Example:

  curl "https://api.datacite.org/dois?query=climate+change+dataset&resource-type-id=dataset&page[size]=10&sort=-created"
  

• Response: JSON:API formatted response with data array containing DOI records. Each record has attributes with doi, titles, creators, publisher, publicationYear, resourceType, descriptions, subjects, dates, relatedIdentifiers, fundingReferences, and geoLocations.

Single DOI: Direct Lookup

• URL: GET https://api.datacite.org/dois/{doi}
• Parameters: | Param | Type | Required | Description |