Open API for developers

At a glance

• Base address: https://www.ulutasmedicaljournal.com/api/v1
• Read-only: only GET requests; nothing can be changed through the API.
• Limit: 60 requests per minute per client. Beyond it the answer is HTTP 429 with a Retry-After header.
• Only published articles. Drafts, retracted and withdrawn articles are never listed.
• Each article carries its licence (for example CC BY 4.0). Reuse follows that licence; please cite the article and its DOI.
• No personal data beyond what the article page shows: author names, ORCID iDs and affiliations; never e-mail addresses or reviewer information.
• Machine-readable description (OpenAPI 3.1): https://www.ulutasmedicaljournal.com/api/v1/openapi.json

List articles

GET https://www.ulutasmedicaljournal.com/api/v1/articles?page=1&per_page=20

Newest first. per_page is 20 by default and at most 100.

• q — words in the title or subject
• year — publication year
• doi — one article by DOI

The answer has data (the articles), links (first, last, previous and next page) and meta (current page, total).

One article

GET https://www.ulutasmedicaljournal.com/api/v1/articles/{mno}

mno is the number in the article address. Fields: title, abstract, authors, DOI, page address, PDF address, keywords, type, language, dates, volume, issue, pages and licence. Online First articles have no volume, issue or pages yet.

Example

curl -s "https://www.ulutasmedicaljournal.com/api/v1/articles?q=diabetes&per_page=5"

MCP server for AI assistants

A small open-source Model Context Protocol server lets AI assistants search and read the journal through this API. It needs no key, reads nothing else and changes nothing.

Download the MCP server (one file, Node.js 18 or newer)

{ "mcpServers": { "umj": { "command": "node", "args": ["/path/to/umj-mcp.mjs"] } } }