API for Developers

Introduction

Welcome to the From-To.io API documentation. This API provides access to various resources related to our translator platform.

The API uses JSON for all requests and responses, and follows RESTful principles. All endpoints are accessible via HTTPS only.

Authentication

To use the API, you need an API key. API keys can be generated from your profile settings.

Get Your API Key

Generate API keys from your profile to start using the API. API access is available on Pro and higher plans.

Using Your API Key

Include your API key in the Authorization header:

Authorization: Bearer ft_YOUR_API_KEY

Or as a query parameter:

https://api.from-to.uz/api/v1/external/translate?api_token=ft_YOUR_API_KEY

Rate Limits

API requests are rate limited based on your subscription plan:

  • Pro Plan: 1,000 requests/day, 30,000 requests/month
  • Business Plan: 5,000 requests/day, 150,000 requests/month
  • Enterprise: Custom limits available

Error Responses

{
  "success": false,
  "message": "API token required"
}

Common error codes: 401 (unauthorized), 429 (rate limit exceeded), 403 (API access not available)

Translate

Translate entered text

This endpoint returns translation from one language to another

Request

POST https://api.from-to.uz/api/v1/external/translate

Headers

Authorization: Bearer ft_YOUR_API_KEY
Content-Type: application/json

Body

{
  "body": {
    "lang_from": "uzn_Latn",
    "lang_to": "kaa_Latn",
    "resultCase": "latin",
    "text": "Salom. Bugun qor juda ko'p yog'di"
  }
}

Response

{
  "result": "Сəлем"
}

cURL Example

curl -X POST https://api.from-to.uz/api/v1/external/translate \
  -H "Authorization: Bearer ft_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"body": {"lang_from": "uzn_Latn", "lang_to": "kaa_Latn", "resultCase": "latn", "text": "Salom. Bugun qor juda ko'p yog'di"}}'

Latin-Kirill Transliterate

Transliterate entered text

This endpoint is used to convert Latin letters to Cyrillic and vice versa.

Request

POST https://api.from-to.uz/api/v1/external/transliterate

Headers

Authorization: Bearer ft_YOUR_API_KEY
Content-Type: application/json

Body

{
  "body": {
    "lang_from": "uz_latin",
    "lang_to": "uz_cyrillic",
    "text": "Manzil qanchalik uzoq bo'lishining ahamiyati yo'q"
  }
}

Available script codes:

Uzbek: uz_latin, uz_cyrillic
Karakalpak: kaa_latin, kaa_cyrillic
Kazakh: kz_latin, kz_cyrillic
Turkmen: tm_latin, tm_cyrillic
Azerbaijani: az_latin, az_cyrillic
Tajik: tj_latin, tj_cyrillic
Mongolian: mn_latin, mn_cyrillic
Serbian/Bosnian: rs_latin, rs_cyrillic

Response

{
    "result": "салом"
}

Translation Languages List

Translation Languages List

This endpoint returned all available languages lists.

Request

POST https://cdn.from-to.uz/languages.json

Response

[
    {
        "name": "English",
        "code": "eng_Latn"
    },
    {
        "name": "Russian",
        "code": "rus_Cyrl"
    },
    {
        "name": "Uzbek",
        "code": "uzn_Latn"
    },
    {
        "name": "Karakalpak",
        "code": "kaa"
    },
    ...
]