SuperAPI AI 工具集

datacite-api

数据与分析

查看项目

更新于 10-16 08:18

技能介绍

用途

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/