Linguatools Translation Dictionary API

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

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

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: en-de
query: change
wortart: VERB (optional)

http request

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

Important note (!)::
The initial API call might take up to 30 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 translations are included (Top 1,000 for every language pair).
E.g.: change, buy, do and make in lang: de-en.

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/?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/?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/?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/?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/?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/?langpair=en-de&query=change&wortart=VERB'

response = requests.get(dictapiurl)

json_data = json.loads(response.text)

Paid API

Licensing conditions

The API/data package can be used in any number of private and commercial projects of the purchaser:
E. g. in a website application, in a smartphone app etc.

Redistribution is not allowed.

If you want to use the API/data package in your project please contact peter.kolb@linguatools.org

The prices for the API start at 9 € (incl. Vat) per month (max. 1 query per second)

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	734.462
de-es/es-de	German-Spanish Dict	97.477
de-it/it-de	German-Italian Dict	64.831
de-nl/nl-de	German-Dutch Dict	63.458
de-pl/pl-de	German-Polish Dict	30.389
de-cs/cs-de	German-Czech Dict	57.603

Endpoint and parameters

The parameters are the same as in the test API.
After licensing you get the end point to access the full translate database.

Examples of use

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

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