Manglish APImanglish.app ↗
Convert Manglish (romanized Malayalam) text to Malayalam script via a single API endpoint. Returns top transliteration and up to 10 alternative candidates.
What is the Manglish API?
The Manglish.app API exposes 1 endpoint — transliterate — that converts romanized Malayalam (Manglish) text into Malayalam script. A single call returns 3 core response fields: input, transliteration, and suggestions, where suggestions holds up to 10 alternative script candidates. It handles both single words like 'nanni' and multi-word phrases like 'ente peru ravi'.
curl -X GET 'https://api.parse.bot/scraper/ef0e03ac-0c5f-4fbd-96fa-65d5e0d656e8/transliterate?text=nanni' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace manglish-app-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Manglish Transliteration API — convert romanized Malayalam to script."""
from parse_apis.manglish_app_api import Manglish, InputFormatInvalid
client = Manglish()
# Transliterate a single word with default suggestions
result = client.transliterations.create(text="nanni")
print(result.transliteration) # top Malayalam result
print("Suggestions:", result.suggestions)
# Transliterate a multi-word phrase, requesting more alternatives
phrase = client.transliterations.create(text="ente peru ravi", num_suggestions=8)
print(f"'{phrase.input}' -> {phrase.transliteration}")
for suggestion in phrase.suggestions:
print(f" alt: {suggestion}")
# Handle invalid input gracefully
try:
client.transliterations.create(text="")
except InputFormatInvalid as e:
print(f"Invalid input: {e.message}")
print("exercised: transliterations.create with single word / phrase / error handling")
Transliterates Manglish (romanized Malayalam) text to Malayalam script. Returns the top transliteration and up to num_suggestions alternative candidates. Supports single words and multi-word phrases. One upstream round-trip per call.
| Param | Type | Description |
|---|---|---|
| textrequired | string | Manglish text to transliterate (e.g. 'ente peru ravi', 'nanni', 'kerala'). |
| num_suggestions | integer | Number of transliteration suggestions to return (1–10). |
{
"type": "object",
"fields": {
"input": "The original Manglish text that was transliterated",
"suggestions": "Array of alternative Malayalam transliteration candidates",
"transliteration": "The top Malayalam transliteration result"
},
"sample": {
"data": {
"input": "nanni",
"suggestions": [
"നന്ദി",
"നാന്ദി",
"നന്നി",
"നാണി",
"നാന്നി"
],
"transliteration": "നന്ദി"
},
"status": "success"
}
}About the Manglish API
What the API Returns
The transliterate endpoint accepts a text parameter containing Manglish — Malayalam written in Latin characters — and returns a transliteration field with the best-match Malayalam script output. The suggestions array provides up to 10 ranked alternative transliterations, useful when the input is ambiguous or when multiple valid spellings exist in Malayalam script. The input field echoes back the original Manglish string for easy correlation in batch workflows.
Parameters and Behavior
The required text parameter accepts single words or multi-word phrases. The optional num_suggestions integer (range 1–10) controls how many alternative candidates are returned in the suggestions array. If omitted, the endpoint applies a default count. Each call maps to one upstream round-trip, so response time is consistent regardless of text length.
Scope and Coverage
The API is scoped to Malayalam transliteration. It does not perform translation between languages — it converts the phonetic Latin representation of a Malayalam word or phrase into the correct Malayalam Unicode script characters. This is useful wherever user-typed Manglish input needs to be normalized to proper script for storage, display, or further NLP processing.
The Manglish API is a managed, monitored endpoint for manglish.app — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when manglish.app changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official manglish.app API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Normalizing user-typed Manglish input in a Malayalam-language mobile keyboard or chat app to proper script before saving to a database.
- Building an autocomplete or suggestion widget that displays Malayalam script alternatives from the
suggestionsarray as a user types. - Preprocessing Manglish content in a corpus before feeding it to a Malayalam NLP or text classification pipeline.
- Rendering correct Malayalam script in a multilingual CMS where editors submit content in romanized form.
- Converting Manglish subtitles or captions to Malayalam Unicode script for localized video content.
- Validating or correcting transliteration output in a language-learning app by displaying the
suggestionsarray to the learner.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does manglish.app offer an official developer API?+
What does the `suggestions` field contain and how is it different from `transliteration`?+
transliteration field is the single best-match Malayalam script result for the input. The suggestions array contains up to 10 alternative Malayalam script candidates ranked by likelihood. You control the count with the num_suggestions parameter (1–10). Both fields use the same input text, so you can present the top result immediately and offer alternatives if the user wants to refine.Does the API support transliterating from Malayalam script back to Manglish (reverse transliteration)?+
transliterate endpoint only converts Manglish (Latin characters) to Malayalam script, not the reverse direction. You can fork this API on Parse and revise it to add a reverse-transliteration endpoint if that direction is needed.Can the API handle full sentences or only individual words?+
text parameter accepts both single words and multi-word phrases, so short sentences work. Very long passages with complex punctuation may produce less accurate results since the model optimizes for typical Manglish input patterns rather than formal prose.