Transliterator API

Tukar 27+ skrip ke Latin serta-merta - sesuai untuk slug SEO, carian ternormal dan saluran data.

API FAQ
Dapatkan Kunci API Beli Kredit
Apa yang boleh anda lakukan?
Normalisasi carian

Indeks dan cari kandungan pelbagai skrip secara bersepadu.

Slug SEO

Jana URL berbilang bahasa yang bersih dengan segera.

Saluran data

Suapkan katalog atau aliran kerja NLP dengan teks konsisten.

Cuba Langsung
99.9 % Masa Aktif
12.5ms Respons
20 req/s
0.009 Kredit / permintaan ⓘ

Transliterator API 


POST https://api.yeb.to/v1/transliterator
Parameter Jenis Wajib Penerangan
api_key string ya Auth key
lang string pilihan ISO code of input script
text string ya Input text (max. 255 chars)
type string pilihan plain | slug | snake | camel | capital | upper | lower
delimiter string pilihan Custom delimiter for slug/snake

Contoh Permintaan

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

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

Kod Respons

KodPenerangan
200 SuccessPermintaan diproses OK.
400 Bad RequestPengesahan input gagal.
401 UnauthorizedKunci API hilang / salah.
403 ForbiddenKunci tidak aktif atau tidak dibenarkan.
429 Rate LimitTerlalu banyak permintaan.
500 Server ErrorKegagalan tidak dijangka.

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 Mac 2026, 09:59
      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.
          

        

      

    

  



                    



        
                            

                

                    

                        
                        Soalan Lazim
                    

                

                

                    

                        

                                                                                                

    

        
    


    

        

            Kami menyokong transliterasi penuh untuk 25+ skrip termasuk Arab, Sirilik, Yunani, Ibrani dan CJK. Perlukan bahasa lain? Hubungi kami.
        

    



                                                                    

    

        
    


    

        

            Kami menggunakan standard ISO atau de facto web. Ketepatan biasanya 95%+ untuk perbendaharaan kata biasa.
        

    



                                                                                                                                                            

    

        
    


    

        

            Ya. Setiap permintaan, termasuk yang menghasilkan ralat, menggunakan kredit. Kredit anda terikat kepada bilangan permintaan, tanpa mengira kejayaan atau kegagalan. Jika ralat jelas disebabkan oleh masalah platform di pihak kami, kami akan memulihkan kredit yang terjejas (tiada bayaran balik tunai).
        

    



                                                                    

    

        
    


    

        

            Hubungi kami di [email protected]. Kami mengambil maklum balas dengan serius—jika laporan pepijat atau permintaan ciri anda bermakna, kami boleh memperbaiki atau menambah baik API dengan cepat dan memberikan anda 50 kredit percuma sebagai penghargaan.
        

    



                                                                    

    

        
    


    

        

            Ia bergantung pada API dan kadangkala pada endpoint. Sesetengah endpoint menggunakan data dari sumber luaran, yang mungkin mempunyai had yang lebih ketat. Kami juga menguatkuasakan had untuk mencegah penyalahgunaan dan mengekalkan kestabilan platform kami. Semak dokumentasi untuk had khusus setiap endpoint.
        

    



                                                                    

    

        
    


    

        

            Kami beroperasi dengan sistem kredit. Kredit ialah unit prabayar yang tidak boleh dikembalikan yang anda belanjakan untuk panggilan API dan alatan. Kredit digunakan secara FIFO (yang paling lama dahulu) dan sah selama 12 bulan dari tarikh pembelian. Papan pemuka menunjukkan setiap tarikh pembelian dan tamat tempohnya.
        

    



                                                                    

    

        
    


    

        

            Ya. Semua kredit yang dibeli (termasuk baki pecahan) sah selama 12 bulan dari pembelian. Kredit yang tidak digunakan tamat tempoh secara automatik dan dipadam secara kekal pada akhir tempoh sah. Kredit yang tamat tempoh tidak boleh dipulihkan atau ditukar kepada tunai atau nilai lain. Peraturan peralihan: kredit yang dibeli sebelum 22 Sep 2025 dianggap dibeli pada 22 Sep 2025 dan tamat tempoh pada 22 Sep 2026 (melainkan tamat tempoh lebih awal dinyatakan semasa pembelian).
        

    



                                                                    

    

        
    


    

        

            Ya—dalam tempoh sah mereka. Kredit yang tidak digunakan kekal tersedia dan dibawa dari bulan ke bulan sehingga tamat tempoh 12 bulan selepas pembelian.
        

    



                                                                    

    

        
    


    

        

            Kredit adalah tidak boleh dikembalikan. Beli hanya apa yang anda perlukan—anda sentiasa boleh menambah nilai kemudian. Jika ralat platform menyebabkan caj gagal, kami mungkin memulihkan kredit yang terjejas selepas siasatan. Tiada bayaran balik tunai.
        

    



                                                                    

    

        
    


    

        

            Harga ditetapkan dalam kredit, bukan dolar. Setiap endpoint mempunyai kosnya sendiri—lihat lencana "Kredit / permintaan" di atas. Anda akan sentiasa tahu dengan tepat berapa yang anda belanjakan.
        

    



                                                                                    

                    

                

            

        
                
            ← Kembali ke API