Linguatools Translate API

Content:
Overview
Connect to API
Test the API
API response
Code snippets
Examples of use
Dictionary sources

Overview

Translate API looks up a word in a dictionary and returns all translations ordered by frequency. The API translates from and to German for the following languages: English, Spanish, Dutch, Polish, Italian, and Czech. Translate API allows to filter by word class and by minimum frequency.

How to use Linguatools Translate API

Connect to API

Endpoint and Parameters

Endpoint:
GET /?langpair={lang1-lang2}&query={word}&wortart={wordclass}&min_freq={number}

URL parameters:

parameter	description	parameter value
query	any word (case insensitive)	e.g. change
langpair	One of the following combinations (case sensitive):	`de-en, de-es, de-nl, de-pl, de-it, de-cs, en-de, es-de, nl-de, pl-de, it-de cs-de`
wortart	One of the following word classes (case sensitive, optional):	`NOMEN, ADJ, VERB, ADVERB`
min_freq	any number	`1,2,3,75334`, etc.

Test the API

You can test the API and develop your own application with our test translate API – for free.

Test the test API with:

langpair: de-en
query: Anzahl
wortart: VERB (optional)

http request

https://lt-translate-test.herokuapp.com/mashapes?langpair=en-de&query=change&wortart=VERB
wget "https://lt-translate-test.herokuapp.com/mashapes?langpair=en-de&query=change&wortart=VERB"

Important note (!)::
The initial API call might take up to 15 seconds because the heroku dyno falls asleep after 30 minutes of inactivity.
(The test API runs on a free heroku dyno.)

Further limits of the test API
The test API contains only a subset of the complete dictionary database. Therefore only high frequent words are included.
E.g.: change, cover and make are high frequent words.

API response

[

{

"id":24728,

"l1_text":"ändern",

"l2_text":"change",

"wortart":"VERB",

"synonyme1":"...",

"synonyme2":"...",

"freq":27459

}

]

l1_text: german word
l2_text: translation of the german word
wortart: word class (NOMEN (=noun), ADJ, VERB, ADVERB)
synonyme1: „Synonyms“ for the translation of the German word, created by collecting the alternative translations. For instance, the words car, auto, automobile, motor vehicle, motorcar are all translations of the German word Auto and thus can be regarded as „synonyms“.
synomyme2: „Synonyms“ for the German word, created by collecting alternative translations of the translation of the German word.
freq: The number specifies how often the translation was used in our database of translated documents. The higher the number the more common the translation.
Note: Since there is always noise in the dictionary sources as well as in the translated documents, in order to make sure that you only get correct translations you can set the query parameter min_freq (minimum frequency) to 1 to get only translations that have occurred at least once in our corpus. Compare the result of the two api calls with and without min_freq:

Without min_freq:
https://lt-translate-test.herokuapp.com/mashapes?langpair=en-de&query=change&wortart=VERB

[
{
"id":24728,
"l1_text":"ändern",
"l2_text":"change",
"wortart":"VERB",
"synonyme1":"alter, alternate, amend, change, modify, transform, vary",
"synonyme2":"abändern, auswechseln, erneuern, modifizieren, schalten, umbuchen, umschalten, umschreiben, umsteigen, umtauschen, umziehen, umändern, verwandeln, verändern, wandeln, wechseln, ändern",
"freq":27459
},
{
"id":534210,
"l1_text":"verändern",
"l2_text":"change",
"wortart":"VERB",
"synonyme1":"alter, change, clone, diversify, make a career change, make a job move, modify, mutate, transform, vary",
"synonyme2":"abändern, auswechseln, erneuern, modifizieren, schalten, umbuchen, umschalten, umschreiben, umsteigen, umtauschen, umziehen, umändern, verwandeln, verändern, wandeln, wechseln, ändern",
"freq":14980
},
{
"id":455453,
"l1_text":"sich ändern",
"l2_text":"change",
"wortart":"VERB",
"synonyme1":"alter, alternate, amend, change, modify, transform, vary",
"synonyme2":"abändern, auswechseln, erneuern, modifizieren, schalten, umbuchen, umschalten, umschreiben, umsteigen, umtauschen, umziehen, umändern, verwandeln, verändern, wandeln, wechseln, ändern",
"freq":11199
},
{
"id":460125,
"l1_text":"sich verändern",
"l2_text":"change",
"wortart":"VERB",
"synonyme1":"alter, change, clone, diversify, make a career change, make a job move, modify, mutate, transform, vary",
"synonyme2":"abändern, auswechseln, erneuern, modifizieren, schalten, umbuchen, umschalten, umschreiben, umsteigen, umtauschen, umziehen, umändern, verwandeln, verändern, wandeln, wechseln, ändern",
"freq":7627
}
]

[

{

"id":24728,

"l1_text":"ändern",

"l2_text":"change",

"wortart":"VERB",

"synonyme1":"alter, alternate, amend, change, modify, transform, vary",

"synonyme2":"abändern, auswechseln, erneuern, modifizieren, schalten, umbuchen, umschalten, umschreiben, umsteigen, umtauschen, umziehen, umändern, verwandeln, verändern, wandeln, wechseln, ändern",

"freq":27459

{

"id":534210,

"l1_text":"verändern",

"l2_text":"change",

"wortart":"VERB",

"synonyme1":"alter, change, clone, diversify, make a career change, make a job move, modify, mutate, transform, vary",

"freq":14980

{

"id":455453,

"l1_text":"sich ändern",

"l2_text":"change",

"wortart":"VERB",

"synonyme1":"alter, alternate, amend, change, modify, transform, vary",

"freq":11199

{

"id":460125,

"l1_text":"sich verändern",

"l2_text":"change",

"wortart":"VERB",

"synonyme1":"alter, change, clone, diversify, make a career change, make a job move, modify, mutate, transform, vary",

"freq":7627

}

]

With min_freq = 15000:
https://lt-translate-test.herokuapp.com/mashapes?langpair=en-de&query=change&wortart=VERB&min_freq=15000

[
{
"id":24728,
"l1_text":"ändern",
"l2_text":"change",
"wortart":"VERB",
"synonyme1":"alter, alternate, amend, change, modify, transform, vary",
"synonyme2":"abändern, auswechseln, erneuern, modifizieren, schalten, umbuchen, umschalten, umschreiben, umsteigen, umtauschen, umziehen, umändern, verwandeln, verändern, wandeln, wechseln, ändern",
"freq":27459
}
]

[

{

"id":24728,

"l1_text":"ändern",

"l2_text":"change",

"wortart":"VERB",

"synonyme1":"alter, alternate, amend, change, modify, transform, vary",

"freq":27459

}

]

Code snippets

Ruby

require 'curb'
require 'json'
dictapiurl = "https://lt-translate-test.herokuapp.com/mashapes?langpair=en-de&query=change&wortart=VERB"
api = Curl::Easy.new(dictapiurl)
api.perform
json_data = JSON.parse(api.body_str)

require 'curb'

require 'json'

dictapiurl = "https://lt-translate-test.herokuapp.com/mashapes?langpair=en-de&query=change&wortart=VERB"

api = Curl::Easy.new(dictapiurl)

api.perform

json_data = JSON.parse(api.body_str)

Python

import requests
import json
dictapiurl = 'https://lt-translate-test.herokuapp.com/mashapes?langpair=en-de&query=change&wortart=VERB'
response = requests.get(dictapiurl)
json_data = json.loads(response.text)

import requests

import json

dictapiurl = 'https://lt-translate-test.herokuapp.com/mashapes?langpair=en-de&query=change&wortart=VERB'

response = requests.get(dictapiurl)

json_data = json.loads(response.text)

Dictionary sources

The dictionary is compiled from the following sources:

linguatools‘ manually edited dictionary
IATE: the EU’s terminology database
EuroVoc: multilingual Thesaurus of the EU
Wiktionary
EMWN: Extended Open Multilingual Wordnet
OmegaWiki
Frank Richters Glossar

Number of translations in the complete dictionary database and Online Query

lanpair	Online-Query	Number of translations
de-en/en-de	German-English Dict	990.568
de-es/es-de	German-Spanish Dict	609.346
de-it/it-de	German-Italian Dict	678.246
de-nl/nl-de	German-Dutch Dict	647.464
de-pl/pl-de	German-Polish Dict	89.056
de-cs/cs-de	German-Czech Dict	66.773

Examples of use

linguatools context dictionaries:
German-Englisch, German-Spanish, German-Polish, German-Czech, German-Dutch, German-Italian

If you want to use the translate API in your project please contact peter.kolb@linguatools.org for pricing and license conditions.

Other language APIs by linguatools: https://linguatools.org/language-apis/