Developer API

Turkic Language Translation API

Access translations for 9 Turkic languages via a simple JSON API. 300 free requests/month — no credit card, no signup required.

9 languages

JSON / REST

No signup (free tier)

300 free req/month

CORS enabled

Quick Start — no API key needed

curl "https://turkiclex.com/functions/v1/public-api/translate?word=hello&lang=UZ"

Response:

{
  "word": "hello",
  "lang": "UZ",
  "translation": {
    "text": "salom",
    "alternatives": ["assalomu alaykum"],
    "quality_score": 0.95
  },
  "usage": { "remaining": 298, "limit": 300 }
}

Base URL

https://turkiclex.com/functions/v1/public-api

All endpoints accept GET requests. Responses are JSON with Content-Type: application/json. CORS is enabled for all origins.

Authentication

Free tier — no authentication

Call any free endpoint without any header. Usage is tracked by IP address. Limit: 300 requests/month, 50 requests/day.

Paid tier — API key

Coming soon

Pass your key in the x-api-key header.

curl "https://turkiclex.com/functions/v1/public-api/translate?word=hello&lang=TR" \
  -H "x-api-key: YOUR_API_KEY"

Endpoint Reference

GET

/translate

Translate a word into one or all Turkic languages.

Query Parameters

Name	Type	Required	Description
word	string	Yes	The English word to translate.
lang	string	No	Target language code (e.g. UZ). Omit to return all languages.
all	boolean	No	Set to true to return translations for every supported language.

Headers

Name	Required	Description
x-api-key	No	Paid-tier API key. Omit for free anonymous access.

Examples

curl "https://turkiclex.com/functions/v1/public-api/translate?word=hello&lang=UZ"

Response

{
  "word": "hello",
  "lang": "UZ",
  "translation": {
    "text": "salom",
    "alternatives": ["assalomu alaykum"],
    "quality_score": 0.95
  },
  "usage": {
    "remaining": 298,
    "limit": 300
  }
}

GET

/translate?all=true

Return translations in every supported language in a single call.

Query Parameters

Name	Type	Required	Description
word	string	Yes	The English word to translate.
all	boolean	Yes	Must be true.

Headers

Name	Required	Description
x-api-key	No	Paid-tier API key.

Examples

curl "https://turkiclex.com/functions/v1/public-api/translate?word=water&all=true"

Response

{
  "word": "water",
  "translations": {
    "TR": { "text": "su",    "quality_score": 0.99 },
    "UZ": { "text": "suv",   "quality_score": 0.98 },
    "KZ": { "text": "su",    "quality_score": 0.97 },
    "AZ": { "text": "su",    "quality_score": 0.99 },
    "KG": { "text": "suу",   "quality_score": 0.96 },
    "TM": { "text": "suw",   "quality_score": 0.95 },
    "TT": { "text": "su",    "quality_score": 0.97 },
    "UG": { "text": "su",    "quality_score": 0.98 },
    "BA": { "text": "hыу",   "quality_score": 0.94 }
  },
  "usage": { "remaining": 297, "limit": 300 }
}

GET

/examples

Fetch example sentences for a word in a given language. Requires API key.

Query Parameters

Name	Type	Required	Description
word	string	Yes	The English word.
lang	string	Yes	Target language code.

Headers

Name	Required	Description
x-api-key	Yes	Paid-tier API key required for this endpoint.

Examples

curl "https://turkiclex.com/functions/v1/public-api/examples?word=hello&lang=TR" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "word": "hello",
  "lang": "TR",
  "examples": [
    {
      "source": "Hello, how are you?",
      "translation": "Merhaba, nasılsın?",
      "context": "greeting"
    }
  ]
}

Rate Limits

Tier	Monthly limit	Daily limit	Per-minute
Free (anonymous)	300	50	10
Starter	5,000	—	60
Pro	25,000	—	300

When you exceed your limit the API returns 429 Too Many Requests. Check the X-RateLimit-Reset header for your reset timestamp.

Error Codes

Code	Status	Description
200	OK	Request succeeded.
400	Bad Request	Missing or invalid parameters (e.g. no word provided).
401	Unauthorized	API key is missing or invalid for a paid-tier endpoint.
404	Not Found	The word has no translation in the requested language yet.
429	Too Many Requests	Monthly or daily quota exceeded. Check Retry-After header.
500	Internal Server Error	Unexpected server error. Try again in a moment.

Supported Languages

Pricing

Free

$0forever

No signup required. Start in 30 seconds.

300 requests / month
All 9 Turkic languages
Translate endpoint
No API key required
Example sentences
Batch translation
SLA / priority support

Already active — just call the API

Starter

$9/month

For apps and side projects.

5,000 requests / month
All 9 Turkic languages
Translate endpoint
Example sentences
Batch translation (10 words/call)
Email support
SLA

Pro

$29/month

For production applications.

25,000 requests / month
All 9 Turkic languages
All endpoints
Batch translation (unlimited)
Linguistic graph endpoint
99.9% uptime SLA
Priority support

FAQ

Do I need to sign up for the free tier?

No. Just call the API directly — no API key, no email, no registration. Your usage is tracked anonymously by IP address.

What counts as one request?

Each call to /translate or /examples counts as one request, regardless of how many languages are returned when using all=true.

What happens when I hit the 300 request limit?

The API returns a 429 response. Your quota resets at the start of each calendar month (UTC).

Is CORS enabled?

Yes. All endpoints include Access-Control-Allow-Origin: * so you can call the API directly from browser JavaScript.

What is quality_score?

A 0–1 float representing translation confidence. It combines AI confidence, community votes, and validation status. Scores above 0.9 are considered high quality.

Can I use this commercially?

Yes. The free tier can be used for commercial projects within the rate limits. For higher volume, paid plans are coming soon.

Ready to build with Turkic languages?