Detect Language API Node.js Client

Node.js client for the Detect Language API.

Installation

npm install detectlanguage [--save]

Upgrading

When upgrading please check changelog for breaking changes.

Configuration

Before using Detect Language API client you have to setup your personal API key. You can get it by signing up at detectlanguage.com

var DetectLanguage = require('detectlanguage');

var detectlanguage = new DetectLanguage('YOUR API KEY');

Usage

Language Detection

Takes a text string and returns a list of detections.

var text = "Hello! How are you?";

detectlanguage.detect(text).then(function(result) {
  console.log(JSON.stringify(result));
});

Response

[{"language":"en","score":0.9955}]

Batch Detection (recommended)

Takes an array of texts and returns a list of detections. It is much faster than doing request for each text individually.

var texts = ['šešios žąsys', 'Strč prst skrz krk'];

detectlanguage.detectBatch(texts).then(function(result) {
  console.log(JSON.stringify(result));
});

Response

[
  [
    {
      "language": "lt",
      "score": 0.8696
    }
  ],
  [
    {
      "language": "cs",
      "score": 0.3653
    },
    ...
  ]
]

Language Code Detection

Returns first detected language code.

var text = "Hello! How are you?";

detectlanguage.detectCode(text).then(function(result) {
  console.log(JSON.stringify(result));
});

Response

"en"

Supported Languages

Returns the list of supported languages.

detectlanguage.languages().then(function(result) {
  console.log(JSON.stringify(result));
});

Response

[
  {
    "code": "aa",
    "name": "Afar"
  },
  {
    "code": "ab",
    "name": "Abkhazian"
  },
  ...
]

Account Status

Returns information about your account and it's status.

detectlanguage.accountStatus().then(function(result) {
  console.log(JSON.stringify(result));
});

Response

{
  date: "2020-01-01",
  requests: 31,
  bytes: 429,
  plan: "FREE",
  plan_expires: null,
  daily_requests_limit: 1000,
  daily_bytes_limit: 1048576,
  status: "ACTIVE"
}

Author

Laurynas Butkus (GitHub)

License

Licensed under the MIT License: https://opensource.org/licenses/MIT