DOAJ API Guide

DOAJ API Guide

Overview

The Directory of Open Access Journals (DOAJ) is a community-curated online directory that indexes and provides access to high quality, open access, peer-reviewed journals. Founded in 2003, DOAJ currently indexes over 20,000 journals and 9 million articles from 130 countries, covering all areas of science, technology, medicine, social sciences, arts, and humanities.

DOAJ serves as a quality filter for open access publishing. Journals must meet strict criteria to be included, including editorial review, transparent policies, and adherence to open access principles. This makes DOAJ particularly valuable for researchers who need to verify whether a journal is a legitimate open access outlet, librarians curating discovery systems, and developers building tools that surface OA content.

The DOAJ API provides free, unauthenticated access to search and retrieve journal and article metadata. All data is available under a CC BY-SA license. The API returns JSON and supports Elasticsearch-style queries for advanced filtering.

Authentication

No authentication required. The DOAJ API is fully open and free to use. No API key, registration, or email is needed. There are no published rate limits, but users should be respectful and avoid sending excessive concurrent requests. For bulk data access, DOAJ provides data dumps at https://doaj.org/docs/public-data-dump/.

Core Endpoints

Article Search: Find Open Access Articles

• URL: GET https://doaj.org/api/search/articles/{search_query}
• Parameters:

  Param	Type	Required	Description
  search_query	string	Yes	Search query (URL path parameter, supports field-specific search)
  page	integer	No	Page number (default: 1)
  pageSize	integer	No	Results per page (default: 10, max: 100)
  sort	string	No	Sort field (e.g., created_date:desc)

• Example:

  curl "https://doaj.org/api/search/articles/climate+change?page=1&pageSize=10"
  

• Response: JSON with total count and results array. Each result contains bibjson with title, abstract, author, journal.title, identifier (DOI, ISSN), link (full-text URL), year, month, keywords, and subject.

Journal Search: Find Open Access Journals

• URL: GET https://doaj.org/api/search/journals/{search_query}
• Parameters:

  Param	Type	Required	Description
  search_query	string	Yes	Journal search query
  page	integer	No	Page number (default: 1)