Translate names

Name translation transliterates the name of an entity (Person, Location, or Organization) between English and another language.

When you are converting from English to another language, the endpoint is optimized to convert the English version of a person’s name back to the native language of that name. For example, you can translate Vladimir Nabokov into Russian (rus) and the endpoint returns "translation": "Владимир Набоков".

By default, name translator returns the best or most likely result. Use the parameter maximumResults to return more results.

Headers

X-RosetteAPI-KeystringRequired

Request

This endpoint expects an object.
namestringRequired
The name to translate.
targetLanguagestringRequired

ISO 639-3 code for the name’s language.

entityTypeenumOptional
the entity type of the object
Allowed values:
sourceLanguageOfOriginstringOptional

ISO 639-3 code for the name’s language.

sourceLanguageOfUsestringOptional

ISO 639-3 code for the name’s language.

sourceScriptstringOptional
ISSO 15924 code for the name's script.
targetSchemestringOptional
transliteration schme for the translation
targetScriptstringOptional
ISSO 15924 code for the name's script.
maximumResultsdoubleOptional

Response

OK
sourceScriptstring or null
ISSO 15924 code for the name's script.
sourceLanguageOfUsestring or null

ISO 639-3 code for the name’s language.

targetLanguagestring or null

ISO 639-3 code for the name’s language.

targetScriptstring or null
ISSO 15924 code for the name's script.
targetSchemestring or null
transliteration scheme for the translation
confidencedouble or null
The confidence of the translation
translationslist of objects or null
extendedInformationlist of objects or null