API - Web Service

API v2

API version 2 incorporates 7 more functions than the previous version and 4 payment options.

Basic
Current season
500 requests/day
€10,00 monthly
Extra
10 Last seasons
1.000 requests/day
€25,00 monthly
Premium
20 Last seasons
5.000 requests/day
€75,00 monthly
Gold
All
50.000 requests/day
€250,00 monthly

The monthly subscription can be canceled at any time through your Paypal account.

If you prefer a custom budget, please contact us by mail at bdfutbol@gmail.com or with the contact form

The BDFutbol API v2 is available at http://api.bdfutbol.com/v2. The requests are GET and the results are in JSON format.

User identification is done with basic PHP authorization with the username and password of your BDFutbol account.

Available requests:

RequestParameterDescription
Classificationtip=claGet the classification of a season
Resultstip=resGet the matches (played or not) of a season or team
Seasonstip=tempsGet the list of available seasons of a team
Squadtip=plaSquad with statistics of the players of a team in a season
Managerstip=plaeList with statistics of the coaches of a team in a season
Playertip=jugData of a player, and historical path
Managertip=entData of a coach, and historical path
Clubtip=eqData of a team
Matchtip=pFull data of a match
Searchtip=findSearch players, coaches and teams by name
Player gamestip=partsjList of matches of a player
Coach gamestip=partseList of matches of a coach
Team gamestip=partseqList of matches of a team
Team games against an opponenttip=partseqrList of matches of a team against another

Classification

Additional parameters:

ParameterDescription
catIdentifies the category. Possible values: '1a', '2a', '2aB1', '2aB2', '2aB3', '2aB4', 'eng', 'ger', 'ita', 'fra', 'por'.
tempIdentifies the season. Examples: '2005-06', '1999-00', etc.

Example

Result
{"status":1, "result":{"equipo":[{"posicion":"1","id_equipo":"1","nombre_equipo":"Barcelona","puntos":"91","pj":"38","pg":"29","pe":"4","pp":"5","gf":"112","gc":"29"},{"posicion":"2","id_equipo":"2","nombre_equipo":"Real Madrid","puntos":"90","pj":"38","pg":"28","pe":"6","pp":"4","gf":"110","gc":"34"}]}}

Results

Additional parameters:

ParameterDescription
catIdentifies the category. Possible values: '1a', '2a', '2aB1', '2aB2', '2aB3', '2aB4', 'eng', 'ger', 'ita', 'fra', 'por'.
tempIdentifies the season. Examples: '2005-06', '1999-00', etc.
equipoTeam identifier
cal (Optional)0: Only the matches played (by default), 1: Also the matches not played yet (for the current season)

Example

Result
{"status":1, "result":{"resultado":[{"id_partido":"28209","fecha":"24\/08\/2015","jornada":"1","id_local":"59","nombre_local":"Granada","id_visitante":"47","nombre_visitante":"Eibar","goles_local":"1","goles_visitante":"3","id_arbitro":"600018","nombre_arbitro":"Ignacio Iglesias Villanueva","estadio":"Estadio Nuevo Los Carmenes"}]}}

Seasons

Additional parameters:

ParameterDescription
equipoTeam identifier

Example

Result
{"status":1, "result":{"temporada":["1928-29","1929-30","1930-31","1994-95","1963-64","1964-65","1965-66","1967-68","1966-67"]}}

Squad

Additional parameters:

ParameterDescription
equipoTeam identifier
tempIdentifies the season. Examples: '2005-06', '1999-00', etc.

Example

Result
{"status":1, "result":{"jugador":[{"id":"19","apodo":"Adriano","pj":"8","min":"431","g":"0","ta":"0","tr":"0"},{"id":"159","apodo":"Iniesta","pj":"28","min":"2245","g":"1","ta":"2","tr":"0"}]}}

Managers

Additional parameters:

ParameterDescription
equipoTeam identifier
tempIdentifies the season. Examples: '2005-06', '1999-00', etc.

Example

Result
{"status":1, "result":{"entrenador":{"id":"1799","apodo":"Luis Enrique","pj":"38"}}}

Player

Additional parameters:

ParameterDescription
idPlayer Identifier

Example

Result
{"status":1, "result":{"apodo":"Carmelo","nombre":"Carmelo Espinosa Gil","fecha_nac":"1986-03-26","lugar_nac":"Talavera de la Reina","pais":"ES","posicion":"Mediocampista","altura":"165","peso":"60","trayectoria":{"item":[{"idequipo":"98","equipo":"Guijuelo","temporada":"2007-08","categoria":"2B","pj":"20","pt":"8","pc":"3","ps":"12","min":"934","ta":"3","tr":"0","g":"4"},{"idequipo":"98","equipo":"Guijuelo","temporada":"2008-09","categoria":"2B","pj":"16","pt":"4","pc":"0","ps":"12","min":"497","ta":"2","tr":"0","g":"1"}]}}}

Manager

Additional parameters:

ParameterDescription
idCoach identifier

Example

Result
{"status":1, "result":{"apodo":"Navarro","nombre":"Juan Navarro Clemente","fecha_nac":"1923-05-08","pais":"ES","trayectoria":{"item":[{"idequipo":"130","equipo":"Atlético Baleares","temporada":"1961-62","categoria":"2","pj":"8"},{"idequipo":"89","equipo":"Europa","temporada":"1966-67","categoria":"2","pj":"30"},{"idequipo":"89","equipo":"Europa","temporada":"1967-68","categoria":"2","pj":"25"},{"idequipo":"20","equipo":"Levante","temporada":"1973-74","categoria":"2","pj":"18"}]}}}

Club

Additional parameters:

ParameterDescription
idTeam identifier

Example

Result
{"status":1, "result":{"nombre":"Real Madrid","fundacion":"1902","ciudad":"Madrid","estadio":"Santiago Bernabéu","aforo":"80354"}}

Match

Additional parameters:

ParameterDescription
idTeam identifier

Example

Result
{"status":1, "result":{"id":"9013","temporada":"1969-70","categoria":"1a","jornada":"15","idequipolocal":"1","idequipovisitante":"42","nombreequipolocal":"Barcelona","nombreequipovisitante":"Elche","goleslocal":"1","golesvisitante":"1","estadio":"Nou Camp","fecha":"21\/12\/1969","arbitro":"Fernando Pascual Tejerina","alineacionlocal":{"entrenador":{"id":"9740","nombre":"Seguer"},"jugadores":{"jugador":[{"tipo":"T","id":"5055"},{"tipo":"T","id":"5428"},{"tipo":"T","id":"5130"},{"tipo":"T","id":"5960"},{"tipo":"T","id":"6000"},{"tipo":"T","id":"5417"},{"tipo":"T","id":"5418"},{"tipo":"T","id":"5053"},{"tipo":"T","id":"5941"},{"tipo":"T","id":"5749","eventos":{"evento":{"tipo":"G","minuto":"52","id":"5749"}}},{"tipo":"T","id":"3936"}]}},"alineacionvisitante":{"entrenador":{"id":"8435","nombre":"Máspoli"},"jugadores":{"jugador":[{"tipo":"T","id":"5839"},{"tipo":"S","id":"5424"},{"tipo":"T","id":"7209","cambio":{"id":"5424","minuto":"77"}},{"tipo":"T","id":"6030"},{"tipo":"T","id":"5422"},{"tipo":"T","id":"7608"},{"tipo":"T","id":"5357"},{"tipo":"T","id":"8080"},{"tipo":"T","id":"5968"},{"tipo":"T","id":"6038"},{"tipo":"T","id":"3934","eventos":{"evento":{"tipo":"G","minuto":"63","id":"3934"}}},{"tipo":"S","id":"5667"},{"tipo":"T","id":"6029","cambio":{"id":"5667","minuto":"56"}}]}}}}

Search

Additional parameters:

ParameterDescription
qText to search (Ex: Messi)
typeType of search (1: Players, 2: Coaches, 3: Referees, 4: Teams)
dat (Optional)Date of birth (format dd/mm/yyyy)
pais (Optional)Country of birth (Ex: Nigeria)
club (Optional)Team where the player has been (Ex: Betis)
temp (Optional)Season where he played in 1a, 2a or 2aB (Ex: '2015-16')

Example

Result
{"status":1, "result":{"result":{"id":"1753","apodo":"Messi","nombre":"Lionel Andrés","apellido1":"Messi","apellido2":"Cuccittini"}}}

Player games

Additional parameters:

ParameterDescription
jugPlayer Identifier
tempIdentifies the season. Examples: '2005-06', '1999-00', etc.
equipoTeam identifier

Example

Result
{"status":1, "result":{"partido":[{"id_partido":"401098","fecha":"23\/02\/2010","nombre_local":"Stuttgart","nombre_visitante":"Barcelona","id_local":"-1","id_visitante":"1","goles_local":"1","goles_visitante":"1"},{"id_partido":"25818","fecha":"14\/02\/2010","nombre_local":"Atlético de Madrid","nombre_visitante":"Barcelona","id_local":"7","id_visitante":"1","goles_local":"2","goles_visitante":"1"}]}}

Coach games

Additional parameters:

ParameterDescription
entCoach identifier
tempIdentifies the season. Examples: '2005-06', '1999-00', etc.
equipoTeam identifier

Example

Result
{"status":1, "result":{"partido":[{"id_partido":"28942","fecha":"14\/05\/2017","nombre_local":"Betis","nombre_visitante":"Atlético de Madrid","id_local":"8","id_visitante":"7","goles_local":"1","goles_visitante":"1"},{"id_partido":"28951","fecha":"20\/05\/2017","nombre_local":"Sporting de Gijón","nombre_visitante":"Betis","id_local":"34","id_visitante":"8","goles_local":"2","goles_visitante":"2"}]}}

Team games

Additional parameters:

ParameterDescription
tempIdentifies the season. Examples: '2005-06', '1999-00', etc.
equipoTeam identifier
cat (Optional)Identifies the category. Possible values: '1a', '2a', '2aB1', '2aB2', '2aB3', '2aB4', 'eng', 'ger', 'ita', 'fra', 'por'.

Example

Result
{"status":1, "result":{"resultado":[{"id_partido":"28208","fecha":"23\/08\/2015","jornada":"1","id_local":"8","nombre_local":"Betis","id_visitante":"38","nombre_visitante":"Villarreal","goles_local":"1","goles_visitante":"1","id_arbitro":"600495","nombre_arbitro":"Iñaki Bikandi Garrido","estadio":"Benito Villamarín"}]}}

Team games against an opponent

Additional parameters:

ParameterDescription
equipoTeam identifier
rivTeam identifier
temp (Optional)Identifies the season. Examples: '2005-06', '1999-00', etc.
cat (Optional)Identifies the category. Possible values: '1a', '2a', '2aB1', '2aB2', '2aB3', '2aB4', 'eng', 'ger', 'ita', 'fra', 'por'.

Example

Result
{"status":1, "result":{"resultado":[{"id_partido":"28364","fecha":"30\/12\/2015","jornada":"17","id_local":"1","nombre_local":"Barcelona","id_visitante":"8","nombre_visitante":"Betis","goles_local":"4","goles_visitante":"0","id_arbitro":"600495","nombre_arbitro":"Iñaki Bikandi Garrido","estadio":"Camp Nou"},{"id_partido":"28553","fecha":"30\/04\/2016","jornada":"36","id_local":"8","nombre_local":"Betis","id_visitante":"1","nombre_visitante":"Barcelona","goles_local":"0","goles_visitante":"2","id_arbitro":"600014","nombre_arbitro":"Antonio Miguel Mateu Lahoz","estadio":"Benito Villamarín"}]}}

User Manual

In the following link you will find a more detailed description of the API specification and all the available queries, and the format of the resulting files.: http://api.bdfutbol.com/v2/api2.pdf

Last update: 03/12/2018