# DataCite API
> DataCite as an API — the global registry of DOIs (Digital Object Identifiers) for research outputs. Where Crossref registers DOIs for journal articles, DataCite registers and describes DOIs for research data, software, samples, dissertations, preprints, models, images and other outputs, from repositories such as Zenodo, Dryad and thousands of institutions. /v1/search?query=climate full-text searches the registry and can be narrowed by resource type (type=dataset, software, text, image, audiovisual, collection, model and more), returning each DOI with its title, type, creators, publisher and publication year. /v1/doi?id=10.5281/zenodo.3509134 returns a single DOI's full metadata — title, resource type, creators, publisher, publication year, description, subjects, version, license and registration date. DOIs look like 10.5281/zenodo.3509134 (Zenodo) or 10.5061/dryad.xxxx (Dryad). Ideal for research-data discovery and citation, data-repository and reference-management tools, software-citation features and reproducibility workflows. Metadata is CC0 from DataCite. This is the registry of research data and software DOIs — distinct from the journal-article DOI index (Crossref) and from preprint and open-access services.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/datacite-api/..."
```

## Pricing
- **Free** (Free) — 2,350 calls/Mo, 2 req/s
- **Starter** ($8/Mo) — 49,200 calls/Mo, 5 req/s
- **Pro** ($23/Mo) — 213,000 calls/Mo, 12 req/s
- **Mega** ($62/Mo) — 776,000 calls/Mo, 35 req/s

## Endpoints

### DOIs

#### `GET /v1/doi` — A DOI full metadata

**Parameters:**
- `id` (query, required, string) — DOI (from /v1/search), e.g. 10.5281/zenodo.3509134 Example: `10.5281/zenodo.3509134`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/datacite-api/v1/doi?id=10.5281%2Fzenodo.3509134"
```

**Response:**
```json
{
    "data": {
        "record": {
            "doi": "10.5281/zenodo.3509134",
            "url": "https://zenodo.org/doi/10.5281/zenodo.3509134",
            "type": "Software",
            "year": 2026,
            "title": "pandas-dev/pandas: Pandas",
            "license": "bsd-3-clause",
            "version": "v3.0.3",
            "creators": [
                "The pandas development team"
            ],
            "subjects": [
                "python",
                "data science",
                "flexible",
                "pandas",
                "alignment",
                "data analysis"
            ],
            "publisher": "Zenodo",
            "registered": "2019-10-18",
            "description": "Pandas is a powerful data structures for data analysis, time series, and statistics."
        }
    },
    "meta": {
        "timestamp": "2026-06-01T16:23:17.171Z",
        "request_id": "17c89d1f-3f2b-455e-b50a-105100417057"
    },
    "status": "ok",
    "message": "DOI retrieved",
    "success": true
}
```

#### `GET /v1/search` — Search the DOI registry

**Parameters:**
- `q` (query, required, string) — Search text, e.g. climate Example: `climate`
- `type` (query, optional, string) — Resource type, e.g. dataset, software Example: `dataset`
- `limit` (query, optional, string) — Max results (1-100)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/datacite-api/v1/search?q=climate&type=dataset"
```

**Response:**
```json
{
    "data": {
        "type": "dataset",
        "count": 20,
        "query": "climate",
        "total": 204408,
        "results": [
            {
                "doi": "10.5281/zenodo.20486571",
                "url": "https://zenodo.org/doi/10.5281/zenodo.20486571",
                "type": "Dataset",
                "year": 2026,
                "title": "TEAMx: GeoSphere Austria Ceilometer Data for Kufstein, Austria",
                "creators": [
                    "de Wit, Rosmarie",
                    "Baumann-Stanzer, Kathrin",
                    "Hieden, Alexander"
                ],
                "publisher": "Zenodo"
            },
            {
                "doi": "10.5281/zenodo.20486570",
                "url": "https://zenodo.org/doi/10.5281/zenodo.20486570",
                "type": "Dataset",
                "year": 2026,
                "title": "TEAMx: GeoSphere Austria Ceilometer Data for Kufstein, Austria",
                "creators": [
                    "de Wit, Rosmarie",
                    "Baumann-Stanzer, Kathrin",
                    "Hieden, Alexander"
                ],
                "publisher": "Zenodo"
            },
            {
                "doi": "10.57830/2316942",
                "url": "https://irma.nps.gov/DataStore/Reference/Profile/2316942",
                "type": "Dataset",
                "year": 2026,
                "title": "Hourly surface and subsurface temperature data in subalpine and alpine talus of North
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Usage notes & resource types

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/datacite-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "DataCite is the global DOI registry for research outputs — research data, software, samples, dissertations, preprints, models and more (it is to data & software what Crossref is to journal articles). /v1/search?q=climate = full-text search the registry, optionally filtered by type (type=dataset, software, text, image, …), returning each DOI with its title, resource type, creators, publisher and year; /v1/doi?id=10.5281/zenodo.3509134 = a single DOI's full metadata — title, type, creators, publisher, publication year, description, subjects, version, license and registration date. DOIs look like 10.5281/zenodo.3509134 (Zenodo) or 10.5061/dryad.xxxx (Dryad). Data from DataCite (CC0 metadata). Distinct from journal-article DOI indexes (Crossref) — this is the registry of research data & software DOIs. Ideal for research-data discovery, citation, repository and reproducibility tooling.",
        "source": "DataCite REST API (api.datacite.org)",
        "endpoints": [
            "/v1/search",
            "/v1/doi",
            "/v1/meta"
        ],
        "resource_types": [
            "dataset",
            "software",
            "text",
            "image",
            "audiovisual",
            "collection",
            "model",
            "physicalobject",
            "workflow",
            "service",
            "sound",
            "other"
        ]
    },
    "meta": {
        "timestamp": "2026-06-01T16:23:17.591Z",
        "re
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/datacite-api
OpenAPI spec: https://www.oanor.com/api/datacite-api/openapi.json