Ozituma API reference
A free REST API over the Ozituma dictionary. JSON in, JSON out, one optional X-API-Key header. This is the whole surface: 6 operations the OpenAPI document lists, plus the document itself.
Where to send requests
https://ozituma.com/api/v1
The document also names the local development server. Every route below hangs off this base.
| Environment | URL |
|---|---|
| Production | https://ozituma.com/api/v1 |
| Local development | http://localhost:3000/api/v1 |
Every endpoint, grouped
Dictionary
Search, read and pin entries.
Search the dictionary
Fetch one entry
Deterministic daily entry
Reference data
What the dictionary knows, and how much of it there is.
List languages with real word counts
Corpus statistics
Keys and specification
Get a key; read the machine-readable contract.
Create an API key
The machine-readable contract
How the API behaves
The X-API-Key header, the Bearer alternative, and what happens without a key.
Rate limitsThe per-key daily quotas, the per-IP key throttle, and the headers that report them.
ErrorsThe error body every failure shares, and the codes the API returns.
Paginationpage and limit, the response envelope, and the Content-Range header.
Licensing and attributionWhat you may do with the data, and the attribution to carry.
OpenAPI specification
The machine-readable schema is served at /api/v1/openapi.json — OpenAPI 3.1.0, 6 documented operations. Point code generators and Postman at it. It needs no key.
Fair use
Use the dictionary freely, for anything, commercially included. All we ask in return is that whatever you publish says it came from Ozituma. Bulk downloads are allowed on the Team and Institution plans; if you need the whole dictionary rather than API access, tell us what you are building and we will export it for you.