# bing-translate-api > A simple and free API for Bing & Microsoft Translator for Node.js Latest version **4.3.0** (published 2026-09-14) · MIT license · 0 weekly downloads ## Install ```sh npm install bing-translate-api pnpm add bing-translate-api yarn add bing-translate-api bun add bing-translate-api ``` ## Health **Score 65/100 (B)** — status: active. Positive: has types; no vulnerabilities; recently updated; high maintenance score; high quality score. Warnings: low downloads; no esm support. ## Facts | | | |---|---| | Version | 4.3.0 | | Published | 2026-09-14 | | First published | 2021-03-02 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | bundled | | Module format | CommonJS | | Dependencies | 1 | | Unpacked size | 51.3 KB | | Known vulnerabilities | 0 | | Install scripts | no | | Author | plainheart | | Maintainers | plainheart | | Keywords | bing, microsoft, translator, api, javascript, free, node, translate, azure | ## Links - npm: https://www.npmjs.com/package/bing-translate-api - Repository: https://github.com/plainheart/bing-translate-api - Homepage: https://github.com/plainheart/bing-translate-api#readme - Issues: https://github.com/plainheart/bing-translate-api/issues - npm.io page: https://npm.io/package/bing-translate-api ## Dependencies (1) - [got](https://npm.io/package/got.md) ^11.8.6 ## Alternatives - [@expo/fingerprint](https://npm.io/package/@expo/fingerprint.md) — 6.2M weekly downloads - [@azure/monitor-opentelemetry-exporter](https://npm.io/package/@azure/monitor-opentelemetry-exporter.md) — 850.0K weekly downloads - [@azure/monitor-opentelemetry](https://npm.io/package/@azure/monitor-opentelemetry.md) — 624.0K weekly downloads - [@posthog/ai](https://npm.io/package/@posthog/ai.md) — 423.3K weekly downloads - [fakefilter](https://npm.io/package/fakefilter.md) — 63.9K weekly downloads ## Recent versions - 4.3.0 (latest) — 2026-09-14 - 4.2.1 — 2026-08-01 - 4.2.0 — 2025-11-24 - 4.1.0 — 2025-07-06 - 4.0.2 — 2024-05-26 - 4.0.1 — 2024-03-13 - 4.0.0 — 2024-01-27 - 3.0.1 — 2024-01-27 - 3.0.0 — 2024-01-07 - 2.10.0 — 2023-11-18 - 2.9.2 — 2023-10-28 - 2.9.1 — 2023-04-22 - 2.9.0 — 2023-02-15 - 2.8.0 — 2023-01-20 - 2.7.0 — 2023-01-12 - … 15 more at https://npm.io/package/bing-translate-api/versions ## README # bing-translate-api [![NPM version](https://img.shields.io/npm/v/bing-translate-api.svg?style=flat)](https://www.npmjs.org/package/bing-translate-api) [![Auto Test](https://github.com/plainheart/bing-translate-api/actions/workflows/autotest.yml/badge.svg)](https://github.com/plainheart/bing-translate-api/actions/workflows/autotest.yml) [![NPM Downloads](https://img.shields.io/npm/dm/bing-translate-api.svg)](https://npmcharts.com/compare/bing-translate-api?minimal=true) [![License](https://img.shields.io/npm/l/bing-translate-api.svg)](https://github.com/plainheart/bing-translate-api/blob/master/LICENSE) A **simple** and **free** API for [Bing Translator](https://bing.com/translator) and [Microsoft Translator](https://learn.microsoft.com/azure/ai-services/translator/) for Node.js. ## Install ``` npm install bing-translate-api ``` ## Usage ### Microsoft Translator ✨ Available since `v4.0.0`. More stable and powerful than the Bing Translator, supporting both free and paid tiers. Check the [README](./src/met/README.md) for more details. ### Bing Translator From auto-detected language to English: ```js const { translate } = require('bing-translate-api'); translate('你好', null, 'en').then(res => { console.log(res.translation); }).catch(err => { console.error(err); }); ``` Translation result ```js { // original text "text": "你好", // user-specified language code "userLang": "auto-detect", // translated text "translation": "Hello", // `correctedText` is returned only when `correct` is set as `true` // supported since v1.1.0 "correctedText": "", // detected language "language": { // language code of translated text "to": "en", // detected language code of original text "from": "zh-Hans", // score of language detection // supported since v1.1.0 // (NOTICE: This field may not be provided at present) "score": 1 }, // feminine translation text (Only be returned when the translation result is gender-debiased) // supported since v4.1.0 "feminineTranslation": undefined, // masculine translation text (Only be returned when the translation result is gender-debiased) // supported since v4.1.0 "masculineTranslation": undefined } ``` ## API ### translate(text, [from], [to], [correct], [raw], [userAgent], [proxyAgents]) #### _text_ Type: `string` The text to be translated, can't be blank. The **maximum** text length is **1000**. **NOTE:** 1) The maximum text length is up to **5000** characters only in **China**. 2) In EPT mode (since `v3.0.0`), the maximum text length is currently **3000**. ##### _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.json](src/lang.json) **NOTE:** The EPT mode (since `v3.0.0`) only supports the languages contained in [src/config.json#eptLangs](src/config.json#L31). Any other language will fall back to the legacy mode, in which a 429 (Too Many Requests) error often occurs. ##### _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.json](src/lang.json). **NOTE:** The EPT mode (since `v3.0.0`) only supports the languages contained in [src/config.json#eptLangs](src/config.json#L31). Any other language will fall back to the legacy mode, in which a 429 (Too Many Requests) error often occurs. ##### _correct_ Type: `boolean` Default: `false` Since: `v1.1.0` Whether to correct the input text. Note that: 1) There is currently a **limit** of **50 characters** for correction service. 2) **Only** [the languages in the list](src/config.json#L9-L30) 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. Refer to [src/config.json#userAgent](src/config.json#L111) for the default user agent. ##### _proxyAgents_ Type: [`Got['Agents']`](https://github.com/sindresorhus/got/blob/v11.8.6/source/core/index.ts#L60-L64) Default: `undefined` Since: `v2.4.0` Set [agents](https://github.com/sindresorhus/got/blob/main/documentation/tips.md#proxying) of [`got`](https://github.com/sindresorhus/got) for proxy. ## License MIT © 2021-2026 [plainheart](https://github.com/plainheart). ## Thanks Great thanks to [Bing Translator](https://bing.com/translator) for providing such an excellent translation service. --- _Source: https://npm.io/package/bing-translate-api · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._