MachineTranslation.com API Documentation

Translate plain text from one language to another.

HTTP Request

Headers

Authorization: BEARER <your_api_key>
Content-Type: application/json

Request Body

{
  "text": "The text you want to translate",
  "source_language_code": "en",
  "target_language_code": "fr"
}

Example Request

curl --location 'https://api.machinetranslation.com/pv1/translate' \
  --header 'Authorization: BEARER <your_api_key>' \
  --header 'Content-Type: application/json' \
  --data '{
    "text": "MachineTranslation.com translates, compares, and recommends the best translations.",
    "source_language_code": "en",
    "target_language_code": "fr"
  }'

Response Example

{
  "translations": [
    {
      "engine": "google",
      "share_id": "cf733e14-ea86-4f6b-92fc-de9813197601",
      "source_text": "MachineTranslation.com translates, compares, and recommends the best translations.",
      "target_text": "MachineTranslation.com traduit, compare et recommande les meilleures traductions.",
      "source_word_count": 8,
      "target_word_count": 8,
      "source_language_code": "en",
      "target_language_code": "fr"
    }
  ],
  "meta": {
    "short_url": "https://machinetranslation.com/translations/cf733e14-ea86-4f6b-92fc-de9813197601",
    "total_words": 8
  }
}

Response Fields

• translations: Array of translation results from different engines
• engine: Translation engine used
• share_id: Unique ID for the translation
• source_text: Original text
• target_text: Translated text
• source_word_count: Word count of source text
• target_word_count: Word count of translated text
• source_language_code: Source language code
• target_language_code: Target language code
• meta.short_url: Shareable URL
• meta.total_words: Total word count

Translate a .json file while preserving its original structure.

• JSON keys and structure are preserved
• Only string values are translated
• Numbers, booleans, arrays, and objects remain unchanged

HTTP Request

Headers

Authorization: BEARER <your_api_key>
Content-Type: multipart/form-data

Request Body (form-data)

Example Request

curl --location 'https://api.machinetranslation.com/pv1/translate/file' \
  --header 'Authorization: BEARER <your_api_key>' \
  --form 'file=@"/path/to/file.json"' \
  --form 'source_language_code="en"' \
  --form 'target_language_code="fr"'

Response Example

{
  "translated_json": {
    "title": "Texte traduit",
    "description": "La structure JSON originale est conservée"
  },
  "source_language_code": "en",
  "target_language_code": "fr"
}

Notes

• The response returns a translated_json object with the same structure as the uploaded file.