Skip to main content

API for Yandex Translate

Project description

Author: James Axl
Version: 1.0
Date: 2017-05-10


version 1.0


This module uses the Yandex.Translate API for machine translation. A Yandex API key is required; see for more information.

Note also that the “Yandex Terms of Use of API Yandex.Translate Service” at must be observed.


$ pip install yandex-translater


Translate a Text

This is a simple example

>>> from yandex import Translater
>>> tr = Translater()
>>> tr.set_key('yandex_key') # Api key found on
>>> tr.set_from_lang('en')
>>> tr.set_to_lang('ru')
>>> tr.translate()



>>> tr = Translater(attributes)

This constructor returns a new object. Optional attributes include:


>>> tr.set_key('yandex_key')

This method is used to pass a Yandex API key (string), instead of passing it in Constructor. A tr object can be instantiated without any attributes.


>>> tr.set_text('text_to_translate')

This method is used to pass a text to translate (string).


>>> tr.set_from_lang('zh')

This method is used to pass a source language (string). For example, Chinese would be given as zh.


>>> tr.set_from_lang('ar')

This method is used to pass a destination language (string). For example, Arabic would be given as ar.


>>> tr.set_ui('fr')

This method is used to set the user interface language (string). For example, French would be given as fr.


>>> tr.set_default_ui('ru')

This method is used to set the default user interface language (string). Either ru (Russian) or en (English) or tr (Turkish) can be given.


>>> tr.set_hint('es', 'pt')

This method is used to set the list of likely languages for detecting the text language (array reference). For example, Spanish and Portuguese would be given as attributes.


>>> print tr.translate()

This method is used to get the translated text (string)


>>> print tr.detect_lang()

This method is used to detect the language of the text. It returns a string.


>>> print tr.get_langs_list()

This method is used to get the list of supported translation directions. In array context, it returns an array of these directions; in scalar context, it returns the count of them.


For more information, please visit Yandex <>.


Bugs / Feature Requests

Please report any bugs or feature requests on my email or created in the website. yandex-translate-bugs <>

Source Code

This is open source software. The code repository is available for public review and contribution under the terms of the license.


James Axl <>


This software is copyleft © 2017 by James Axl.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for yandex-translater, version 1.0
Filename, size File type Python version Upload date Hashes
Filename, size yandex_translater-1.0-py2.py3-none-any.whl (3.7 kB) File type Wheel Python version py2.py3 Upload date Hashes View hashes
Filename, size yandex-translater-1.0.tar.gz (5.1 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page