translation APIv1_beta.1.3

Translation API release notes

Just getting started with the Translation API? See the following documents for details on using this API:

See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

The API release history

The following table lists the Marketplace Insights API releases:

Release Version

Release Date

Description of Release

Version 1_beta.1.3 2020-07-08 English and German text may now be translated into either French, Italian, or Spanish
Version 1_beta.1.2 2020-06-08 English to Japanese translations now supported.
Version 1_beta.1.1 2020-06-08
  • Updated translation context support
  • Updated text field string length
Version 1_beta.1.0 2020-01-14 Added item description translation from English to Chinese
Version 1_beta.0.0 2019-11-08 Initial API release


The following changes were made in this release.

Six new translations now supported

English and German text may now be translated into either French, Italian, or Spanish.

New enumeration values added to LanguageEnum type

To support the new translations, the following values were added to LanguageEnum type:

  • fr (French)
  • it (Italian)
  • es (Spanish)


The following change was made in this release.

English to Japanese translations now supported

English to Japanese translations are now supported. Since Japanese to English translations were already supported, and ja was already a value in the LanguageEnum type, there were no schema updates necessary for this release.


The following sections describe the change made in this release.

Updated translation context support

Translations from English to German, and from Japanese to English, now support the ITEM_DESCRIPTION LanguageEnum type.

Updated text field string length

The maximum string length for the ITEM_TITLE enumeration value has been increased to 1,000 characters. The maximum string length for the ITEM_DESCRIPTION enumeration value remains at 100,000 characters.


You can now translate the description of the item from English to Chinese. To support this, the ITEM_DESCRIPTION enumeration value was added to the LanguageEnum type.


This is the initial release of this API.

There is only one method for the initial release. Use this call to translate strings related to items listed for sale.

POST /commerce/translation/v1_beta/translate