public-data-apis · prepared

Directory of Open Access Journals API boundary

Documented public search, record access, authenticated application routes and bounded query rules from DOAJ's guide and linked v4 specification. This review does not verify live API execution, an account's permissions, metadata validity or reuse rights.

version 1.0.1freshness currentobserved 2026-09-06T19:20:01.480Z

resource.public-data.doaj-api
sha256:6b195b53da0781fd65044618b747f9f43cc370cf8d8a42c28507474f05e506f2

Open canonical machine JSON →

Evidence-backed facts

  1. Public GET searches use /api/search/articles/{search_query} and /api/search/journals/{search_query}. Journal reads use /api/journals/{journal_id}; article reads use /api/articles/{article_id}. Not every field is present in every record. informative
  2. Article GET accepts an optional api_key, which may also expose the caller's own non-public records. Application reads and searches require api_key, as do documented article/application writes. Public search grants none of those permissions. informative
  3. Search requires a path search_query and accepts page, pageSize and sort. pageSize defaults to 10 and is limited to 100. The guide's sort=field[:direction] supports asc or desc and defaults to asc. informative
  4. The guide documents two requests per second across API routes, not measured throughput. Wildcard, regular-expression, fuzzy and proximity searches are disabled. The .exact suffix is for full string field names, not short-name substitutions. informative