Skip to main content

sogou translate for free

Project description

sogou-tr-free PyPI versionLicense: MITCode style: black

Sogou translate for free -- local cache, throttling (1.5 calls/s from 1001st call on). Let's hope it lasts.


version 0.0.10: added update_snuid


pip install -U sogou-tr-free


  • Install (pip or whatever) necessary requirements, e.g. pip install requests requests_cache jmespath fuzzywuzzy or pip install -r requirements.txt
  • Drop the file in any folder in your PYTHONPATH (check with import sys; print(sys.path)
  • or clone the repo (e.g., git clone or download and unzip) and change to the sogou-tr-free folder and do a python develop


from sogou_tr import sogou_tr
print(sogou_tr('hello world'))  # -> '你好世界'
print(sogou_tr('hello world', to_lang='de'))  # -> 'Hallo Welt'
print(sogou_tr('hello world', to_lang='fr'))  # -> 'Salut tout le monde'
print(sogou_tr('hello world', to_lang='ja'))  # ->'ハローワールド'


For each request made by sogou_tr, a vlaid SNUID is reqired. It takes time to acquire a SNUID, however. On the other hand, the SNUID can be used for a certain time period.

Hence, sogout_tr has a parameter to control whether to update SNUID or not. The parameter is, well, called update_snuid. By default, update_snuid=True. You can turn it off to speed things up:

text = "test 1232"
res = sogou_tr(text, update_snuid=False)

How do we know the SNUID is still valid? sogou_tr will throw an Exception("sogou server likely acting up") when the SNUID is no longer valid. Therefore, we might do something like this:

from time import sleep

text = "test 1232"
    res = sogou_tr(text, update_snuid=False)
except Exception as exc:
    if "server likely acting up" in str(exc):
        res = sogou_tr(text, update_snuid=True)

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 sogou-tr-free, version 0.0.11
Filename, size File type Python version Upload date Hashes
Filename, size sogou-tr-free-0.0.11.tar.gz (8.4 kB) File type Source Python version None Upload date Hashes View

Supported by

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