A free and unlimited API for Google Translate for Node.js.
In version 9+ library was fully rewritten. For legacy documentation please see legacy branch.
DISCLAIMER! To be 100% legal please use official Google Translate API. This project is mainly for pet projects and prototyping.
- auto language detection
- all Google Translate languages supported
- react-native supported
- transliteration
npm install @vitalets/google-translate-api
import { translate } from '@vitalets/google-translate-api';
const { text } = await translate('Привет, мир! Как дела?', { to: 'en' });
console.log(text) // => 'Hello World! How are you?'Since react-native has full support of fetch API translation works the same way as in Node.js.
This library does not work inside web pages because translate.google.com does not provide CORS headers allowing access from other domains.
Although library does not work in regular web pages it can be used in browser extensions. Extensions background and popup pages are not limited with same origin policy. To use translation API you should do the following:
-
Add host permissions to
manifest.json:+ "host_permissions": [ + "https://translate.google.com/" + ]
-
Import
translateas usual in background or popup script:// background.js import { translate } from '@vitalets/google-translate-api'; const { text } = await translate('Привет мир'); console.log(text);
-
Bundle code (for example with
webpack):// webpack.config.js module.exports = { mode: 'development', entry: './background.js', output: { filename: 'bundle.js', }, };
Google Translate has request limits. If too many requests are made from the same IP address, you will get a TooManyRequestsError (code 429). You can use proxy to bypass it:
import { translate } from '@vitalets/google-translate-api';
import { HttpProxyAgent } from 'http-proxy-agent';
const agent = new HttpProxyAgent('http://103.152.112.162:80');
const { text } = await translate('Привет, мир!', {
to: 'en',
fetchOptions: { agent },
});See [examples/with-proxy.ts] for more details.
Available proxy list you can find here (with
anonymousin *Anonymity andyesin Google columns).
Common pattern for selecting proxy is following:
try {
const { text } = await translate('Привет, мир!', {
to: 'en',
fetchOptions: { agent },
});
} catch (e) {
if (e.name === 'TooManyRequestsError') {
// retry with another proxy agent
}
}See #107 for discussion.
translate(text: string, options?: Options): Promise<Response>text(string) - The text to be translatedoptions(object)from(string) - The language oftext. Must beautoor one of the supported languages. Default:autoto(string) - The language in which the text should be translated. Must be one of the supported languages. Default:autohost(string) - Google translate host to be used in API calls. Default:translate.google.comfetchOptions(object) - Additional fetch options passed into request.
text(string) – The translated text.raw(object) - Raw responspe from the API. Contains sentences, detected original language and transliteration. Example response.
- matheuss/google-translate-api - original repo
- Translateer - uses Puppeteer to access Google Translate API
- hua1995116/google-translate-open-api
- google-translate-api-x
MIT © Matheus Fernandes, forked and maintained by Vitaliy Potapov.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent
