用途
DataCite API 用于解析数据集 DOI 并查询研究数据元数据。DataCite 是专注研究数据的全球 DOI 注册机构,为数据集、软件、样本、仪器等研究成果分配持久标识符,已注册超过 5000 万个 DOI。该 API 面向从事研究数据发现、数据引用、FAIR(可查找、可访问、可互操作、可重用)数据实践和仓储集成的研究人员与开发者。
主要能力
- DOIs 端点:搜索和检索数据集元数据,支持全文搜索、按资源类型(dataset、software、text 等)、创建者所属机构 ROR ID、注册年份过滤,支持分页和排序。
- 单个 DOI 直接查询:通过完整 DOI(如 10.5281/zenodo.3678171)获取完整元数据。
- Providers 端点:查询数据仓储机构信息,支持按名称、区域过滤。
- Clients 端点:查询仓储详情,支持按名称、provider、仓储软件(如 dspace、dataverse)过滤。
- 元数据遵循 DataCite Metadata Schema,包含资源类型、资助引用、地理位置、相关标识符等字段。
- 返回符合 JSON:API 规范的 JSON 响应,支持过滤、分面和分页。
使用方式
无需认证,API 完全开放免费,不需要 API key、注册或邮箱。写操作(DOI 注册和元数据更新)需要 DataCite 成员凭据,只读访问完全开放。
核心端点示例:
搜索数据集:
curl "https://api.datacite.org/dois?query=climate+change+dataset&resource-type-id=dataset&page[size]=10&sort=-created"
单个 DOI 查询:
curl "https://api.datacite.org/dois/10.5281/zenodo.3678171"
查询 Providers:
curl "https://api.datacite.org/providers?query=CERN&page[size]=5"
查询 Clients:
curl "https://api.datacite.org/clients?query=zenodo&page[size]=5"
常见模式:
发现某研究主题的数据集:
curl -s "https://api.datacite.org/dois?query=CRISPR+genome+editing&resource-type-id=dataset&page[size]=5&sort=-created" | jq '.data[] | {doi: .attributes.doi, title: .attributes.titles[0].title, year: .attributes.publicationYear, publisher: .attributes.publisher}'
查找软件引用:
curl -s "https://api.datacite.org/dois?query=python+machine+learning&resource-type-id=software&page[size]=10" | jq '.data[] | {doi: .attributes.doi, title: .attributes.titles[0].title, year: .attributes.publicationYear}'
将数据集关联到出版物:
curl -s "https://api.datacite.org/dois/10.5281/zenodo.3678171" | jq '.data.attributes.relatedIdentifiers[] | select(.relationType == "IsSupplementTo" or .relationType == "IsReferencedBy") | {type: .relationType, id: .relatedIdentifier}'
适用场景
- 研究数据发现与检索
- 数据引用与学术关联
- FAIR 数据实践
- 仓储集成与元数据获取
- 软件引用查询
限制
- 无公布的速率限制,DataCite 对只读访问不强制执行严格配额,但作为非营利组织运营,用户应实施合理的请求节奏。
- 大规模数据挖掘建议使用 DataCite OAI-PMH 端点或公开数据文件(https://datafiles.datacite.org)。
- 持续高流量请求可能被无通知限流。
参考
- 官方文档:https://support.datacite.org/docs/api
- DataCite Metadata Schema:https://schema.datacite.org/
- JSON:API 规范:https://jsonapi.org/