Skip to main content

API for Yandex Translate

Project description

yandex-translater Yandex Translate Api for Python

:author: James Axl
:version: 7.0
:date: 2018-12-02


version 7.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

.. code-block:: pycon

>>> from yandex.Translater 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()



.. code-block:: pycon
>>> tr = Translater(attributes)

This constructor returns a new object. Optional attributes include:


.. code-block:: pycon

>>> 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.


.. code-block:: pycon

>>> tr.set_text('text_to_translate')

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


.. code-block:: python

>>> tr.set_from_lang('zh')

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


.. code-block:: python

>>> tr.set_from_lang('ar')

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


.. code-block:: python

>>> tr.set_ui('fr')

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


.. code-block:: python

>>> 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.


.. code-block:: python

>>> 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.


.. code-block:: python

>>> print tr.translate()

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


.. code-block:: python

>>> print tr.detect_lang()

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


.. code-block:: python

>>> 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.

vim: filetype=rst

Project details

Download files

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

Source Distribution

yandex-translater-6.0.tar.gz (9.0 kB view hashes)

Uploaded source

Built Distribution

yandex_translater-6.0-py2.py3-none-any.whl (5.2 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page