llms.txt
Compare with other sites' llms.txt files →# Linguin
> Multilingual dictionary, translation and language practice in 120+ languages. Meanings, slang, pronunciation and examples on the web, and the same engine as a public API.
Linguin is the multilingual dictionary that tells you what words actually mean, in 120+
languages, and lets you practice using them in real conversation. Every lookup returns a
definition with examples, synonyms, etymology, usage notes, common mistakes and an FAQ.
The same engine translates and localizes text through a public API.
Guiding idea: *words have no translations, they have meanings.* Linguin explains what a
word means in context rather than swapping it for the nearest equivalent.
## Dictionary URLs
- `/{term}` - English entry (e.g. `/serendipity`, `/rizz`). Case sensitive, so `/NASA` and `/nasa` are different entries.
- `/{lang}/{term}` - entry in that language, written in its own script (e.g. `/pt/saudade`, `/ru/слово`, `/ja/木漏れ日`).
- `/{lang}-{lang}/{term}` - cross-language entry, source to target (e.g. `/fr-en/bonjour`, `/es-en/habibi`).
Language codes are ISO 639-1. Older Latin-transliterated paths for non-Latin entries 301
to the native-script URL.
## Pages
- [Home](https://linguin.xyz/): live feed of the dictionary, recently reviewed and trending entries.
- [About](https://linguin.xyz/@about): what Linguin is and who builds it.
- [Exercises](https://linguin.xyz/@exercises): vocabulary practice, open to guests and signed-in users. Multiple choice, either pick the meaning of a term or the term for a meaning.
- [Talk](https://linguin.xyz/@talk): AI conversation practice with feedback on what you said.
- [Articles](https://linguin.xyz/@articles): editorial posts on language, learning and usage.
- [Updates](https://linguin.xyz/@news): product and API release notes.
- [Pricing](https://linguin.xyz/@pricing): learner subscription plans.
- [Sitemap](https://linguin.xyz/sitemap.xml): every published entry and page.
## API
Base URL `https://api.linguin.xyz`. Every method is its own path and takes a POST with a
JSON body, a bearer key and an `API-Version` header. Calls answer inline by default, or
return a `req_id` immediately and POST the result to a `webhook` if one is passed.
```
POST https://api.linguin.xyz/lookup
Authorization: Bearer YOUR_API_KEY
API-Version: 2026-06-01
Content-Type: application/json
{ "text": "bonjour", "lang": "fr", "locale": "en", "mode": "fast" }
```
Keys are per account: a sandbox key for evaluation, a live key on a paid plan. Billing is
prepaid, deducted the moment a result is delivered, and every response carries a `billed`
object with the exact charge.
### Methods
- `POST /lookup` - the dictionary entry for a term. `mode: "fast"` returns just the definition, `deep` the complete entry.
- `POST /reverse` - describe a meaning, get the words that fit. `mode: "terms"` returns bare terms, `fast` or `deep` expands each match to a full entry.
- `POST /translate` - translate text. One call, no tiers, three independent toggles that compose in any combination: `live: true` searches the source's idioms and slang and resolves their senses before translating, `proofread: true` checks the finished wording against how often people really write it and replaces what does not hold up, `humanizer: true` rewrites the result to read as human writing. `fallback: true` lets a second model complete a pass when the primary is rate-limited, at no change to the bill. The response's `passes` lists the passes that ran, in order, and that is what was charged. `mode` was the retired fast/deep tier: still accepted, does nothing.
- `POST /localize` - bulk translation of a string array for UI and app strings, returned aligned one to one, up to 1000 strings per call. No toggles: a UI label has no source idiom to resolve and no machine cadence to loosen, so `passes` is always the base pass.
- `POST /get` - fetch the result of an earlier call by `req_id`, the recovery path for a missed webhook. Free.
- `POST /balance` - current prepaid balance in USD. Free.
- `POST /topup` - add funds, $25 minimum, returns a Stripe payment link. Free.
- `POST /refund` - send unused balance back to the card. Free.
- `POST /report` - usage breakdown. Free.
- `POST /key` and `POST /revoke` - manage bearer keys. Free.
### Rates
Dictionary bills per call or per match, translation bills per source word. Punctuation
and whitespace are not counted. There are no base or per-call fees on translation.
- lookup fast `$0.003` / call, lookup deep `$0.005` / call
- reverse terms `$0.002` / call, reverse fast `$0.004` / match, reverse deep `$0.006` / match
- translate `$0.05` / 1K words, `live` `+$0.10` / 1K, `proofread` `+$0.10` / 1K, `humanizer` `+$0.05` / 1K (everything on: `$0.30` / 1K)
- localize `$0.05` / 1K words, summed over the whole array, at the base rate
- only a pass that ran bills: a live pass that found nothing to look up, or a proofread that found nothing worth checking, is left out of `passes` and charged as though the toggle were off
- translation requests bill a 30-word minimum, once per call, not per string
- every priced response carries `billed` with the words, the per-1K rate the passes came to, and the cost, so the arithmetic is on the response
### API pages
- [API](https://linguin.xyz/@api): what the API does and who it is for.
- [API docs](https://linguin.xyz/@api/docs): full reference, with sections for [lookup and reverse](https://linguin.xyz/@api/docs#dictionary), [translate](https://linguin.xyz/@api/docs#translate), [localize](https://linguin.xyz/@api/docs#localize), [delivery](https://linguin.xyz/@api/docs#delivery), [errors](https://linguin.xyz/@api/docs#errors) and [billing](https://linguin.xyz/@api/docs#billing).
- [API pricing](https://linguin.xyz/@api/pricing): the rate card and how to get a key.
### SDKs
- [linguin-api on PyPI](https://pypi.org/project/linguin-api/): official Python client.
- [linguin-api on npm](https://www.npmjs.com/package/linguin-api): official JavaScript and TypeScript client.
## Legal
- [Terms](https://linguin.xyz/@legal/terms)
- [Privacy](https://linguin.xyz/@legal/privacy)
- [API Terms](https://linguin.xyz/@legal/api-terms)
- [Data Processing Addendum](https://linguin.xyz/@legal/dpa)
- [Refunds](https://linguin.xyz/@legal/refunds)
## About
- Built by Surfy Ltd, registered in England and Wales, No. 15026168. Founder: Alexander Yermolenko.
- Tagline: "Words have no translations. They have meanings."