REST API

A translation API that actually preserves your formatting.

One endpoint. Any format. 43 languages. Clean JSON in, translated JSON out — with every Markdown heading, JSON key, and HTML attribute exactly where you left it.

Integrate your CMS publish hook, i18n pipeline, or deployment workflow in minutes.

Get your first translation in under 5 minutes.

curl -X POST https://api.usepolylingo.com/v1/translate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "# Hello World\n\nThis is **bold** text.",
    "format": "markdown",
    "targets": ["es", "fr", "de", "zh", "ar"],
    "model": "standard"
  }'

Every format, handled correctly

PolyLingo detects the format automatically or you can specify it explicitly. Structure is never touched — only the text inside it.

MD

Markdown

Headings, bold, italic, links, code fences, lists — all preserved exactly. Only the text nodes are translated.

# Hello → # Hola
{}

JSON

Keys stay untouched. Only string values are translated. Nested objects and arrays are handled recursively.

"greeting": "Hello" → "greeting": "Hola"
<>

HTML

Tags, attributes, class names, href values — never modified. Only visible text nodes are translated.

<h1>Hello</h1> → <h1>Hola</h1>
Aa

Plain text

Clean translation with no markup concerns. Auto-detected when no format markers are present.

"Hello World" → "Hola Mundo"

Rate limits by plan

PlanRequests / minTokens / month
Free10 req / min100,000 / month
Starter60 req / min600,000 / month
GrowthPopular200 req / min2,500,000 / month
Scale600 req / min8,000,000 / month

All tiers use sliding-window rate limiting keyed to your API key. See full pricing

43 languages and dialects

Full coverage including regional variants — French (Canada), Portuguese (Brazil), Spanish (Mexico), English (UK) — and RTL languages with correct text direction handling in structured formats.

arArabic
RTL
bnBengali
bgBulgarian
hrCroatian
csCzech
daDanish
nlDutch
enEnglish
en-GBEnglish (UK)
fiFinnish
frFrench
fr-CAFrench (Canada)
deGerman
elGreek
heHebrew
RTL
hiHindi
huHungarian
idIndonesian
itItalian
jaJapanese
koKorean
msMalay
noNorwegian
faPersian (Farsi)
RTL
plPolish
ptPortuguese
pt-BRPortuguese (Brazil)
pt-PTPortuguese (Portugal)
roRomanian
ruRussian
skSlovak
esSpanish
es-ESSpanish (Spain)
es-MXSpanish (Mexico)
swSwahili
svSwedish
thThai
trTurkish
ukUkrainian
viVietnamese
zhChinese (Simplified)
zh-TWChinese (Traditional)
zh-HKChinese (Hong Kong)
PolyLingo Translate on GitHub Marketplace

Translate in CI

Automate locale JSON and Markdown from pushes or schedules. Pin UsePolyLingo/translate-action@v1 from the Marketplace.

Official SDKs

Use the typed Node.js or Python clients — same REST surface as the API reference, with helpers for async translation jobs.

Start building for free

50,000 free tokens per month. No credit card. No commitment.

Get your API key
PolyLingo for Developers — A translation API that preserves your formatting | PolyLingo