Transliterator API

27以上の文字体系を即座にラテン文字に変換 - SEOスラッグ、正規化検索、データパイプラインに最適。

API FAQ
APIキーを取得 クレジット購入
何ができますか？
検索の正規化

混合スクリプトコンテンツを統一的にインデックス化・検索。

SEOスラッグ

クリーンな多言語URLを即座に生成。

データパイプライン

カタログや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 UnauthorizedAPIキーが不足または不正。
403 Forbiddenキーが無効または許可されていません。
429 Rate Limitリクエストが多すぎます。
500 Server Error予期しないエラー。

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 3月 2026, 09:58
      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.
          

        

      

    

  



                    



        
                            

                

                    

                        
                        よくある質問
                    

                

                

                    

                        

                                                                                                

    

        
    


    

        

            アラビア語、キリル文字、ギリシャ語、ヘブライ語、CJKを含む25以上のスクリプトの完全な翻字をサポート。他の言語が必要ですか？お問い合わせください。
        

    



                                                                    

    

        
    


    

        

            ISOまたはデファクトのウェブ標準を使用。一般的な語彙で通常95%以上の精度。
        

    



                                                                                                                                                            

    

        
    


    

        

            はい。エラーが発生したリクエストを含め、すべてのリクエストがクレジットを消費します。クレジットは成功・失敗に関係なくリクエスト数に紐づいています。エラーが明らかに当社のプラットフォーム側の問題による場合は、影響を受けたクレジットを復元します（現金での返金はありません）。
        

    



                                                                    

    

        
    


    

        

            [email protected]までご連絡ください。フィードバックを真摯に受け止めています。バグレポートや機能リクエストが意味のあるものであれば、APIを迅速に修正・改善し、お礼として50の無料クレジットを付与します。
        

    



                                                                    

    

        
    


    

        

            APIやエンドポイントによって異なります。一部のエンドポイントは外部ソースのデータを使用しており、より厳しい制限がある場合があります。また、不正利用の防止とプラットフォームの安定性維持のために制限を設けています。各エンドポイントの具体的な制限についてはドキュメントをご確認ください。
        

    



                                                                    

    

        
    


    

        

            クレジットシステムで運営しています。クレジットは前払いの返金不可の単位で、API呼び出しやツールに使用します。クレジットはFIFO（古いものから順に）消費され、購入日から12か月間有効です。ダッシュボードに各購入日とその有効期限が表示されます。
        

    



                                                                    

    

        
    


    

        

            はい。購入したすべてのクレジット（端数残高を含む）は購入から12か月間有効です。未使用のクレジットは有効期間終了時に自動的に期限切れとなり、永久に削除されます。期限切れのクレジットは復元や現金その他の価値への変換はできません。経過措置：2025年9月22日以前に購入したクレジットは2025年9月22日購入として扱われ、2026年9月22日に期限切れとなります（購入時により早い期限が記載されていない限り）。
        

    



                                                                    

    

        
    


    

        

            はい—有効期間内で繰り越されます。未使用のクレジットは利用可能な状態のまま月ごとに繰り越され、購入後12か月で期限切れになります。
        

    



                                                                    

    

        
    


    

        

            クレジットは返金不可です。必要な分だけ購入してください—後からいつでもチャージできます。プラットフォーム側のエラーで課金に失敗した場合、調査後に影響を受けたクレジットを復元する場合があります。現金での返金はありません。
        

    



                                                                    

    

        
    


    

        

            料金はドルではなくクレジットで設定されています。各エンドポイントには独自のコストがあります—上記の「クレジット / リクエスト」バッジをご覧ください。常に正確な支出額がわかります。
        

    



                                                                                    

                    

                

            

        
                
            ← APIに戻る