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:

Languague	Shortcode
Chinese	zh
Japanese	ja
Russian	ru
Persian	fa
Arabic	ar
Greek	el
Italian	it

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:

Example request

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

Example response

{
  "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

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