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

Spanish

es

French

fr

Hungarian

hu

German

de

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

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

PreviousCode libraries NextDemo response files

Last updated 9 months ago

Was this helpful?

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