Skip to content

Commit 8c7bea5

Browse files
committed
Add DOAJ API documentation and technical details to sources.md
1 parent 37e3855 commit 8c7bea5

1 file changed

Lines changed: 27 additions & 0 deletions

File tree

sources.md

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,33 @@ tool paths.
4242
[prioritized-tool-urls]: data/prioritized-tool-urls.txt
4343

4444

45+
## DOAJ (Directory of Open Access Journals)
46+
47+
**Description:** DOAJ is a comprehensive directory of open access journals that provides metadata about journals and their licensing policies. The API allows access to journal-level information including Creative Commons license support, publication years, and publisher details.
48+
49+
**Official API Documentation:**
50+
- [DOAJ API Documentation](https://doaj.org/api/docs)
51+
- [DOAJ API v4 Reference](https://doaj.org/api/v4/docs)
52+
- [Base URL](https://doaj.org/api/v4/)
53+
54+
**API Information:**
55+
- No API key required
56+
- Rate limiting: Reasonable use policy (no specific limits documented)
57+
- Data format: JSON
58+
- Pagination: 100 results per page (configurable up to 100)
59+
- Search filters: Supports filtering by license type, publication year, subject, etc.
60+
- License detection: Extracts CC license information from journal metadata
61+
62+
**Technical Details:**
63+
- Fetches journals that support Creative Commons licensing
64+
- Aggregates license counts by type (CC BY, CC BY-SA, CC BY-NC, etc.)
65+
- Tracks license adoption by publication year
66+
- Handles journals with multiple supported license types
67+
- Generates provenance metadata for data lineage
68+
69+
**Script:** [`scripts/1-fetch/doaj_fetch.py`](scripts/1-fetch/doaj_fetch.py)
70+
71+
4572
## Europeana
4673

4774
**Description:**

0 commit comments

Comments
 (0)