PUBLIC API · FREE · NO AUTH
Syllables API
A free, public REST endpoint that returns syllable count, syllable breakdown, stress pattern, and IPA transcription for any word. Use it from the browser, a script, or your backend — no signup, no API key.
Quick start
# Count the syllables in "hello" curl "https://fixie.tools/api/syllables?word=hello"
Response:
{
"word": "hello",
"syllable_count": 2,
"syllables": ["hel", "lo"],
"stress": [1, 0],
"ipa": "/həˈloʊ/",
"language": "en",
"source": "cmu"
}
Endpoints
GET
/api/syllables
Analyze a single word.
| Param | Type | Required | Description |
|---|---|---|---|
word | string | yes | The word to analyze. Max 64 chars. |
lang | string | no (default en) | One of en, es, fr, de, pt, it. |
Rate limit: 60 requests / minute / IP.
POST
/api/syllables/batch
Analyze up to 100 words in one request. Send JSON.
{
"words": ["hello", "world", "syllable"],
"lang": "en"
}
Rate limit: 30 requests / minute / IP. Max 100 words per request.
Examples
# Single word curl "https://fixie.tools/api/syllables?word=internationalization" # Spanish curl "https://fixie.tools/api/syllables?word=biblioteca&lang=es" # Batch curl -X POST "https://fixie.tools/api/syllables/batch" \ -H "Content-Type: application/json" \ -d '{"words": ["hello", "world"], "lang": "en"}'
Status codes
| Code | Meaning |
|---|---|
200 | Success. Response body is JSON. |
400 | Bad request — usually an unsupported lang, or a word longer than 64 characters, or more than 100 words in a batch. |
422 | Missing or malformed parameters (FastAPI validation error). |
429 | Rate limit exceeded. Back off and retry after ~60 seconds. |
Notes & limits
- No authentication. No keys, no headers, no signup. CORS is open — call it from any browser origin.
- No SLA. This is a free service; we don't guarantee uptime. If you need durable infrastructure, host your own instance.
- English uses the CMU Pronouncing Dictionary — stress and IPA fields are filled in. The
sourcefield reports"cmu"for dictionary hits and"heuristic"for fallback. - Other languages use phonological heuristics — vowel-group counting with diphthong and silent-letter rules. Accuracy is roughly 85–90% on common words;
stressandipaare not provided. - No PII logging. We only record aggregate counts (mode, language, count bucket) for capacity planning.
Frequently Asked Questions
Is the syllables API free?
Yes. There is no signup, no API key, and no payment. The free tier is the only tier and there is no SLA.
Do I need to authenticate?
No. All endpoints are open. Use them from any client — browser, server, or script — without auth headers.
What is the rate limit?
60 requests per minute per IP for the single-word GET endpoint, and 30 requests per minute per IP for the batch POST endpoint (up to 100 words per batch). Over the limit returns HTTP 429.
Which languages are supported?
English (en), Spanish (es), French (fr), German (de), Portuguese (pt), and Italian (it). English uses the CMU Pronouncing Dictionary; the others use phonological heuristics with ~85-90% accuracy.