ENMore
2023-242013-142003-041993-941983-841973-741963-64 121953-54 121943-441933-34
2022-232012-132002-031992-931982-831972-731962-63 121952-53 121942-43 1231932-33
2021-222011-122001-021991-921981-821971-721961-62 121951-52 121941-42 1231931-32
2020-212010-112000-011990-911980-811970-711960-61 121950-51 121940-41 121930-31
2019-202009-101999-001989-901979-801969-701959-60 121949-50 121939-40 123451929-30
2018-192008-091998-991988-891978-791968-691958-59 121948-491928-29 12
2017-182007-081997-981987-881977-781967-68 121957-58 121947-48
2016-172006-071996-971986-871976-771966-67 121956-57 121946-47
2015-162005-061995-961985-861975-761965-66 121955-56 121945-461935-36 123
2014-152004-051994-951984-851974-751964-65 121954-55 121944-451934-35 123
2023-24 IIIIIIIVV2013-14 IIIIIIIV2003-04 IIIIIIIV1993-94 IIIIIIIV1983-84 III
2022-23 IIIIIIIVV2012-13 IIIIIIIV2002-03 IIIIIIIV1992-93 IIIIIIIV1982-83 III
2021-22 IIIIIIIVV2011-12 IIIIIIIV2001-02 IIIIIIIV1991-92 IIIIIIIV1981-82 III
2020-21 IIIIIIIVV2010-11 IIIIIIIV2000-01 IIIIIIIV1990-91 IIIIIIIV1980-81 III
2019-20 IIIIIIIV2009-10 IIIIIIIV1999-00 IIIIIIIV1989-90 IIIIIIIV1979-80 III
2018-19 IIIIIIIV2008-09 IIIIIIIV1998-99 IIIIIIIV1988-89 IIIIIIIV1978-79 III
2017-18 IIIIIIIV2007-08 IIIIIIIV1997-98 IIIIIIIV1987-88 IIIIIIIV1977-78 III
2016-17 IIIIIIIV2006-07 IIIIIIIV1996-97 IIIIIIIV1986-87
2015-16 IIIIIIIV2005-06 IIIIIIIV1995-96 IIIIIIIV1985-86 III
2014-15 IIIIIIIV2004-05 IIIIIIIV1994-95 IIIIIIIV1984-85 III

Data Service

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', '1rf1, '1rf2', '2aB1', '2aB2', '2aB3', '2aB4', '2aB5', 'eng', 'ger', 'ita', 'fra', 'por', 'hol'.
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', '1rf1, '1rf2', '2aB1', '2aB2', '2aB3', '2aB4', '2aB5', 'eng', 'ger', 'ita', 'fra', 'por', 'hol'.
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","minutos":90}]}}

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', '1rf1, '1rf2', '2aB1', '2aB2', '2aB3', '2aB4', '2aB5', 'eng', 'ger', 'ita', 'fra', 'por', 'hol'.

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', '1rf1, '1rf2', '2aB1', '2aB2', '2aB3', '2aB4', '2aB5', 'eng', 'ger', 'ita', 'fra', 'por', 'hol'.

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. Español: http://api.bdfutbol.com/v2/api2.pdf. English: http://api.bdfutbol.com/v2/api2-en.pdf