Search DataCite repositories
datacite_search_repositoriesRead-onlyIdempotent
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.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number. Past the last page the list is empty. | |
| limit | No | Repositories per page, 1–100. | |
| query | No | Text matched against repository names, alternate names, and descriptions. Query-string syntax is accepted. | |
| software | No | Software platform slug, lowercased: dataverse, dspace, invenio, ckan, open_journal_systems_ojs, … (free-form upstream; see datacite_list_reference topic software_platforms). | |
| client_type | No | Account type: repository, periodical, igsnCatalog, or raidRegistry. Omitted: all. | |
| provider_id | No | Parent provider id, e.g. dryad — the providerId a repository carries. Any case. | |
| certificates | No | Certificates (any match): CoreTrustSeal, WDS, DSA, DINI, RatSWD, CLARIN, DIN 31644; any case. | |
| repository_ids | No | Known repository ids to look up in one batch, shaped provider.repository (e.g. dryad.dryad); any case. Use alone — an id lookup ignores query and filters. | |
| field_of_science | No | 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 | No | Repository types (any match): institutional, disciplinary, multidisciplinary, project-related, governmental, other. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present when the call failed. Absent on success. | |
| notice | No | Guidance when nothing matched, the page is past the end, or a requested repository id matched no account. | |
| nextPage | No | Next page number, when more repositories match. | |
| totalCount | No | Total repositories matching. | |
| orderApplied | No | Result order — always by name, as the registry returns it. | |
| repositories | No | Repositories on this page, ordered by name. | |
| appliedFilters | No | Every applied filter as sent upstream; {} when none. |