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.
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 |
The high-anticipated translations are now available for selected languages:
Languague | Shortcode |
---|---|
Chinese | zh |
Japanese | ja |
Russian | ru |
Persian | fa |
Arabic | ar |
Greek | el |
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.
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:
Example request
Example response
https://api.sportmonks.com/v3/football/livescores/inplay?api_token=YOURTOKEN&locale=ar
{
"data": [
{
"id": 18881507,
"sport_id": 1,
"league_id": 24,
"season_id": 21931,
"stage_id": 77465029,
"group_id": null,
"aggregate_id": null,
"round_id": null,
"state_id": 11,
"venue_id": null,
"name": "إبسويش واندرز ضد هيستون",
"starting_at": "2023-08-08 18:45:00",
"result_info": null,
"leg": "1/1",
"details": null,
"length": 90,
"placeholder": false,
"has_odds": false,
"starting_at_timestamp": 1691520300
},
{
"id": 18875447,
"sport_id": 1,
"league_id": 612,
"season_id": 21861,
"stage_id": 77464703,
"group_id": 249133,
"aggregate_id": null,
"round_id": 310453,
"state_id": 22,
"venue_id": null,
"name": "تشيرنيهيف ضد إنهوليتس.",
"starting_at": "2023-08-07 09:00:00",
"result_info": null,
"leg": "1/1",
"details": null,
"length": 90,
"placeholder": false,
"has_odds": true,
"starting_at_timestamp": 1691398800
},
///and more!
Important to note: if there is no translation available, the API will fall back on the default supported language: English
As mentioned, the translations are still in beta. You can contribute to the product by adding suggestions or improvements via my.sportmonks.
Last modified 13d ago