Transliterator API

Konverter øjeblikkeligt 27+ skriftsystemer til latin – perfekt til SEO-slugs, normaliseret søgning og datapipelines.

API FAQ
Hent API-nøgle Køb kreditter
Hvad kan du gøre?
Søgenormalisering

Indekser og søg i indhold med blandede skriftsystemer som ét.

SEO-slugs

Generer rene flersprogede URL'er med det samme.

Datapipelines

Fød kataloger eller NLP-workflows med ensartet tekst.

Prøv live
99.9 % Oppetid
12.5ms Svar
20 req/s
0.009 Kreditter / forespørgsel ⓘ

Transliterator API 


POST https://api.yeb.to/v1/transliterator
Parameter Type Påkrævet Beskrivelse
api_key string ja Auth key
lang string valgfri ISO code of input script
text string ja Input text (max. 255 chars)
type string valgfri plain | slug | snake | camel | capital | upper | lower
delimiter string valgfri Custom delimiter for slug/snake

Forespørgselseksempler

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

API-integrationer

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
}

Svarkoder

KodeBeskrivelse
200 SuccessForespørgsel behandlet OK.
400 Bad RequestInputvalidering mislykkedes.
401 UnauthorizedManglende / forkert API-nøgle.
403 ForbiddenNøgle inaktiv eller ikke tilladt.
429 Rate LimitFor mange forespørgsler.
500 Server ErrorUventet fejl.

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, 07:38
      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.
          

        

      

    

  



                    



        
                            

                

                    

                        
                        Ofte stillede spørgsmål
                    

                

                

                    

                        

                                                                                                

    

        
    


    

        

            Vi understøtter fuld transliterering for 25+ skriftsystemer, herunder arabisk, kyrillisk, græsk, hebraisk og CJK. Har du brug for et andet sprog? Kontakt os.
        

    



                                                                    

    

        
    


    

        

            Vi bruger ISO- eller de facto webstandarder. Nøjagtigheden er typisk 95 %+ for almindeligt ordforråd.
        

    



                                                                                                                                                            

    

        
    


    

        

            Ja. Hver forespørgsel, selv dem der resulterer i fejl, forbruger kreditter. Dine kreditter er bundet til antallet af forespørgsler, uanset succes eller fejl. Hvis fejlen tydeligt skyldes et platformproblem på vores side, gendanner vi de berørte kreditter (ingen kontant refusion).
        

    



                                                                    

    

        
    


    

        

            Kontakt os på [email protected]. Vi tager feedback alvorligt—hvis din fejlrapport eller funktionsanmodning er meningsfuld, kan vi rette eller forbedre API'et hurtigt og give dig 50 gratis kreditter som tak.
        

    



                                                                    

    

        
    


    

        

            Det afhænger af API'et og nogle gange endda af endpointet. Nogle endpoints bruger data fra eksterne kilder, som kan have strengere grænser. Vi håndhæver også grænser for at forhindre misbrug og holde vores platform stabil. Se dokumentationen for den specifikke hastighedsgrænse for hvert endpoint.
        

    



                                                                    

    

        
    


    

        

            Vi opererer med et kreditsystem. Kreditter er forudbetalte, ikke-refunderbare enheder, du bruger på API-kald og værktøjer. Kreditter forbruges FIFO (ældste først) og er gyldige i 12 måneder fra købsdatoen. Dashboardet viser hver købsdato og dens udløb.
        

    



                                                                    

    

        
    


    

        

            Ja. Alle købte kreditter (inklusive brøkdele) er gyldige i 12 måneder fra købet. Ubrugte kreditter udløber automatisk og slettes permanent ved udgangen af gyldighedsperioden. Udløbne kreditter kan ikke gendannes eller konverteres til kontanter eller anden værdi. Overgangsregel: kreditter købt før 22. sep. 2025 behandles som købt den 22. sep. 2025 og udløber den 22. sep. 2026 (medmindre en tidligere udløbsdato var angivet ved købet).
        

    



                                                                    

    

        
    


    

        

            Ja—inden for deres gyldighedsperiode. Ubrugte kreditter forbliver tilgængelige og overføres fra måned til måned, indtil de udløber 12 måneder efter købet.
        

    



                                                                    

    

        
    


    

        

            Kreditter er ikke-refunderbare. Køb kun det, du har brug for—du kan altid fylde op senere. Hvis en platformfejl forårsager en mislykket opkrævning, kan vi gendanne de berørte kreditter efter undersøgelse. Ingen kontant refusion.
        

    



                                                                    

    

        
    


    

        

            Priser er angivet i kreditter, ikke dollars. Hvert endpoint har sin egen pris—se mærket "Kreditter / forespørgsel" ovenfor. Du ved altid præcis, hvad du bruger.
        

    



                                                                                    

                    

                

            

        
                
            ← Tilbage til API'er