✛ Translation
Placeholder-Safe Localiser
Send a string file, get it back translated in the same format. Placeholders, HTML tags and ICU messages are masked before translation and checked after; plural forms are filled for each target language's CLDR categories (Romanian gets one/few/other, Polish one/few/many/other). Keys that fail validation are retried, then left in the source language and not charged.
Translate an i18next JSON, ARB, iOS .strings, Android strings.xml, Rails YAML, XLIFF 2 or gettext PO file into up to 10 languages, with a validation report.
POST/v1/localise
Try it ↓- Price
- $0.0006 per string × language · REST and MCP
- RapidAPI
- $0.00075 per string × language · listing at launch
- Per call
- up to 400 strings × languages · at most $0.24
- Returns
- application/json
- MCP tool
- localiser_localise
Request body
| Field | Type | Description |
|---|---|---|
| formatrequired | i18next-json arb ios-strings android-xml rails-yaml xliff2 po | Format of content; the translated files come back in the same format. |
| contentrequired | string | The source file as UTF-8 text, at most 512 KB. |
| targetsrequired | string[] | Target languages as BCP 47 tags, 1 to 10, e.g. ["ro", "pl", "de"]. |
| source | string | Source language as a BCP 47 tag. |
| tone | formal | informal | Register of the translation. |
| context | object | Optional hints: what the product is, and character limits per key. |
example
curl https://readymadeapi.com/v1/localise \
-H "Authorization: Bearer $READYMADE_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "{\n \"welcome\": \"Welcome back, <b>{{name}}</b>!\",\n \"messages_one\": \"You have {{count}} new message\",\n \"messages_other\": \"You have {{count}} new messages\"\n}",
"format": "i18next-json",
"targets": [
"ro",
"pl"
],
"tone": "informal"
}'What comes back
{
"files": [
{
"lang": "ro",
"content": "{\n \"welcome\": \"Bine ai revenit, <b>{{name}}</b>!\",\n \"messages_one\": \"Ai {{count}} mesaj nou\",\n \"messages_few\": \"Ai {{count}} mesaje noi\",\n \"messages_other\": \"Ai {{count}} de mesaje noi\"\n}"
},
{
"lang": "pl",
"content": "{\n \"welcome\": \"Witaj ponownie, <b>{{name}}</b>!\",\n \"messages_one\": \"Masz {{count}} nową wiadomość\",\n \"messages_few\": \"Masz {{count}} nowe wiadomości\",\n \"messages_many\": \"Masz {{count}} nowych wiadomości\",\n \"messages_other\": \"Masz {{count}} nowa wiadomość\"\n}"
}
],
"report": {
"keys": 2,
"translatable": 2,
"translated": {
"ro": 2,
"pl": 2
},
"failed_keys": {
"ro": [],
"pl": []
},
"length_overflows": {
"ro": [],
"pl": []
},
"plural_categories": {
"ro": ["one", "few", "other"],
"pl": ["one", "few", "many", "other"]
},
"retried_keys": 1,
"placeholders_preserved": true,
"icu_valid": true,
"target_errors": {}
}
}Use it from an agent
Every endpoint above is also an MCP tool. Add the server to Claude, Cursor or any MCP client and the tools appear with their prices; calls draw from the same credit.
mcp config
{
"mcpServers": {
"readymade": {
"type": "http",
"url": "https://readymadeapi.com/mcp",
"headers": {
"Authorization": "Bearer ${READYMADE_KEY}"
}
}
}
}