Search Zenodo records
zenodo_search_recordsSearch Zenodo's open research repository — datasets, software releases, publications, and other deposits — by keyword query plus filters for resource type, community, funder, grant, creator ORCID, file type, license, access status, and publication date. Returns one summary per deposit (ids, DOIs, title, type, version, creators, license, access, file totals, usage counts) plus facet counts over the full match set, every filter applied. Query terms are OR-ed unless joined with AND, quoted phrases match exactly, and field syntax works on record fields (metadata.title:"…", metadata.subjects.subject:"…"). Only the latest version of each deposit is searched unless all_versions is true, and only the first 10,000 matches are reachable by paging. Resolve community, funder, and grant names to ids with zenodo_lookup_vocabulary first; open one deposit in full with zenodo_get_record.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "zenodo_search_records"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Result page, starting at 1. Only the first 10,000 matches are reachable, so the last reachable page is 10,000 ÷ size rounded up (400 at size 25). | |
| size | No | Results per page, at most 25 per call; larger values return 25. | |
| sort | No | Sort order: bestmatch, newest, oldest, mostviewed, mostdownloaded, updated-desc, updated-asc. Case, spaces, hyphens, and underscores are ignored when matching (MostViewed reads as mostviewed). Defaults to bestmatch with a query, newest without. | |
| award | No | One grant: an award id <funder-ror>::<number> (00k4n6c32::101135562), a bare grant number, or a CORDIS award DOI (10.3030/101135562). Find ids with zenodo_lookup_vocabulary (vocabulary: awards). | |
| query | No | Keyword query. Terms are OR-ed unless joined with AND; "quoted phrases" (double quotes) match exactly; field syntax such as metadata.title:"…" or doi:"10.5281/zenodo.N" works. Escape a literal / as \/. A bare DOI or record URL is rejected; open it with zenodo_get_record instead. With any filter other than community and all_versions, a query that is not valid search syntax (AND AND, a field: with no value, an unclosed [a TO b]) is rejected; without one, Zenodo matches it as plain text. Omit to browse with filters only. | |
| funder | No | One funder: a ROR id (01cwqze88), a ROR URL, or a Crossref Funder DOI (10.13039/100000002). Resolve a funder name with zenodo_lookup_vocabulary (vocabulary: funders). | |
| license | No | License id, e.g. cc-by-4.0, cc0-1.0, mit (lowercased). Find ids with zenodo_lookup_vocabulary (vocabulary: licenses). | |
| community | No | One community: its slug, UUID, or zenodo.org/communities/<slug> URL. Find slugs with zenodo_lookup_vocabulary (vocabulary: communities). | |
| file_type | No | File extensions, OR-ed (a single string is accepted): csv, zip, pdf, … Lowercased with any leading dot stripped. | |
| all_versions | No | Include superseded versions; by default only the latest version is searched. | |
| published_to | No | Latest publication date, YYYY, YYYY-MM, or YYYY-MM-DD; a partial date ends at its last day. | |
| access_status | No | Access status: open, restricted, embargoed, or metadata-only. Case, spaces, hyphens, and underscores are ignored when matching (Metadata Only reads as metadata-only). | |
| creator_orcid | No | Creator ORCID iD, e.g. 0000-0002-1825-0097; an https://orcid.org/ prefix is stripped and a trailing x uppercased. | |
| resource_type | No | Resource type ids, OR-ed (a single string is accepted): dataset, software, publication, publication-article, image-photo, … Any case; a subtype may also be written in the <type>::<id> form zenodo_lookup_vocabulary shows as its search value (publication::publication-article). A top-level type includes its subtypes. Look ids up with zenodo_lookup_vocabulary (vocabulary: resource_types). | |
| published_from | No | Earliest publication date, YYYY, YYYY-MM, or YYYY-MM-DD; a partial date starts at its first day. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | Page size applied (at most 25). | |
| hits | No | Matching deposits on this page. | |
| page | No | Page returned. | |
| size | No | Page size applied: size, or 25 when size asked for more. | |
| error | No | Present when the call failed. Absent on success. | |
| shown | No | Hits returned on this page. | |
| total | No | Exact number of matching records. | |
| facets | No | Facet counts over the full match set (every filter applied, so they agree with total), not just this page. | |
| notice | No | Guidance on a query Zenodo matched as plain text, empty results, the 10,000-result window, the 25-per-call size cap, or further pages. | |
| has_more | No | True when another reachable page follows. | |
| next_page | No | The next page number, when has_more. | |
| reachable | No | Matches reachable by paging: min(total, 10,000). | |
| truncated | No | True when more reachable matches follow this page. | |
| totalCount | No | Exact number of matching records. | |
| allVersions | No | Whether superseded versions were searched. | |
| appliedSort | No | The sort order applied. | |
| effectiveQuery | No | The exact q sent to Zenodo. |