Translations (beta)

Welcome to the API Translations documentation! Here, we'll explore how you can enhance the user experience of your application by incorporating localised content using Sportmonks Football API. By utilising powerful translation capabilities, you can provide content in your preferred language: increasing the user experience of your football application. Let’s dive in on what can be translated and how it works.

Which API fields are translated?

Our Football API 3.0 now supports translations for entities with textual fields (e.g names). Currently, you can find translations for the below list of entities. Please keep in mind that we are still translating and we are working on enriching the list.

Entities

city

continent

country

fixture

group

league

player

stage

team

type

venue

Which languages are supported?

The high-anticipated translations are now available for selected languages:

LanguagueShortcode

Chinese

zh

Japanese

ja

Russian

ru

Persian

fa

Arabic

ar

Greek

el

Italian

it

Spanish

es

French

fr

Hungarian

hu

German

de

Please note: The feature is still in beta; other languages will be added soon. Spanish, Portuguese and French are at the top of our backlog. Interested in another language? Let us know.

How does it work?

Integrating translations is seamless. Utilise the locale parameter with the shortcode of the desired country to fetch content in the preferred language. The Football API will respond with translated data, efficiently presenting relevant information to your users. For example, from the livescores endpoint, you want to display the team names in Arabic:

https://api.sportmonks.com/v3/football/livescores/inplay?api_token=YOURTOKEN&locale=ar

Important to note: if there is no translation available, the API will fall back on the default supported language: English

Do you have any suggestions or improvements?

As mentioned, the translations are still in beta. You can contribute to the product by adding suggestions or improvements via my.sportmonks.

Try it out, share your feedback, and contribute to its refinement on my.sportmonks

Last updated