World Football/Soccer API v2 Documentation

Quick Guide

Availability

API FOOTBALL+

API FOOTBALL

API DEMO

COUNTRY_ID

LEAGUE_ID

CONTRACT_SEASON_ID

SEASON_ID

CLUB_ID & SEASON_ID

API Football+ (20 Leagues) Premier League, Serie A, La Liga, 1.Bundesliga, Ligue 1, Eredivisie, Championship, Primeira Liga, First Division A, Super Lig, MLS, Liga MX, Brasileiro, Primera Division, Categoria Primera A, 2.Bundesliga, La Liga 2, Serie B, Ligue 2, Scottish Premiership, Ukranian Premier League

API Football (10 Leagues) Premier League, Serie A, La Liga, 1.Bundesliga, Ligue 1, Eredivisie, Championship, Primeira Liga, First Division A, Super Lig

API Demo (10 Leagues) Premier League, Serie A, La Liga, 1.Bundesliga, Ligue 1, Eredivisie, Championship, Primeira Liga, First Division A, Super Lig

Contracts

Includes contract terms, expanded salary details, and additional player attributes
  • CLICK HERE TO VIEW DATA SAMPLE

    * also available in _GBP and _USD

Salaries

Includes basic salary details and player attributes
  • CLICK HERE TO VIEW DATA SAMPLE

    SEASON_ID: 2019-2020
    COUNTRY_ID: es
    LEAGUE_ID: la-liga
    LEAGUE_NAME: La Liga
    CLUB_ID: barcelona
    CLUB_NAME: Barcelona

    PLAYER_NAME: Lionel Messi
    PLAYER_ID: lionel-messi-31952
    PLAYER_AGE: 32
    PLAYER_DOB: 1987-06-24
    PLAYER_COUNTRY: Argentina
    PLAYER_COUNTRY_ID: argentina
    PLAYER_GROUP: Forward
    PLAYER_GROUP_CODE: F

    SALARY_GROSS: 71000000
    SALARY_NET: Hidden
    SALARY_CURRENCY: EUR
    SALARY_SYMBOL: €

    SALARY_GROSS_EUR: 71000000 *
    SALARY_NET_EUR: Hidden *
    ADJUSTED_GROSS_EUR: 71000000 *
    ADJUSTED_NET_EUR: Hidden *

    * also available in _GBP and _USD

Payrolls

Includes overall figures and breakdowns by position groups
  • CLICK HERE TO VIEW DATA SAMPLE

    SEASON_ID: 2013-2014
    SEASON_TERM: combined
    COUNTRY_ID: es
    LEAGUE_ID: la-liga
    LEAGUE_NAME: La Liga
    CLUB_ID: barcelona
    CLUB_NAME: Barcelona
    CLUB_CODE: FCB
    CLUB_COLOR_RGB: 168,19,62

    SALARY_GROSS_EUR: 178255000 *
    SALARY_GROSS_F_EUR: 48997000 *
    SALARY_GROSS_M_EUR: 75058000 *
    SALARY_GROSS_D_EUR: 39186000 *
    SALARY_GROSS_K_EUR: 15014000 *
    SALARY_NET_EUR: Hidden *
    SALARY_NET_F_EUR: Hidden *
    SALARY_NET_M_EUR: Hidden *
    SALARY_NET_D_EUR: Hidden *
    SALARY_NET_K_EUR: Hidden *
    ADJUSTED_GROSS_EUR: 184176061 *
    ADJUSTED_NET_EUR: Hidden *

    * also available in _GBP and _USD

Renewals

Includes renewed contract and salary details
  • CLICK HERE TO VIEW DATA SAMPLE

    SEASON_ID: 2019-2020
    COUNTRY_ID: uk
    LEAGUE_ID: premier-league
    LEAGUE_NAME: Premier League
    CLUB_ID: manchester-united
    CLUB_NAME: Manchester United

    PLAYER_NAME: Marcus Rashford
    PLAYER_ID: marcus-rashford-35734
    PLAYER_AGE: 22

    CONTRACT_RENEWAL: 2019-07-01
    CONTRACT_EXPIRATION: 2023-06-30
    CONTRACT_YEARS: 4
    CONTRACT_TOTAL_GROSS_EUR: *
    CONTRACT_TOTAL_NET_EUR: Hidden *

    SALARY_GROSS_EUR: 12155437 *
    SALARY_NET_EUR: Hidden *

    * also available in _GBP and _USD

Club_ID

Find all IDs and additional information for clubs in this sport/league
  • CLICK HERE TO VIEW DATA SAMPLE

    SEASON_ID: 2014-2015
    LEAGUE_ID: premier-league
    CLUB_ID:
    CLUB_NAME:
    CLUB_CODE:

Player_ID

Find all IDs and additional information for players in this sport/league
  • CLICK HERE TO VIEW DATA SAMPLE
    • CLICK HERE TO VIEW DATA SAMPLE

      ID: lionel-messi-31952
      FULL_NAME: Lionel Messi
      FIRST_NAME: Lionel
      SECOND_NAME: None
      THIRD_NAME: None
      LAST_NAME: Messi
      DOB: 1987-06-24
      NATIONALITY: Argentina
      NATIONALITY_ID: argentina
      POSITION: F