API - Web Service

API v2

La versión 2 de la API incorpora 7 funciones más que la anterior versión y 4 modalidades de suscripción.

Basic
Temporada en curso
500 peticiones/día
€10,00 mensualmente
Extra
10 Últimas temporadas
1.000 peticiones/día
€25,00 mensualmente
Premium
20 Últimas temporadas
5.000 peticiones/día
€75,00 mensualmente
Gold
Todas
50.000 peticiones/día
€250,00 mensualmente

La suscripción mensual se puede cancelar en cualquier momento desde su cuenta de Paypal.

Si prefiere un presupuesto a medida contacte con nosotros por correo bdfutbol@gmail.com o mediante el formulario de contacto

La API v2 de BDFutbol se encuentra en la dirección http://api.bdfutbol.com/v2. Las peticiones son de tipo GET y los resultados en formato JSON.

La identificación de usuario se realiza con autorización de PHP Básica con el nombre de usuario y contraseña de su cuenta en BDFutbol.

Peticiones disponibles:

PeticiónParámetroDescripción
Clasificacióntip=claObtener la clasificación de una temporada
Resultadostip=resObtener los partidos (jugados o no) de una temporada o equipo
Temporadastip=tempsObtener el listado de temporadas disponibles de un equipo
Plantillatip=plaPlantilla con estadísticas de los jugadores de un equipo en una temporada
Entrenadorestip=plaeListado con estadísticas de los entrenadores de un equipo en una temporada
Jugadortip=jugDatos de un jugador, y trayectoria histórica
Entrenadortip=entDatos de un entrenador, y trayectoria histórica
Equipotip=eqDatos de un equipo
Partidotip=pFicha técnica de un partido
Búsquedatip=findBuscar jugadores, entrenadores y equipos por nombre
Partidos jugadortip=partsjListado de partidos de un jugador
Partidos entrenadortip=partseListado de partidos de un entrenador
Partidos equipotip=partseqListado de partidos de un equipo
Partidos equipo contra rivaltip=partseqrListado de partidos de un equipo contra otro

Clasificación

Parámetros adicionales:

ParámetroDescripción
catIdentifica la categoría. Valores posibles: '1a', '2a', '2aB1', '2aB2', '2aB3', '2aB4', 'eng', 'ger', 'ita', 'fra', 'por'.
tempIdentifica la temporada. Ejemplos: '2005-06', '1999-00', etc.

Ejemplo

Resultado
{"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"}]}}

Resultados

Parámetros adicionales:

ParámetroDescripción
catIdentifica la categoría. Valores posibles: '1a', '2a', '2aB1', '2aB2', '2aB3', '2aB4', 'eng', 'ger', 'ita', 'fra', 'por'.
tempIdentifica la temporada. Ejemplos: '2005-06', '1999-00', etc.
equipoIdentificador del equip
cal (Opcional)0: Únicamente los partidos disputados (por defecto), 1: También los partidos no disputados aún (para la temporada en curso)

Ejemplo

Resultado
{"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"}]}}

Temporadas

Parámetros adicionales:

ParámetroDescripción
equipoIdentificador del equip

Ejemplo

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

Plantilla

Parámetros adicionales:

ParámetroDescripción
equipoIdentificador del equip
tempIdentifica la temporada. Ejemplos: '2005-06', '1999-00', etc.

Ejemplo

Resultado
{"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"}]}}

Entrenadores

Parámetros adicionales:

ParámetroDescripción
equipoIdentificador del equip
tempIdentifica la temporada. Ejemplos: '2005-06', '1999-00', etc.

Ejemplo

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

Jugador

Parámetros adicionales:

ParámetroDescripción
idIdentificador del jugador

Ejemplo

Resultado
{"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"}]}}}

Entrenador

Parámetros adicionales:

ParámetroDescripción
idIdentificador del entrenador

Ejemplo

Resultado
{"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"}]}}}

Equipo

Parámetros adicionales:

ParámetroDescripción
idIdentificador del equip

Ejemplo

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

Partido

Parámetros adicionales:

ParámetroDescripción
idIdentificador del equip

Ejemplo

Resultado
{"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"}}]}}}}

Búsqueda

Parámetros adicionales:

ParámetroDescripción
qTexto a buscar (Ej: Messi)
typeTipo de búsqueda (1:Jugadores, 2:Entrenadores, 3:Árbitros, 4:Equipos)
dat (Opcional)Fecha de nacimiento (formato dd/mm/aaaa)
pais (Opcional)País de nacimiento (Ej: Nigeria)
club (Opcional)Equipo donde ha estado (Ej: Betis)
temp (Opcional)Temporada donde ha jugado en 1a, 2a o 2aB (Ej: '2015-16')

Ejemplo

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

Partidos jugador

Parámetros adicionales:

ParámetroDescripción
jugIdentificador del jugador
tempIdentifica la temporada. Ejemplos: '2005-06', '1999-00', etc.
equipoIdentificador del equip

Ejemplo

Resultado
{"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"}]}}

Partidos entrenador

Parámetros adicionales:

ParámetroDescripción
entIdentificador del entrenador
tempIdentifica la temporada. Ejemplos: '2005-06', '1999-00', etc.
equipoIdentificador del equip

Ejemplo

Resultado
{"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"}]}}

Partidos equipo

Parámetros adicionales:

ParámetroDescripción
tempIdentifica la temporada. Ejemplos: '2005-06', '1999-00', etc.
equipoIdentificador del equip
cat (Opcional)Identifica la categoría. Valores posibles: '1a', '2a', '2aB1', '2aB2', '2aB3', '2aB4', 'eng', 'ger', 'ita', 'fra', 'por'.

Ejemplo

Resultado
{"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"}]}}

Partidos equipo contra rival

Parámetros adicionales:

ParámetroDescripción
equipoIdentificador del equip
rivIdentificador del equip
temp (Opcional)Identifica la temporada. Ejemplos: '2005-06', '1999-00', etc.
cat (Opcional)Identifica la categoría. Valores posibles: '1a', '2a', '2aB1', '2aB2', '2aB3', '2aB4', 'eng', 'ger', 'ita', 'fra', 'por'.

Ejemplo

Resultado
{"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"}]}}

Manual de usuario

En el siguiente enlace encontrará una descripción más detallada de la especificación de la API y de todas las consultas disponibles, y el formato de los ficheros resultantes.: http://api.bdfutbol.com/v2/api2.pdf

Última actualización: 18/09/2018