Current Version

The current API version is v1.

Available Variables in the API

API Calls

{store}/storelocales/

Description:

This call will list all the locales that the store supports.

Examples:

{store}/localesmapping/

Description:

Lists the mapping of locale codes between the store and Mozilla locale codes.

Examples:

Notes:

{product}/supportedlocales/{channel}/

Description:

List all locale codes supported by product for the requested channel.

Example:

All Firefox for Android locales on the release channel: http://l10n.mozilla-community.org/stores_l10n/api/v1/fx_android/supportedlocales/release/

{product}/listing/{channel}/

Description:

List all the locales for which the store description page is fully translated for a channel. A locale is listed as done if the translation is complete and there are no strings longer than the store limits.

Example:

{product}/whatsnew/{channel}/

Description:

List all the locales for which the what's new section is fully translated for a channel. A locale is listed as done if the translation is complete and there are no strings longer than the section limit.

Example:

{product}/done/{channel}/

Description:

List all the locales for which all files needed are fully translated for a channel. A locale is listed as done if the translation is complete and there are no strings exceeding the store limits. In the case of Google, for the release channel this API returns the locales that have translated both the listing page on Google Play and the Whatsnew page.

Example:

{product}/translation/{channel}/{locale}/

Description:

Return the translation for a page listing for the store and channel selected.

Examples:

Translation of the Google Play listing for Japanese, release channel: http://l10n.mozilla-community.org/stores_l10n/api/v1/fx_android/translation/release/ja/

Output for Google Play:

{
    "title": "Blabla",
    "short_desc": "Blabla",
    "long_desc": "Blabla",
    "whatsnew": "Blabla"
}

Translation of Firefox for iOS listing for French: http://l10n.mozilla-community.org/stores_l10n/api/v1/fx_ios/translation/release/fr/

Output for Apple App Store:

{
    "title": "Blabla",
    "description": "Blabla",
    "keywords": "Blabla",
    "screenshots": [
        {
            "title": "Title for screenshot 1",
            "text": "Text for \nscreenshot 1,\n note the line breaks"

        },
        {
            "title": "Title for screenshot 2",
            "text": "Text for \nscreenshot 2,\n note the line breaks"
        }
    ]
}

Notes

  1. Invalid API calls return a 400 HTTP error and a json file explaining the problem with this format:
    {
        "error": "Explanation of the error"
    }
  2. If you find a bug or would like an improvement to the API, please file an issue on Github.