用途:在论文被付费墙阻挡时,用 Unpaywall 查找合法可用的开放获取版本,避免直接放弃全文。
主要能力:通过 DOI 查询 Unpaywall REST API,返回 is_oa 判断是否有开放获取版本、best_oa_location 推荐最佳来源(含 PDF 链接、版本类型、许可证、宿主类型)以及 oa_locations 全部已知开放获取位置。版本类型包括 publishedVersion(正式发表版)、acceptedVersion(作者接受稿)和 submittedVersion(预印本)。常见来源有 Europe PMC、PubMed Central、机构仓储、bioRxiv、medRxiv、arXiv、ChemRxiv 及开放获取期刊。
使用方式:基本请求为 curl "https://api.unpaywall.org/v2/DOI?email=YOUR_EMAIL",DOI 需 URL 编码,email 为必填且应使用用户真实邮箱,不要用占位邮箱。解析响应时优先取 best_oa_location.url_for_pdf,缺失时回退到 url;也可遍历 oa_locations 寻找替代来源。下载可用 curl -L -o paper.pdf "$pdf_url"。建议在 DOI 解析遇付费墙后调用,并优先选择 publishedVersion。
适用场景:DOI 解析遇付费墙、PubMed Central 无全文、出版商站点需订阅、需要高相关论文(评分≥7)全文时。可集成到全文获取流程:先试 PMC,再试 DOI,遇付费墙后查 Unpaywall,最后尝试预印本。
限制与注意:免费层每天约 100,000 次请求,无硬性速率限制但应尊重服务,建议请求间加 100ms 延迟并缓存结果,只查真正需要的论文。DOI 未找到时返回错误信息;网络错误可指数退避重试最多 3 次。若 is_oa 为 false 或无 best_oa_location,则无开放获取版本,可提示机构访问、联系作者或仅用摘要。不要忽略版本类型,也不要只查单一来源。
其他事实:官方未提供具体收费与价格信息,暂未提供。