API2 Documentation
Production-ready Finnish language processing gateway
Translation • Text-to-Speech • Advanced Search • Comprehensive Tools
Comprehensive Finnish Language API 🌐
Production-ready cloud API with comprehensive Finnish language tools. Translation, text-to-speech, advanced search, conjugation, and more.
https://api2.finnishcompanion.comCommon Error Codes
ERR_NO_TERMNo term providedERR_INVALID_QUERYInvalid parametersERR_PROCESSINGProcessing errorERR_NO_RESULTSNo results foundWelcome
Core/A welcome message to verify API connectivity.
Parameters
No parameters required
Example
/
Dictionary Lookup
Core/dictLooks up dictionary entries for a given term in a specified language.
Parameters
termrequiredstringThe term to search for
langrequiredstringLanguage: "fi" for Finnish, "en" for English
Example
/dict?term=koira&lang=fi
Search Dictionary
Core/searchSearches for dictionary entries based on either Finnish or English.
Parameters
finnishoptionalstringFinnish term to search for
englishoptionalstringEnglish term to search for
Examples
/search?finnish=kissa
/search?english=cat
Finnish to English
Translation/finnishtoenglishTranslates a Finnish word/phrase to English.
Parameters
termrequiredstringThe Finnish word/phrase
Example
/finnishtoenglish?term=hyvää huomenta
English to Finnish
Translation/englishtofinnishTranslates an English word/phrase to Finnish.
Parameters
termrequiredstringThe English word/phrase
Example
/englishtofinnish?term=good morning
To Finnish
Translation/tofinnishTranslates from any supported language to Finnish.
Parameters
termrequiredstringThe word/phrase to translate
fromoptionalstringSource language code
Example
/tofinnish?term=hello&from=en
From Finnish
Translation/fromfinnishTranslates from Finnish to any supported language.
Parameters
termrequiredstringThe Finnish word/phrase
tooptionalstringTarget language code
Example
/fromfinnish?term=hei&to=en
Conjugate
Conjugation/conjugateConjugates Finnish verbs and nouns with detailed options.
Parameters
verboptionalstringThe verb to conjugate
nounoptionalstringThe noun to conjugate
commandoptionalstringA command to process
Examples
/conjugate?verb=olla&pronoun=minä&tense=present
/conjugate?noun=kirja&case=genitive
Quick Conjugate
Conjugation/quickconjugateQuickly determines term type and conjugates it automatically.
Parameters
termrequiredstringThe term to conjugate
Example
/quickconjugate?term=mennä
Reverse Conjugate
Conjugation/reverseconjugateFinds the base form of a conjugated Finnish word.
Parameters
termrequiredstringThe conjugated word
Example
/reverseconjugate?term=menemme
Word Breakdown
Word Analysis/breakdownBreaks down a compound Finnish word into its components.
Parameters
termrequiredstringThe compound word
Example
/breakdown?term=jääkaappi
Phrase Breakdown
Word Analysis/breakdownphraseBreaks down a Finnish phrase into its constituent parts.
Parameters
termrequiredstringThe phrase to analyze
Example
/breakdownphrase?term=iso punainen auto
Syllable Division
Word Analysis/syllableHyphenates a Finnish word into syllables.
Parameters
termrequiredstringThe word to hyphenate
Example
/syllable?term=kirjoittaa
Part of Speech
Word Analysis/posDetermines the part of speech of a Finnish word.
Parameters
termrequiredstringThe word to analyze
Example
/pos?term=kirja
Kotus Classification
Word Analysis/kotusRetrieves Kotus conjugation group information.
Parameters
termrequiredstringThe Finnish word
Example
/kotus?term=talossa
Text-to-Speech
Text Processing/speakReturns audio file or markup for spoken Finnish text.
Parameters
termrequiredstringText to speak
langrequiredstringLanguage (must be "fi")
returnmarkupoptionalstringReturn markup if "1"
Examples
/speak?term=tervetuloa&lang=fi
/speak?term=tervetuloa&lang=fi&returnmarkup=1
Readable Text
Text Processing/readabletextMakes text more readable by hyphenating words.
Parameters
textrequiredstringText to process
leveloptionalnumberOutput level (1-3)
Examples
/readabletext?text=Mennään kotiin
/readabletext?text=Mennään kotiin&level=1
Ninja Command
Advanced Tools/ninjaVersatile endpoint that executes various commands in one place.
Parameters
commandrequiredstringCommand with parameters (e.g., "fi-en talo", "kotus auto")
Examples
/ninja?command=fi-en talo
/ninja?command=kotus auto
/ninja?command=rc menen
Notes
- Supports: rc (reverse conjugate), kotus, speak, fi/en (dictionary), fi-en/en-fi (translate), syllable, pos, and conjugation commands
Word Suggestions
Advanced Tools/suggestReturns word suggestions for a given Finnish term.
Parameters
termrequiredstringPartial Finnish word
Example
/suggest?term=kirj
Mini Dictionary
Advanced Tools/minidictSimple dictionary lookup between English and Finnish.
Parameters
wordrequiredstringWord to translate
directionrequiredstring"en-fi" or "fi-en"
Example
/minidict?word=house&direction=en-fi