Transliterator API

Konwertuj ponad 27 systemów pisma na łaciński natychmiast - idealne do slugów SEO, znormalizowanego wyszukiwania i potoków danych.

API FAQ
Pobierz klucz API Kup kredyty
Co możesz zrobić?
Normalizacja wyszukiwania

Indeksuj i przeszukuj treści wieloskryptowe jako całość.

Slugi SEO

Generuj czyste wielojęzyczne adresy URL natychmiast.

Potoki danych

Zasilaj katalogi lub przepływy NLP spójnym tekstem.

Wypróbuj na żywo
99.9 % Dostępność
12.5ms Odpowiedź
20 req/s
0.009 Kredyty / żądanie ⓘ

Transliterator API 


POST https://api.yeb.to/v1/transliterator
Parametr Typ Wymagany Opis
api_key string tak Auth key
lang string opcjonalny ISO code of input script
text string tak Input text (max. 255 chars)
type string opcjonalny plain | slug | snake | camel | capital | upper | lower
delimiter string opcjonalny Custom delimiter for slug/snake

Przykłady żądań

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

Integracje 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
}

Kody odpowiedzi

KodOpis
200 SuccessŻądanie przetworzone OK.
400 Bad RequestWalidacja danych wejściowych nie powiodła się.
401 UnauthorizedBrakujący / nieprawidłowy klucz API.
403 ForbiddenKlucz nieaktywny lub niedozwolony.
429 Rate LimitZbyt wiele żądań.
500 Server ErrorNieoczekiwany błąd.

transliterate

transliterator 0.0090 credits

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 — Practical Guide
    

    

      A hands-on guide to Transliterator API: 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 mar 2026, 10:41
      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
      


      

        

          
ParamRequiredWhat to pass in practiceWhy 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
      

      

        

          
TypeUse it forNotes

          
          
plainReadable Latin outputNo case/spacing changes; punctuation trimmed.

          
slugSEO URLsLowercase, spaces → delimiter, trims duplicates: пример тест → primer-test.

          
snakeDatabase keys, filenamesLowercase + _ (or custom delimiter).

          
camelCode identifiersprimerTest style.

          
capitalUI labelsPrimer Test title case.

          
upperSorting / normalizationAll caps.

          
lowerCase-insensitive searchAll 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
      

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


      
      
      

        #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.
          

        

      

    

  



                    



        
                            

                

                    

                        
                        Często zadawane pytania
                    

                

                

                    

                        

                                                                                                

    

        
    


    

        

            Obsługujemy pełną transliterację dla ponad 25 systemów pisma, w tym arabskiego, cyrylicy, greckiego, hebrajskiego i CJK. Potrzebujesz innego języka? Skontaktuj się z nami.
        

    



                                                                    

    

        
    


    

        

            Używamy standardów ISO lub de facto webowych. Dokładność wynosi zazwyczaj 95%+ dla powszechnego słownictwa.
        

    



                                                                                                                                                            

    

        
    


    

        

            Tak. Każde żądanie, nawet te zakończone błędem, zużywa kredyty. Twoje kredyty są powiązane z liczbą żądań, niezależnie od sukcesu lub niepowodzenia. Jeśli błąd jest wyraźnie spowodowany problemem platformy po naszej stronie, przywrócimy dotknięte kredyty (bez zwrotów gotówkowych).
        

    



                                                                    

    

        
    


    

        

            Skontaktuj się z nami pod adresem [email protected]. Traktujemy opinie poważnie—jeśli Twój raport o błędzie lub prośba o funkcję jest sensowna, możemy szybko naprawić lub ulepszyć API i przyznać Ci 50 darmowych kredytów w podziękowaniu.
        

    



                                                                    

    

        
    


    

        

            Zależy od API, a czasem nawet od endpointu. Niektóre endpointy korzystają z danych ze źródeł zewnętrznych, które mogą mieć surowsze limity. Wprowadzamy też limity, aby zapobiec nadużyciom i utrzymać stabilność platformy. Sprawdź dokumentację, aby poznać konkretny limit dla każdego endpointu.
        

    



                                                                    

    

        
    


    

        

            Działamy w systemie kredytowym. Kredyty to przedpłacone, bezzwrotne jednostki, które wydajesz na wywołania API i narzędzia. Kredyty są zużywane metodą FIFO (najstarsze najpierw) i są ważne przez 12 miesięcy od daty zakupu. Panel wyświetla datę każdego zakupu i jego wygaśnięcia.
        

    



                                                                    

    

        
    


    

        

            Tak. Wszystkie zakupione kredyty (w tym ułamkowe salda) są ważne przez 12 miesięcy od zakupu. Niewykorzystane kredyty automatycznie wygasają i są trwale usuwane na koniec okresu ważności. Wygasłych kredytów nie można przywrócić ani zamienić na gotówkę lub inną wartość. Reguła przejściowa: kredyty zakupione przed 22 wrz. 2025 traktowane są jako zakupione 22 wrz. 2025 i wygasają 22 wrz. 2026 (chyba że przy zakupie podano wcześniejszą datę wygaśnięcia).
        

    



                                                                    

    

        
    


    

        

            Tak—w ramach okresu ważności. Niewykorzystane kredyty pozostają dostępne i są przenoszone z miesiąca na miesiąc, aż wygasną 12 miesięcy po zakupie.
        

    



                                                                    

    

        
    


    

        

            Kredyty są bezzwrotne. Kupuj tylko to, czego potrzebujesz—zawsze możesz doładować później. Jeśli błąd platformy spowoduje nieudane obciążenie, możemy przywrócić dotknięte kredyty po zbadaniu sprawy. Bez zwrotów gotówkowych.
        

    



                                                                    

    

        
    


    

        

            Ceny są ustalane w kredytach, nie w dolarach. Każdy endpoint ma własną cenę—zobacz odznakę „Kredyty / żądanie" powyżej. Zawsze będziesz dokładnie wiedzieć, ile wydajesz.
        

    



                                                                                    

                    

                

            

        
                
            ← Powrót do API