Search Dois
search_doisSearch DataCite-registered DOIs (research datasets, software, etc.). Filter by free-text query, resource type, year, publisher, or affiliation, and SORT by relevance, recency, citations, downloads, or views — e.g. "most-downloaded climate datasets" (sort=downloads), "newest genomics datasets" (sort=recent), "most-cited datasets on X" (sort=citations). Returns DOI, title, creators, publisher, type, year, and citation/download/view counts.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"year": 2023,
"query": "climate change temperature anomaly",
"resource_type": "Dataset"
},
"name": "search_dois"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 1-based page (default 1) | |
| sort | No | Result ordering: relevance (default), recent (newest registered), oldest, published (newest publication year), citations (most-cited), downloads (most-downloaded), views (most-viewed). | |
| year | No | Publication year | |
| query | No | Free-text query (titles, descriptions, creators) | |
| page_size | No | 1-1000 (default 25) | |
| publisher | No | Publisher name filter | |
| affiliation | No | Creator affiliation | |
| resource_type | No | Dataset | Software | Text | Image | Sound | Other (case-sensitive) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| total | Yes | Total number of DOIs matching the query | |
| results | Yes | Array of DOI summary records | |
| returned | Yes | Number of results returned in this page | |
| total_pages | Yes | Total number of pages available |