README

bing-translate-api

A simple and free API for Bing Translator for Node.js.

Install

npm install bing-translate-api

Usage

From auto-detected language to English:

const { translate } = require('bing-translate-api');

translate('你好', null, 'en', true).then(res => {
  console.log(res.translation);
}).catch(err => {
  console.error(err);
});

Translation result

{
  "text": "你好",
  "userLang": "auto-detect",
  "translation": "Hello",
  // `correctedText` is returned only when `correct` is set as `true`
  // supported since v1.1.0
  "correctedText": "",
  "language": {
    "to": "en",
    "from": "zh-Hans",
    // supported since v1.1.0
    "score": 1
  }
}

API

translate(text, [from], [to], [correct], [raw], [userAgent])

text

Type: string

The text to be translated, can't be blank. The maximum text length is 1000.

from

Type: string Default: auto-detect

The language code of source text. MUST be auto-detect or one of the codes/names (not case sensitive) contained in lang.js

to

Type: string Default: en

The language in which the text should be translated. MUST be one of the codes/names (not case sensitive) contained in lang.js.

correct

Type: boolean Default: false Since: v1.1.0

Whether to correct the input text.

Note that:

There is currently a limit of 50 characters for correction service.
Only the languages in the list are supported to be corrected.

raw

Type: boolean Default: false

Whether the translation result contains raw response from Bing API.

userAgent

Type: string

The header value of user-agent used in API requests.

Default:

Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/90.0.4430.212 Safari/537.36

License

Thanks

Great thanks to Bing Translator for providing so excellent translation service.

Usage no npm install needed!