API Documentation

The AIbit Translator API turns any text, JSON document, or HTML page into 190+ languages with a single REST call. No SDK, no lock-in — if your language can make an HTTP request, you can use it. You'll send your first translation in under two minutes.

The API is distributed through RapidAPI. Create a free account, subscribe to the free tier (1,000 requests/month, no credit card required), and copy your key from the X-RapidAPI-Key field.

Every endpoint is a path under one base URL:

https://aibit-translator.p.rapidapi.com/api/v1/translator

Send a POST to /text with a form-encoded body. This translates “Hello, world” from English to Vietnamese:

curl -X POST "https://aibit-translator.p.rapidapi.com/api/v1/translator/text" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: aibit-translator.p.rapidapi.com" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "from=en" \
  --data-urlencode "to=vi" \
  --data-urlencode "text=Hello, world"

You'll get back a clean JSON response:

{
  "trans": "Xin chào thế giới"
}

Authentication is handled entirely through RapidAPI headers. Attach these two headers to every request — RapidAPI validates your key and forwards the call to AIbit:

X-RapidAPI-Key: YOUR_API_KEY
X-RapidAPI-Host: aibit-translator.p.rapidapi.com
Content-Type: application/x-www-form-urlencoded

Translate a plain string between any two supported languages.

curl -X POST "https://aibit-translator.p.rapidapi.com/api/v1/translator/text" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: aibit-translator.p.rapidapi.com" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "from=en" \
  --data-urlencode "to=vi" \
  --data-urlencode "text=Hello, world"

{
  "trans": "Xin chào thế giới"
}

Set from=auto and the API detects the source language for you. When (and only when) you use auto, the response also includes detection metadata:

{
  "trans": "Xin chào thế giới",
  "source_language_code": "en",
  "source_language": "English",
  "trust_level": 1
}

Translate a JSON document while preserving its exact structure. Only string values are translated — keys, numbers, booleans, arrays, and nesting are returned untouched. Perfect for app localization and CMS content.

Use protected_paths to keep specific values in the original language — IDs, slugs, brand names, enum values. Pass a JSON array of dot-notation paths. Below, meta.id is left as-is while everything else is translated to French:

curl -X POST "https://aibit-translator.p.rapidapi.com/api/v1/translator/json" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: aibit-translator.p.rapidapi.com" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode 'from=en' \
  --data-urlencode 'to=fr' \
  --data-urlencode 'json={"title":"Hello","meta":{"id":"abc-123"}}' \
  --data-urlencode 'protected_paths=["meta.id"]'

{
  "trans": {
    "title": "Bonjour",
    "meta": {
      "id": "abc-123"
    }
  }
}

Translate an HTML fragment or full page tag-safe. All tags, attributes, classes, and inline styles are preserved — only the visible text nodes are translated. Ideal for translating rich content, emails, and rendered pages without breaking markup.

curl -X POST "https://aibit-translator.p.rapidapi.com/api/v1/translator/html" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: aibit-translator.p.rapidapi.com" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode 'from=en' \
  --data-urlencode 'to=es' \
  --data-urlencode 'html=<p>Hello <b>world</b></p>'

{
  "trans": "<p>Hola <b>mundo</b></p>"
}

Identify the language of a piece of text without translating it.

curl -X POST "https://aibit-translator.p.rapidapi.com/api/v1/translator/detect-language" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: aibit-translator.p.rapidapi.com" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode 'text=Bonjour tout le monde'

{
  "trust_level": 1,
  "source_lang_code": "fr",
  "source_lang": "French"
}

Fetch the full list of supported languages and their codes at runtime — useful for populating a language picker.

curl "https://aibit-translator.p.rapidapi.com/api/v1/translator/support-languages" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: aibit-translator.p.rapidapi.com"

[
  { "code": "auto", "language": "Automatic" },
  { "code": "en", "language": "English" },
  { "code": "vi", "language": "Vietnamese" }
]

A complete, copy-paste translation request in four languages. Swap YOUR_API_KEY for your key and you're live.

curl -X POST "https://aibit-translator.p.rapidapi.com/api/v1/translator/text" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: aibit-translator.p.rapidapi.com" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "from=en" \
  --data-urlencode "to=vi" \
  --data-urlencode "text=Hello, world"

AIbit supports the language codes below. Use auto as the source to detect the input language automatically. Search by name or ISO code, and click a row to copy the code.

One API, multiple engines. Set the provider parameter to pick the engine best suited to your language pair. If you omit it, google is used.

The API uses conventional HTTP status codes. 2xx means success; 4xx means a problem with your request; 5xx means a transient server error that is safe to retry.

Rate limits and monthly quotas depend on your RapidAPI subscription. Exceeding your rate limit returns 429 Too Many Requests — back off and retry.