DOI Metadata and Citation API: Crossref
收藏资源简介：
Resolve a DOI to full Crossref metadata (authors, journal, abstract, citation counts), a formatted citation in 7 styles, a BibTeX record, or search by keyword.
数据集概述
数据集名称：DOI Metadata and Citation API: Crossref
数据集简介： 这是 Crossref REST API 和 DOI 内容协商的实时代理，能够将任何 DOI 解析为完整的书目元数据（如标题、作者及其 ORCID/所属机构、期刊、摘要、引用次数、资助方、许可证等），或格式化的引文（支持 7 种样式）、BibTeX 记录。同时支持对 Crossref 上约 1.5 亿条已注册作品进行关键词搜索。
主要功能
- DOI 元数据解析：
GET /doi/{doi}— 返回完整的 Crossref 作品元数据（JSON 格式），包括 DOI、标题、副标题、作者（含 ORCID 和所属机构）、期刊、出版商、出版类型、年份/月份、卷/期/页码、ISSN、摘要、引用次数、参考文献数、许可证、学科分类、资助方、来源等信息。 - 格式化引文生成：
GET /doi/{doi}/citation?style=— 生成指定风格的引文文本，支持 APA、MLA、Chicago-author-date、Harvard-cite-them-right、IEEE、Vancouver、Nature 共 7 种引文风格，默认使用 APA。 - BibTeX 记录生成：
GET /doi/{doi}/bibtex— 提供可直接使用的 BibTeX 记录，便于文献管理工具使用。 - 关键词搜索：
GET /doi/search?q=— 支持在 Crossref 数据库中进行关键词搜索，支持设置查询长度（2–200 字符）、结果数量（1–50）和页码。
应用场景
该 API 专为以下应用场景设计：
- 参考文献管理器
- 学术搜索与发现工具
- 引文格式转换插件
- 研究诚信与文献综述自动化流程
数据来源与许可
- 数据来源：所有元数据均来自 Crossref（通过
api.crossref.org和doi.org内容协商获取）。 - 许可说明：Crossref 元数据在复用方面无许可限制；引文格式化功能由
doi.org内置的 Citation Style Language（CSL）渲染提供支持。
覆盖范围与限制说明
- 本 API 仅覆盖由 Crossref 注册的 DOI。
- 由其他机构（如 DataCite 或其他非 Crossref 出版商）注册的 DOI 不在支持范围内。
- 元数据质量（如摘要、资助方、ORCID 等）取决于出版商在 Crossref 注册的信息完整程度。
- API 作为实时代理运行，对 Crossref 和 doi.org 上游的可用性没有服务等级协议（SLA）保障，但采用了边缘缓存机制（作品/引文/BibTeX 的 TTL 为 24 小时，搜索结果 TTL 为 6 小时）。
错误处理
API 以 JSON 格式返回错误信息（{ "error": "<code>", "message": "<text>" }），常见错误包括：
| 错误代码 | HTTP 状态码 | 含义 |
|---|---|---|
INVALID_DOI |
400 | DOI 格式无效（须匹配 10.NNNN(N...)/suffix） |
INVALID_QUERY |
400 | 搜索查询长度须在 2–200 字符之间 |
INVALID_LIMIT |
400 | 返回数量仅允许 1–50 |
INVALID_PAGE |
400 | 页码必须是正整数 |
INVALID_STYLE |
400 | 引用样式必须为支持的 7 种之一 |
NOT_FOUND |
404 | DOI 未在 Crossref 中注册 |
UPSTREAM_UNAVAILABLE |
503 | 上游超时、出错或返回无效 JSON |
UPSTREAM_RATE_LIMITED |
429 | 上游限流 |
METHOD_NOT_ALLOWED |
405 | 仅支持 GET 请求 |
QUERY_TOO_LONG |
414 | 查询字符串超过 512 字符 |
数据示例
请求：GET /doi/10.1038/nature12373
响应（简化示例）： json { "doi": "10.1038/nature12373", "title": "Sample Paper Title", "subtitle": "A subtitle", "authors": [ {"given": "Jane", "family": "Doe", "orcid": "http://orcid.org/0000-0001-2345-6789", "affiliation": "MIT"}, {"given": "John", "family": "Smith"} ], "journal": "Nature", "publisher": "Springer Nature", "type": "journal-article", "year": 2013, "month": 8, "volume": "500", "issue": "7461", "pages": "123-129", "issn": ["0028-0836", "1476-4687"], "isbn": [], "abstract": "This is the abstract text.", "url": "https://doi.org/10.1038/nature12373", "cited_by": 542, "references_count": 38, "license": "https://creativecommons.org/licenses/by/4.0/", "subjects": ["Multidisciplinary"], "funders": [{"name": "NSF", "awards": ["12345"]}], "source": "Crossref" }
请求：GET /doi/10.1038/nature12373/citation
响应（示例）： json { "doi": "10.1038/nature12373", "style": "apa", "citation": "Doe, J. (2013). Sample Paper Title. Nature, 500(7461), 123-129." }
定价方案
该 API 提供多个订阅级别：
| 方案 | 月费 |
|---|---|
| BASIC | 免费 |
| PRO | $12.00 |
| ULTRA | $39.00 |
| MEGA | $99.00 |
数据集维护方
- API 创建者：AUtomator labs
- 分类：科学（Science）
