API: Import translations

Last modified: March 28, 2021Author: Jakub Pomykała

Import translations from a file. Check 'Import options' section to learn more about possibilities. Using this endpoint requires authorization.

POST Endpoint

https://api.simplelocalize.io/api/v2/import?uploadFormat=

Example cURL

curl
    --request POST \
    --url 'https://api.simplelocalize.io/api/v2/import?uploadFormat=multi-language-json' \
    --header 'x-simplelocalize-token: <API_KEY>' \
    --form file=@/path/to/your/file.json

Available upload formats

uploadFormat Description
multi-language-json one JSON file with multiple languages
single-language-json JSON file with one language (use languageKey param to specify language)
simplelocalize-json JSON format prepared for integration purposes
excel Microsoft Excel spreadsheet in *.xlsx format
csv , or ; separated translation keys
yaml yaml file format
android XML Resource Strings file
localizable-strings Localizable.strings file format
java-properties Java properties file

Available import options

Use query param importOptions to do invoke custom logic after or during the import. You can pass more than one import option. If you need more import options let us know: [email protected]

importOptions Description
REPLACE_TRANSLATION_IF_FOUND Replaces translation for key if the key already exists. Without this option SimpleLocalize will only add new translations.
PUBLISH_AFTER_IMPORT Translations will be published automatically to the CDN after successful import. Option available only in Developer and Team plan. Check also how to publish translations using API endpoint

Deprecated endpoints

POST Deprecated endpoint (2021-01-24)

https://api.simplelocalize.io/api/v1/import

POST Deprecated endpoint (2019-12-10)

https://api.simplelocalize.io/api/v1/files