# immit Developer API

> immit's English and Japanese dictionary over one REST API, with a free tier and a key in a minute.

## Docs

- [Getting started](https://immit.co/developers/docs/getting-started): From nothing to the first JSON in five minutes. An immit account, a key, a curl, an entry.
- [Authentication](https://immit.co/developers/docs/authentication): One header, one key, one account. What a key is, where it may live and how it is refused.
- [Rate limits and quotas](https://immit.co/developers/docs/rate-limits): Two limits on two clocks, both the account's. The headers that say where you stand, and what a 429 looks like.
- [Errors](https://immit.co/developers/docs/errors): One shape for every error, with a code to branch on and a detail for your logs.
- [Versioning](https://immit.co/developers/docs/versioning): Additive only under /v1. What that promise covers and what a breaking change would look like.
- [The entry shape](https://immit.co/developers/docs/entry-shape): Field by field. One shape for English and Japanese; what a language does not have is null or empty, never missing.
- [Two languages, one shape](https://immit.co/developers/docs/languages): What is null for which language and why. A client renders both with one component because the fields are the same.
- [Ranking and paging](https://immit.co/developers/docs/ranking): How search orders its results, how the cursor works, and what the frequency rank means.
- [Audio](https://immit.co/developers/docs/audio): Every pronunciation row carries playable sound. Where it comes from and how to use it.
- [The MCP server (planned)](https://immit.co/developers/docs/mcp): The same two lookups as Model Context Protocol tools, so an agent builder adds the dictionary with one line of config and one key.
- [llms.txt and OpenAPI](https://immit.co/developers/docs/llms): The whole reference in one fetch, and the spec a code generator reads.

## Reference

- [GET /v1/dictionary/{lang}/entries](https://immit.co/developers/reference/search-entries): Search entries
- [GET /v1/dictionary/{lang}/entries/{headword}](https://immit.co/developers/reference/get-entry): Get an entry
- [GET /v1/me](https://immit.co/developers/reference/me): The calling key

## Files

- [openapi.yaml](https://immit.co/developers/openapi.yaml): The v1 OpenAPI 3.0 spec the reference is generated from
- [llms-full.txt](https://immit.co/developers/llms-full.txt): The docs and the reference with real examples in one file
- [llms.txt](https://immit.co/developers/llms.txt): This map
- [Changelog](https://immit.co/developers/changelog): What changed under /v1, newest first
- [Pricing](https://immit.co/developers/pricing): The tiers: a daily quota and a burst rate per account
- [API terms](https://immit.co/developers/terms): The license the data is served under