טרנסליטרציה מקוונת ו-API

המרה מיידית של יותר מ-27 כתבים לכתב לטיני – מושלם לשמות-כתובת SEO, חיפוש מנורמל וצינורות נתונים.

פרמטר	סוג	חובה	תיאור
`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

string

כן

Auth key

lang

string

אופציונלי

ISO code of input script

text

string

כן

Input text (max. 255 chars)

type

string

אופציונלי

delimiter

string

אופציונלי

Custom delimiter for slug/snake

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(); });

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())

Code	Description
200 Success	Request processed OK.
400 Bad Request	Input validation failed.
401 Unauthorized	Missing / wrong API key.
403 Forbidden	Key inactive or not allowed.
429 Rate Limit	Too many requests.
500 Server Error	Unexpected failure.

Code

Description

200 Success

Request processed OK.

400 Bad Request

Input validation failed.

401 Unauthorized

Missing / wrong API key.

403 Forbidden

Key inactive or not allowed.

429 Rate Limit

Too many requests.

500 Server Error

Unexpected failure.

טרנסליטרציה מקוונת ו-API — Practical Guide

A hands-on guide to טרנסליטרציה מקוונת ו-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: 21 נוב׳ 2025, 20:29 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.

טרנסליטרציה מקוונת ו-API

מה ניתן לעשות?

נרמול חיפוש

שמות-כתובת SEO

צינורות נתונים

Transliterator API

דוגמאות בקשה

אינטגרציות API

Response Example

קודי תגובה

transliterate

Parameters

Code Samples

Response