| 2025 | 2015 | 2005 |
| 2024 | 2014 | 2004 |
| 2023 | 2013 | 2003 |
| 2022 | 2012 | 2002 |
| 2021 | 2011 | 2001 |
| 2020 | 2010 | |
| 2019 | 2009 | |
| 2018 | 2008 | |
| 2017 | 2007 | |
| 2016 | 2006 |
| 2024-25 | 2014-15 | 2004-05 |
| 2023-24 | 2013-14 | 2003-04 |
| 2022-23 | 2012-13 | 2002-03 |
| 2021-22 | 2011-12 | |
| 2020-21 | 2010-11 | |
| 2019-20 | 2009-10 | |
| 2018-19 | 2008-09 | |
| 2017-18 | 2007-08 | |
| 2016-17 | 2006-07 | |
| 2015-16 | 2005-06 |
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:
| Request | Parameter | Description |
|---|---|---|
| Classification | tip=cla | Get the classification of a season |
| Results | tip=res | Get the matches (played or not) of a season or team |
| Seasons | tip=temps | Get the list of available seasons of a team |
| Squad | tip=pla | Squad with statistics of the players of a team in a season |
| Managers | tip=plae | List with statistics of the coaches of a team in a season |
| Player | tip=jug | Data of a player, and historical path |
| Manager | tip=ent | Data of a coach, and historical path |
| Club | tip=eq | Data of a team |
| Match | tip=p | Full data of a match |
| Search | tip=find | Search players, coaches and teams by name |
| Player games | tip=partsj | List of matches of a player |
| Coach games | tip=partse | List of matches of a coach |
| Team games | tip=partseq | List of matches of a team |
| Team games against an opponent | tip=partseqr | List of matches of a team against another |
Additional parameters:
| Parameter | Description |
|---|---|
| cat | Identifies the category. Possible values: '1a', '2a', '1rf1, '1rf2', '2aB1', '2aB2', '2aB3', '2aB4', '2aB5', 'eng', 'ger', 'ita', 'fra', 'por', 'hol'. |
| temp | Identifies the season. Examples: '2005-06', '1999-00', etc. |
Example
{"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"}]}}
Additional parameters:
| Parameter | Description |
|---|---|
| cat | Identifies the category. Possible values: '1a', '2a', '1rf1, '1rf2', '2aB1', '2aB2', '2aB3', '2aB4', '2aB5', 'eng', 'ger', 'ita', 'fra', 'por', 'hol'. |
| temp | Identifies the season. Examples: '2005-06', '1999-00', etc. |
| equipo | Team identifier |
| cal (Optional) | 0: Only the matches played (by default), 1: Also the matches not played yet (for the current season) |
Example
{"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"}]}}
Additional parameters:
| Parameter | Description |
|---|---|
| equipo | Team identifier |
Example
{"status":1, "result":{"temporada":["1928-29","1929-30","1930-31","1994-95","1963-64","1964-65","1965-66","1967-68","1966-67"]}}
Additional parameters:
| Parameter | Description |
|---|---|
| equipo | Team identifier |
| temp | Identifies the season. Examples: '2005-06', '1999-00', etc. |
Example
{"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"}]}}
Additional parameters:
| Parameter | Description |
|---|---|
| equipo | Team identifier |
| temp | Identifies the season. Examples: '2005-06', '1999-00', etc. |
Example
{"status":1, "result":{"entrenador":{"id":"1799","apodo":"Luis Enrique","pj":"38"}}}
Additional parameters:
| Parameter | Description |
|---|---|
| id | Player Identifier |
Example
{"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"}]}}}
Additional parameters:
| Parameter | Description |
|---|---|
| id | Coach identifier |
Example
{"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"}]}}}
Additional parameters:
| Parameter | Description |
|---|---|
| id | Team identifier |
Example
{"status":1, "result":{"nombre":"Real Madrid","fundacion":"1902","ciudad":"Madrid","estadio":"Santiago Bernabéu","aforo":"80354"}}
Additional parameters:
| Parameter | Description |
|---|---|
| id | Team identifier |
Example
{"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"}}]}}}}
Additional parameters:
| Parameter | Description |
|---|---|
| q | Text to search (Ex: Messi) |
| type | Type 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
{"status":1, "result":{"result":{"id":"1753","apodo":"Messi","nombre":"Lionel Andrés","apellido1":"Messi","apellido2":"Cuccittini"}}}
Additional parameters:
| Parameter | Description |
|---|---|
| jug | Player Identifier |
| temp | Identifies the season. Examples: '2005-06', '1999-00', etc. |
| equipo | Team identifier |
Example
{"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}]}}
Additional parameters:
| Parameter | Description |
|---|---|
| ent | Coach identifier |
| temp | Identifies the season. Examples: '2005-06', '1999-00', etc. |
| equipo | Team identifier |
Example
{"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"}]}}
Additional parameters:
| Parameter | Description |
|---|---|
| temp | Identifies the season. Examples: '2005-06', '1999-00', etc. |
| equipo | Team identifier |
| cat (Optional) | Identifies the category. Possible values: '1a', '2a', '1rf1, '1rf2', '2aB1', '2aB2', '2aB3', '2aB4', '2aB5', 'eng', 'ger', 'ita', 'fra', 'por', 'hol'. |
Example
{"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"}]}}
Additional parameters:
| Parameter | Description |
|---|---|
| equipo | Team identifier |
| riv | Team 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
{"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"}]}}
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
