Add Directory of Open Access Journal (DOAJ) as new source
还没有人认领这个 Issue。
评估
调研方向
从现有的数据源集成和 https://doaj.org/api/docs 上的 DOAJ API 文档开始,然后检查 journals 端点、分页、速率限制以及列出的 BibJSON 字段。完成的标准是:DOAJ 期刊元数据已被导入,并且文档中说明的许可和历史数据限制得到了清晰的表示。
由索引模型根据 Issue 内容生成。
描述
Problem Statement
The quantifying commons project currently lacks coverage of open access academic journals, which represent a significant portion of the scholarly commons. DOAJ provides comprehensive metadata on over 22,000 open access journals with detailed Creative Commons licensing information. DOAJ provides rich metadata including license types, publisher information, country codes, subject classifications, and open access start dates, making it ideal for detailed commons analysis.
Relevant API Links
- Api Version: v4
- Base URL: https://doaj.org/api/
- Journals Endpoint: https://doaj.org/api/v4/search/journals/
- Articles Endpoint: https://doaj.org/api/v4/search/articles/
- API Documentation: https://doaj.org/api/docs
Useful Search Fields
- License Information:
bibjson.license[].type - Publisher Details:
bibjson.publisher.name,bibjson.publisher.country - Open Access Start:
bibjson.oa_start - Subject Classification:
bibjson.subject[].code,bibjson.subject[].term - Language:
bibjson.language[] - Last Updated:
last_updated - Created Date:
created_date
API Limitations
- Rate Limits: Current delays 0.5 seconds between requests
- Articles: No direct license information available
- Pagination: Maximum
pageSizeappears to be 100 - Historical Data: License information may reflect current status, not original licensing
- Date Filtering: Only available through
oa_startfield, not license adoption date - Date Back Default: 2002 (to avoid CC license false positives)
Additional context
The DOAJ data source provides journal-level licensing policies rather than individual article licenses. The Creative Commons license information collected represents the default licensing framework that journals have committed to implementing, as declared in their editorial policies and reported to DOAJ (https://doaj.org/apply/guide/).
This data does not reflect the actual licensing status of individual published articles, which may vary from the journal's stated policy due to author choices, publisher agreements, or historical publishing practices predating the journal's current licensing framework.
The quantification derived from DOAJ therefore represents the scope of journals committed to Creative Commons licensing rather than a direct count of CC-licensed articles. This distinction is particularly relevant for temporal analysis, as journals may have adopted CC licensing policies after publishing content under different terms, and individual authors within CC-committed journals may still select more restrictive licensing options where permitted by editorial policy.
The DOAJ API documentation (https://doaj.org/api/docs) confirms that article-level license metadata is not available through their search endpoints.
Users of this data should interpret DOAJ-derived metrics as indicators of institutional commitment to open access licensing within the scholarly publishing ecosystem, rather than as precise measurements of the volume of CC-licensed scholarly content. This limitation does not diminish the value of DOAJ data for understanding trends in open access policy adoption, geographic distribution of OA-committed publishers, and the evolution of scholarly publishing practices toward more open licensing frameworks. Additional context on DOAJ's selection criteria and quality standards can be found in their information for publishers (https://doaj.org/publishers/) and their principles of transparency and best practice (https://doaj.org/bestpractice/).
Implementation
- I would be interested in implementing this feature.
- 主要语言
- Python
- 星标
- 48
- 派生
- 74
- PR 合并指标
- 30 天内没有已合并 PR
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 没有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
creativecommons/quantifying 的其他 Issue
-
🏁 status: ready for work 💻 aspect: code 🛠 goal: fix help wanted 🟩 priority: low
难度 2/5 1-3 小时 新手友好度 78/100
creativecommons/quantifying#300 · 1 条评论 · 1 个 reaction ·
-
GCS free full web search ending 2026-12-31可能重新可做 @TimidRobot 于 153 天前认领,目前没有进行中的 PR。 未关闭🏁 status: ready for work 💻 aspect: code 🔒 staff only 🛠 goal: fix 🟧 priority: high
creativecommons/quantifying#293 · 1 条评论 · 已指派 1 人 ·
-
✨ goal: improvement 🏁 status: ready for work 💻 aspect: code help wanted 🟩 priority: low
难度 4/5 3-5 天 新手友好度 38/100
creativecommons/quantifying#288 ·
-
Add a stacked horizontal bar plot可能重新可做 @oree-xx 于 250 天前认领,目前没有进行中的 PR。 未关闭✨ goal: improvement 💻 aspect: code 🚦 status: awaiting triage 🟩 priority: low
creativecommons/quantifying#274 · 已指派 1 人 ·
-
✨ goal: improvement 🏁 status: ready for work 💻 aspect: code help wanted 🟩 priority: low
难度 5/5 一周以上 新手友好度 35/100
creativecommons/quantifying#249 ·
查看 creativecommons/quantifying 的全部 Issue
相似的 Issue
-
难度 1/5 1 小时以内 新手友好度 88/100
-
难度 1/5 1 小时以内 新手友好度 92/100
QuantEcon/lecture-python-programming#642 ·
维护者通常 1 天内回复
-
area/config area/profiles comp/cli needs-decision P3 sweeper:risk-compatibility type/feature
难度 2/5 1-3 小时 新手友好度 82/100
NousResearch/hermes-agent#133697 ·
维护者通常 1 天内回复
-
enhancement needs-triage
难度 1/5 1 小时以内 新手友好度 72/100
维护者通常 1 天内回复
-
core
难度 2/5 1-3 小时 新手友好度 88/100
vectorize-io/hindsight#5279 ·
维护者通常 1 天内回复