Skip to main content

Leagues Info​

This endpoint allows you to retrieve the info from leagues and cups.

Multi-language: This feature allows the user to manually change the language of the API response by adding value to the lang attribute. Example: lang=en.

Pagination: The endpoint uses an offset and limit system. Specify the offset and limit parameters to fetch the desired range of results. The maximum and default number of results per request is 50.

Update Period: The endpoint is updated several times a day.
Recommended Calls: Limit calls to 1 every day.

Use Cases​

Get league info from a specific league_id
https://football.sportdevs.com/leagues-info?league_id=eq.{league_id}

Query Parameters
  • league_id integer

    Default value: eq.1

    The id of the league

  • offset string

    Default value: 0

    Limiting and Pagination

  • limit string

    Default value: 50

    Limiting and Pagination

  • lang string

    Default value: en

    Multi-language

Responses

OK

Schema array
  • league_id integer

    The id of the league

    Note: This is a Primary Key.

  • promoted_teams jsonb

    The promoted teams

  • most_title_names jsonb

    The teams with most titles

  • number_of_teams integer

    The number of the teams in the league

  • league_grade text

    The grade of the league

  • age_category text

    The age class of the league

  • first_season_winner text

    The first season winner of the league

  • total_teams_count integer

    The count of the teams in the league

  • total_tables_count integer

    The count of the tables in the league

  • promoting_teams_count text

    The count of the promoting teams in the league

  • relegating_teams_count integer

    The count of the relegating teams in the league

  • total_games_count integer

    The count of the games in the league

  • game_frequency integer

    The frequency of the league

  • total_rounds_count integer

    The count of the rounds in the league

  • competition_type text

    The type of the competition

  • league_gender text

    The gender people playing in the league

  • first_season_start_year text

    First season start year

  • most_popular_teams jsonb

    The name of the most popular teams in the league

  • playoff_teams_count integer

    The number of the teams playing in the playoffs

  • main_competition text

    The main competition

  • games_per_group text

    The number of the games per group

  • playoff_qualifying_teams_count integer

    The count of the teams that are qualified to play in the playoffs

  • number_of_promoted_teams integer

    The number of promoted teams

  • total_number_of_rounds integer

    The number of rounds

  • largest_stadium jsonb

    The largest stadium

  • last_season_magnitude jsonb

    The last season magnitude

  • tv_partners jsonb

    The tv partners of the league

  • official_organization jsonb

    The official organisation of the league

  • promotions jsonb

    The promotions

  • last_season_top_scorers jsonb

    The last season top scorers in the league

Loading...