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.

Base URL

https://api2.finnishcompanion.com

Common Error Codes

ERR_NO_TERMNo term provided

ERR_INVALID_QUERYInvalid parameters

ERR_PROCESSINGProcessing error

ERR_NO_RESULTSNo results found

GET

Welcome

Core

/

A welcome message to verify API connectivity.

Parameters

No parameters required

Example

GET

Dictionary Lookup

Core

/dict

Looks up dictionary entries for a given term in a specified language.

Parameters

termrequiredstring

The term to search for

langrequiredstring

Language: "fi" for Finnish, "en" for English

Example

/dict?term=koira&lang=fi

GET

Search Dictionary

Core

/search

Searches for dictionary entries based on either Finnish or English.

Parameters

finnishoptionalstring

Finnish term to search for

englishoptionalstring

English term to search for

Examples

/search?finnish=kissa

/search?english=cat

GET

Finnish to English

Translation

/finnishtoenglish

Translates a Finnish word/phrase to English.

Parameters

termrequiredstring

The Finnish word/phrase

Example

/finnishtoenglish?term=hyvää huomenta

GET

English to Finnish

Translation

/englishtofinnish

Translates an English word/phrase to Finnish.

Parameters

termrequiredstring

The English word/phrase

Example

/englishtofinnish?term=good morning

GET

To Finnish

Translation

/tofinnish

Translates from any supported language to Finnish.

Parameters

termrequiredstring

The word/phrase to translate

fromoptionalstring

Source language code

Example

/tofinnish?term=hello&from=en

GET

From Finnish

Translation

/fromfinnish

Translates from Finnish to any supported language.

Parameters

termrequiredstring

The Finnish word/phrase

tooptionalstring

Target language code

Example

/fromfinnish?term=hei&to=en

GET

Conjugate

Conjugation

/conjugate

Conjugates Finnish verbs and nouns with detailed options.

Parameters

verboptionalstring

The verb to conjugate

nounoptionalstring

The noun to conjugate

commandoptionalstring

A command to process

Examples

/conjugate?verb=olla&pronoun=minä&tense=present

/conjugate?noun=kirja&case=genitive

GET

Quick Conjugate

Conjugation

/quickconjugate

Quickly determines term type and conjugates it automatically.

Parameters

termrequiredstring

The term to conjugate

Example

/quickconjugate?term=mennä

GET

Reverse Conjugate

Conjugation

/reverseconjugate

Finds the base form of a conjugated Finnish word.

Parameters

termrequiredstring

The conjugated word

Example

/reverseconjugate?term=menemme

GET

Word Breakdown

Word Analysis

/breakdown

Breaks down a compound Finnish word into its components.

Parameters

termrequiredstring

The compound word

Example

/breakdown?term=jääkaappi

GET

Phrase Breakdown

Word Analysis

/breakdownphrase

Breaks down a Finnish phrase into its constituent parts.

Parameters

termrequiredstring

The phrase to analyze

Example

/breakdownphrase?term=iso punainen auto

GET

Syllable Division

Word Analysis

/syllable

Hyphenates a Finnish word into syllables.

Parameters

termrequiredstring

The word to hyphenate

Example

/syllable?term=kirjoittaa

GET

Part of Speech

Word Analysis

/pos

Determines the part of speech of a Finnish word.

Parameters

termrequiredstring

The word to analyze

Example

/pos?term=kirja

GET

Kotus Classification

Word Analysis

/kotus

Retrieves Kotus conjugation group information.

Parameters

termrequiredstring

The Finnish word

Example

/kotus?term=talossa

GET

Text-to-Speech

Text Processing

/speak

Returns audio file or markup for spoken Finnish text.

Parameters

termrequiredstring

Text to speak

langrequiredstring

Language (must be "fi")

returnmarkupoptionalstring

Return markup if "1"

Examples

/speak?term=tervetuloa&lang=fi

/speak?term=tervetuloa&lang=fi&returnmarkup=1

GET

Readable Text

Text Processing

/readabletext

Makes text more readable by hyphenating words.

Parameters

textrequiredstring

Text to process

leveloptionalnumber

Output level (1-3)

Examples

/readabletext?text=Mennään kotiin

/readabletext?text=Mennään kotiin&level=1

GET

Ninja Command

Advanced Tools

/ninja

Versatile endpoint that executes various commands in one place.

Parameters

commandrequiredstring

Command 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

GET

Word Suggestions

Advanced Tools

/suggest

Returns word suggestions for a given Finnish term.

Parameters

termrequiredstring

Partial Finnish word

Example

/suggest?term=kirj

GET

Mini Dictionary

Advanced Tools

/minidict

Simple dictionary lookup between English and Finnish.

Parameters

wordrequiredstring

Word to translate

directionrequiredstring

"en-fi" or "fi-en"

Example

/minidict?word=house&direction=en-fi

Back to Documentation View Engine Docs