polylingo (Node.js)

TypeScript / Node.js client for the PolyLingo translation API.

Requires Node.js 18+.

Install

npm install polylingo

Quick start

import PolyLingo from 'polylingo'

const client = new PolyLingo({
  apiKey: process.env.POLYLINGO_API_KEY!,
  // baseURL: 'https://api.usepolylingo.com/v1',
  // timeout: 120_000,
})

const r = await client.translate({
  content: '# Hello',
  targets: ['es', 'fr'],
  format: 'markdown',
})
console.log(r.translations.es)

API

Method	Notes
client.health()	GET /health
client.languages()	GET /languages
client.translate({ ... })	POST /translate
client.batch({ ... })	POST /translate/batch
client.usage()	GET /usage
client.jobs.create(...)	POST /jobs (202)
client.jobs.get(jobId)	GET /jobs/:id
client.jobs.translate({ ... })	Submit job, poll until done (pollInterval, timeout, onProgress)

Errors

PolyLingoError is the base type (status, error, message). Subclasses: AuthError (401), RateLimitError (429, optional retryAfter), JobFailedError (failed job, includes jobId).

Documentation

Node SDK on usepolylingo.com

Repository

github.com/UsePolyLingo/polylingo-node

License

MIT