googletrans
An unofficial Google Translate API for Python
Decision gist · record as of 2026-08-14
Yes, if you accept the stability trade-offs. Googletrans is actively maintained, has low install friction, and works well for prototyping or cost-sensitive use cases. However, do not use it for production systems requiring guaranteed uptime—Google can block your IP or change its API at any time. For mission-critical translation, use Google's official API instead.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.8 or later.
- Google may block your IP if making excessive requests; service URLs can be customized to mitigate this.
- Low install friction with a single runtime dependency (httpx).
License · maintenance · safety
permissive license (permissive) — Licensed under the MIT License (permissive), allowing free use, modification, and distribution with minimal restrictions.
last release 2025-01-01 (590 days) · last repo commit 2026-08-08 · 4,267 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 5,468,870 downloads/mo, #2,093 on PyPI
Alternatives
Verify before relying
pip install googletrans
import asyncio
from googletrans import Translator
async def main():
async with Translator() as translator:
result = await translator.translate('Hello', dest='es')
print(result.text)
asyncio.run(main())- Whether the token-generation mechanism remains stable against Google's ongoing API changes and IP-blocking policies.
- Current reliability and uptime guarantees given the disclaimer that this is an unofficial web API client.
What it is and what it does
Googletrans is an unofficial Python client for Google Translate that works by reverse-engineering Google's web API rather than using the official paid API. It provides translation, language detection, and bulk translation capabilities with async support and HTTP/2 enabled by default through httpx.
The library is designed for developers who need free, unlimited translation without official API costs, but comes with important caveats: it has a 15k character limit per request, relies on web scraping that Google could block at any time, and offers no stability guarantees. It includes a command-line tool, customizable service URLs, proxy support, and complete type hints. The package is compatible with Python 3.8 and later.
Use it for
- Translate user-generated content or bulk text batches in applications where cost is a primary concern.
- Detect the language of incoming text to route it to appropriate processing pipelines.
- Build multilingual chatbots or support systems that need real-time translation without official API overhead.
- Add translation features to educational tools or desktop applications targeting end users.
- Prototype translation workflows before committing to Google's official paid API.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you accept the stability trade-offs.
Googletrans is actively maintained, has low install friction, and works well for prototyping or cost-sensitive use cases. However, do not use it for production systems requiring guaranteed uptime—Google can block your IP or change its API at any time. For mission-critical translation, use Google's official API instead.
Install
googletrans on PyPI
Before you install
Low install friction with a single runtime dependency (httpx). The package is actively maintained with a recent commit on 2026-08-08 and has been in production use since its first release in 2017.
Requires Python 3.8 or later. Google may block your IP if making excessive requests; service URLs can be customized to mitigate this.
License in practice
Licensed under the MIT License (permissive), allowing free use, modification, and distribution with minimal restrictions.
Quickstart
pip install googletrans
import asyncio
from googletrans import Translator
async def main():
async with Translator() as translator:
result = await translator.translate('Hello', dest='es')
print(result.text)
asyncio.run(main())Verify before relying
- Whether the token-generation mechanism remains stable against Google's ongoing API changes and IP-blocking policies.
- Current reliability and uptime guarantees given the disclaimer that this is an unofficial web API client.
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release >=3.8 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagehttpx |
| Maintenance | Actively maintained 590 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 5,468,870 / month, #2,093 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: EducationIntended Audience :: End Users/DesktopLicense :: OSI Approved :: MIT LicenseOperating System :: MacOS :: MacOS XOperating System :: Microsoft :: WindowsOperating System :: POSIXProgramming Language :: PythonProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Topic :: Education |
Evidence: googletrans-4.0.2-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “language translation library”
- googletransGoogletrans translates text and detects languages by calling Google…
- deeplProvides a Python client to interact with the DeepL API for…
- libretranslatepyPython client library for the LibreTranslate API that provides text…
Give your agent the search over MCP, or paste the wish link into any chat.
More Education packages
Wraps any iterable to display a real-time progress bar in the terminal or Jupyter notebook, showing iteration count, elapsed time, and estimated time remaining.
Sphinx generates professional documentation from reStructuredText source files, producing HTML, PDF, EPUB, and other formats with automatic cross-references, code highlighting, and hierarchical navigation.
progressbar2 renders text-based progress bars in the terminal, handling custom widgets, concurrent bars, unknown-length progress, and clean output around logs and prints.
Represents and manipulates IPv4, IPv6, MAC addresses and related network objects; supports CIDR notation, subnetting, set operations, IANA lookups, and DNS reverse generation.
cuda-python is a metapackage providing Pythonic access to NVIDIA's CUDA platform, bundling low-level bindings, runtime abstractions, and utilities for GPU-accelerated computing from Python.
However, verify that the proprietary NVIDIA license aligns with your project's requirements before committing to it in production or redistributed code.
Provides Pythonic APIs to access CUDA core functionalities including runtime control, compiler, and linker operations from Python.
See also googletrans-py · deep-translator · translators · translate · libretranslatepy · azure-ai-translation-text · deepl · gTTS · google-cloud-translate