Transliterator API — Конвертиране на писменост към латиница | YEB

Мигновено конвертирайте 27+ писмености към латиница, включително арабска, кирилица, гръцка, иврит и CJK. Идеално за SEO slugs, нормализирано индексиране и многоезични data pipelines.

API ЧЗВ

Вземете API ключ Купете кредити

Какво можете да правите?

Нормализация на търсенето

Индексирайте и търсете съдържание с различни писмености като едно.

SEO slugs

Генерирайте чисти многоезични URL-и на момента.

Data pipelines

Подавайте каталози или NLP работни потоци с консистентен текст.

Крайна точка:

Изпробвай на живо

99.9 % Време на работа

12.5ms Отговор

20 req/s

0.009 Кредити / заявка

Transliterator API


POST https://api.yeb.to/v1/transliterator

Параметър	Тип	Задл.	Описание
`api_key`	string	да	Auth key
`lang`	string	опц	ISO code of input script
`text`	string	да	Input text (max. 255 chars)
`type`	string	опц	`plain \| slug \| snake \| camel \| capital \| upper \| lower`
`delimiter`	string	опц	Custom delimiter for slug/snake

Примери за заявки

{
  "api_key":"YOUR_KEY",
  "lang":"bg",
  "text":"пример"
}

{
  "api_key":"YOUR_KEY",
  "lang":"ru",
  "text":"тест транслитерация",
  "type":"slug",
  "delimiter":"_"
}

API интеграции

curl -X POST https://api.yeb.to/v1/transliterator \
  -H "Content-Type: application/json" \
  -d '{"api_key":"YOUR_KEY","lang":"bg","text":"пример","type":"slug","delimiter":"-"}'

Route::post('/transliterate', function () {
    $data = Http::post('https://api.yeb.to/v1/transliterator', [
        'api_key'   => config('services.transliterator.key'),
        'lang'      => 'bg',
        'text'      => 'пример',
        'type'      => 'slug',
        'delimiter' => '-',
    ]);
    return $data->json();
});

$r = Http::post('https://api.yeb.to/v1/transliterator', [
    'api_key'=>'YOUR_KEY','lang'=>'bg','text'=>'пример',
    'type'=>'slug','delimiter'=>'-'
]);
echo $r->json();

fetch('https://api.yeb.to/v1/transliterator', {
  method:'POST',
  headers:{'Content-Type':'application/json'},
  body:JSON.stringify({api_key:'YOUR_KEY',lang:'bg',text:'пример',type:'slug',delimiter:'-'})
}).then(r=>r.json()).then(console.log);

import requests, json
payload = {"api_key":"YOUR_KEY","lang":"bg","text":"пример","type":"slug","delimiter":"-"}
r = requests.post('https://api.yeb.to/v1/transliterator', headers={'Content-Type':'application/json'},
                  data=json.dumps(payload))
print(r.json())

Response Example

{
  "result":"primer","original":"пример","lang":"bg",
  "type":"slug","delimiter":"-","response_code":200,"response_time_ms":37
}

{
  "error":"Invalid API key","code":401,
  "response_code":401,"response_time_ms":12
}

Кодове на отговор

Код	Описание
200 Success	Заявката е обработена успешно.
400 Bad Request	Неуспешна валидация на входните данни.
401 Unauthorized	Липсващ / грешен API ключ.
403 Forbidden	Ключът е неактивен или без достъп.
429 Rate Limit	Твърде много заявки.
500 Server Error	Неочаквана грешка.

transliterate

transliterator 0.0090 credits

Method

URL

Authentication

API Key

Parameters

API Key

query · string · required

Language

query · string

Text

query · string · required

Output type

query · string

Delimiter

query · string

Code Samples

Response

Status: —

Headers

Body

Transliterator API — Конвертиране на писменост към латиница | YEB — Practical Guide

A hands-on guide to Transliterator API — Конвертиране на писменост към латиница | YEB: what it does, when to use each mode, the parameters that actually matter, and how to read responses for SEO slugs, filenames, app identifiers, and more.

Last updated: 07 мар 2026, 12:44 API Version: v1 Burst: 20 req/s Latency: 12.5 ms Cost: 0.009 credits/req

#What Transliterator solves

Send a text in any supported script (e.g., Cyrillic, Greek) and get a clean Latin version and/or a specific formatting: slug, snake_case, camelCase, Capital Case, UPPER, or lower. Perfect for SEO URLs, file/ID normalization, search indexing, and consistent UI labels.

#Endpoint & when to use it

#`POST https://api.yeb.to/v1/transliterator`

Best for: Turning any input into a safe, predictable string for URLs, filenames, database keys, and user-facing titles.
How it works: We transliterate to Latin and then apply the chosen type transform (slug/snake/camel/etc.).
Idempotent: Same input parameters → same output; safe to cache.

#Quick start

# Plain transliteration (auto-detect language)
curl -X POST "https://api.yeb.to/v1/transliterator" \
  -H "Content-Type: application/json" \
  -d '{ "api_key": "YOUR_KEY", "text": "пример" }'

# SEO slug with custom delimiter
curl -X POST "https://api.yeb.to/v1/transliterator" \
  -H "Content-Type: application/json" \
  -d '{ "api_key": "YOUR_KEY", "lang": "ru", "text": "тест транслитерация", "type": "slug", "delimiter": "_" }'

#Parameters that actually matter

Param	Required	What to pass in practice	Why it matters
`api_key`	Yes	Send from server/edge. Don’t expose raw keys in client JS.	Auth & rate limiting.
`text`	Yes	Up to 255 chars; emojis and unsupported symbols are stripped.	Primary content to process.
`lang`	No	ISO code of input script (e.g., `bg`, `ru`, `el`). If omitted, we auto-detect.	Improves accuracy for ambiguous inputs.
`type`	No	`plain \| slug \| snake \| camel \| capital \| upper \| lower`	Choose the output format you need.
`delimiter`	No	Use with slug/snake to set the separator (default `-` for slug, `_` for snake).	Brand-consistent URLs and identifiers.

#Choosing the right `type`

Type	Use it for	Notes
`plain`	Readable Latin output	No case/spacing changes; punctuation trimmed.
`slug`	SEO URLs	Lowercase, spaces → delimiter, trims duplicates: `пример тест` → `primer-test`.
`snake`	Database keys, filenames	Lowercase + `_` (or custom delimiter).
`camel`	Code identifiers	`primerTest` style.
`capital`	UI labels	`Primer Test` title case.
`upper`	Sorting / normalization	All caps.
`lower`	Case-insensitive search	All lowercase.

#Reading & acting on responses

{
  "result": "primer",
  "original": "пример",
  "lang": "bg",
  "type": "slug",
  "delimiter": "-",
  "response_code": 200,
  "response_time_ms": 37
}

result — the processed string; use this directly in URLs/keys/UI.
original — what you sent (after trimming); handy for logs and idempotency checks.
lang — detected or provided language; helps debug unexpected mappings.
type, delimiter — echo of your chosen transform; store alongside to rebuild exactly.

#Typical errors & how to fix

{ "error": "Missing \"text\" parameter", "code": 422 }

{ "error": "Unsupported type: foo", "code": 422 }

422 missing/invalid: Provide text; ensure type ∈ allowed list.
401 invalid key: Rotate your key; send from server/edge only.
413 too long: Keep text ≤ 255 chars; pre-trim user input.

#Troubleshooting & field notes

Unexpected characters: Emojis/symbols are removed; if you need them, store the original separately.
Spaces & dashes: For slug/snake we collapse repeated separators (-- → -).
Custom brand separators: Use delimiter to enforce _, ., or even no delimiter.
Language ambiguity: Specify lang when inputs can be mixed (e.g., Serbian Cyrillic vs. Russian).
Batching: For bulk imports, keep requests ≤ 100 rps and reuse connections; cache deterministic results.

#API Changelog

2025-10-20

Added capital output type and improved auto-detection for mixed scripts. Normalized duplicate separators in slug/snake.

2025-10-12

Custom delimiter now supported for both slug and snake. Minor Cyrillic → Latin mapping refinements (BG/RU).

2025-10-01

Public v1 release with plain, slug, snake, camel, upper, lower. Max input length set to 255 chars.

Често задавани въпроси

Поддържаме пълна транслитерация за 25+ писмености, включително арабска, кирилица, гръцка, иврит и CJK. Нуждаете се от друг език? Свържете се с нас.

Използваме ISO или де факто уеб стандарти. Точността обикновено е 95%+ за често срещания речник.

Да. Всяка заявка, дори тази с грешка, изразходва кредити. Това е така, защото кредитите ви са обвързани с броя заявки, независимо от успеха или неуспеха. Ако грешката е ясно по наша вина, ще възстановим засегнатите кредити (без парично възстановяване).

Свържете се с нас на [email protected]. Приемаме обратната връзка сериозно — ако докладът ви за бъг или заявката за функционалност е смислена, можем да поправим или подобрим API-то бързо и да ви предоставим 50 безплатни кредита като благодарност.

Зависи от API-то и понякога дори от конкретната крайна точка. Някои крайни точки използват данни от външни източници, които може да имат по-строги ограничения. Ние също налагаме лимити за предотвратяване на злоупотреби и поддържане стабилността на платформата. Проверете документацията за конкретния лимит на всяка крайна точка.

Работим на кредитна система. Кредитите са предплатени, невъзстановими единици, които изразходвате за API извиквания и инструменти. Кредитите се изразходват FIFO (първи закупен, първи използван) и са валидни 12 месеца от датата на покупка. Таблото показва датата на покупка и изтичането на всяка покупка.

Да. Всички закупени кредити (включително дробни баланси) са валидни 12 месеца от покупката. Неизползваните кредити автоматично изтичат и се изтриват окончателно в края на периода на валидност. Изтеклите кредити не могат да бъдат възстановени или конвертирани в пари или друга стойност. Преходно правило: кредити, закупени преди 22 септ. 2025 г., се третират като закупени на 22 септ. 2025 г. и изтичат на 22 септ. 2026 г. (освен ако не е посочено по-ранно изтичане при покупката).

Да — в рамките на периода им на валидност. Неизползваните кредити остават налични и се прехвърлят от месец на месец, докато не изтекат 12 месеца след покупката.

Кредитите са невъзстановими. Купувайте само каквото ви трябва — винаги можете да заредите по-късно. Ако грешка от наша страна причини неуспешно таксуване, може да възстановим засегнатите кредити след проверка. Без парично възстановяване.

Цените са определени в кредити, не в долари. Всяка крайна точка посочва собствената си цена — вижте бадж „Кредити / заявка" по-горе. Винаги ще знаете точно колко изразходвате.

← Обратно към API-тата

Вземете кредити за достъп до премиум съдържание и функции

Тип клиент

Държава за фактуриране

Transliterator API — Конвертиране на писменост към латиница | YEB

Какво можете да правите?

Нормализация на търсенето

SEO slugs

Data pipelines

Transliterator API

Примери за заявки

API интеграции

Response Example

Кодове на отговор

transliterate

Parameters

Code Samples

Response

Transliterator API — Конвертиране на писменост към латиница | YEB — Practical Guide

#What Transliterator solves

#Endpoint & when to use it

#POST https://api.yeb.to/v1/transliterator

#Quick start

#Parameters that actually matter

#Choosing the right type

#Reading & acting on responses

#Typical errors & how to fix

#Troubleshooting & field notes

#API Changelog

Често задавани въпроси

Какви езици и писмености се поддържат?

Колко точна е транслитерацията?

Заявки с грешки броят ли се и струват ли кредити?

Открих бъг или искам персонализации в API-тата. Какво да направя?

Какъв е лимитът на заявките?

Как работи плащането и употребата?

Изтичат ли кредитите?

Прехвърлят ли се неизползваните кредити?

Предлагате ли възстановяване на средства?

Колко струва всяко API извикване?

#`POST https://api.yeb.to/v1/transliterator`

#Choosing the right `type`