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

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

The API release history

The following table lists the Translation API releases:

Release Version

Release Date

Description of Release

v1_beta.1.5 2022-10-03
  • Changed maximum number of characters for description to 20,000 excluding markup/tags
  • Added support for German to Polish and Polish to German translation
  • Edited error message 110007
  • Added error message 110008
v1_beta.1.4 2020-11-10 English text may now be translated into either Portuguese or Russian, and German text can be translated into English
v1_beta.1.3 2020-07-08 English and German text may now be translated into either French, Italian, or Spanish
v1_beta.1.2 2020-06-08 Added support for English-to-Japanese translations
v1_beta.1.1 2020-06-08
  • Updated translation context support
  • Updated text field string length
v1_beta.1.0 2020-01-14 Added item description for English-to-Chinese translations
v1_beta.0.0 2019-11-08 Initial API release

v1_beta.1.5

The following changes were made in this release.

Change in the maximum length of the description

The maximum length for the ITEM_DESCRIPTION was changed from 100,000 characters (including markup/tags). To 20,000 characters (excluding markup/tags).

Added support for Polish and German translation

You can now translate German into Polish and Polish into German.

Edited error message 110007

The error message was changed from Markups are not supported in input texts to Markups are not supported in input texts for title translation context.

Added error message 110008

This new error message is returned when the input text is missing.

v1_beta.1.4

The following changes were made in this release.

Three new translations supported

English text may now be translated into either Portuguese or Russian. German text may now be translated into English.

New enumeration values added

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

  • pt (Portuguese)
  • ru (Russian)

v1_beta.1.3

The following changes were made in this release.

Six new translations supported

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

New enumeration values added

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

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

v1_beta.1.2

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.

v1_beta.1.1

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.

v1_beta.1.0

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.

v1_beta.0.0

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