API - Web Service

API v2

La versió 2 de la API incorpora 7 funcions més que la anterior versió y 4 modalitats de subscripció.

Basic
Temporada en curs
500 peticions/dia
€10,00 mensualmente
Extra
10 Últimes temporades
1.000 peticions/dia
€25,00 mensualmente
Premium
20 Últimes temporades
5.000 peticions/dia
€75,00 mensualmente
Gold
Totes
50.000 peticions/dia
€250,00 mensualmente

La subscripció mensual es pot cancel·lar en qualsevol moment des del seu compte de Paypal.

Si prefereix un pressupost a mida contacti amb nosaltres per correu bdfutbol@gmail.com o mitjançant el formulari de contacte

La API v2 de BDFutbol es troba a la direcció http://api.bdfutbol.com/v2. Les peticions són de tipus GET y els resultats en format JSON.

La identificació d'usuari es realitza amb autorització de PHP Bàsica amb el nom d'usuari i contrasenya del seu compte de BDFutbol.

Peticions disponibles:

PeticióParàmetreDescripció
Classificaciótip=claObtenir la classificació d'una temporada
Resultatstip=resObtenir els partits (jugats o no) d'una temporada o equip
Temporadestip=tempsObtenir el llistat de temporades disponibles d'un equip
Plantillatip=plaPlantilla amb estadístiques dels jugadors d'un equip en una temporada
Entrenadorstip=plaeLlistat amb estadístiques dels entrenadors d'un equip en una temporada
Jugadortip=jugDades d'un jugador, i trajectòria històrica
Entrenadortip=entDades d'un entrenador, i trajectòria històrica
Equiptip=eqDades d'un equip
Partittip=pFitxa tècnica d'un partit
Cercatip=findCercar jugadors, entrenadors i equips per nom
Partits jugadortip=partsjLlistat de partits d'un jugador
Partits entrenadortip=partseLlistat de partits d'un entrenador
Partits equiptip=partseqLlistat de partits d'un equip
Partits equip contra rivaltip=partseqrLlistat de partits d'un equip contra un altre

Classificació

Paràmetres adicionals:

ParàmetreDescripció
catIdentifica la categoria. Valors possibles: '1a', '2a', '2aB1', '2aB2', '2aB3', '2aB4', 'eng', 'ger', 'ita', 'fra', 'por', 'hol'.
tempIdentifica la temporada. Exemples: '2005-06', '1999-00', etc.

Exemple

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

Resultats

Paràmetres adicionals:

ParàmetreDescripció
catIdentifica la categoria. Valors possibles: '1a', '2a', '2aB1', '2aB2', '2aB3', '2aB4', 'eng', 'ger', 'ita', 'fra', 'por', 'hol'.
tempIdentifica la temporada. Exemples: '2005-06', '1999-00', etc.
equipoIdentificador de l'equip
cal (Opcional)0: Únicament els partits disputats (per defecte), 1: També els partits no disputats encara (per la temporada en curs)

Exemple

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

Temporades

Paràmetres adicionals:

ParàmetreDescripció
equipoIdentificador de l'equip

Exemple

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

Plantilla

Paràmetres adicionals:

ParàmetreDescripció
equipoIdentificador de l'equip
tempIdentifica la temporada. Exemples: '2005-06', '1999-00', etc.

Exemple

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

Entrenadors

Paràmetres adicionals:

ParàmetreDescripció
equipoIdentificador de l'equip
tempIdentifica la temporada. Exemples: '2005-06', '1999-00', etc.

Exemple

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

Jugador

Paràmetres adicionals:

ParàmetreDescripció
idIdentificador del jugador

Exemple

Resultat
{"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àmetres adicionals:

ParàmetreDescripció
idIdentificador de l'entrenador

Exemple

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

Equip

Paràmetres adicionals:

ParàmetreDescripció
idIdentificador de l'equip

Exemple

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

Partit

Paràmetres adicionals:

ParàmetreDescripció
idIdentificador de l'equip

Exemple

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

Cerca

Paràmetres adicionals:

ParàmetreDescripció
qText a cercar (Ex: Messi)
typeTipus de cerca (1: Jugadors, 2: Entrenadors, 3: Àrbitres, 4: Equips)
dat (Opcional)Data de naixement (format dd/mm/aaaa)
pais (Opcional)País de naixement (Ex: Nigèria)
club (Opcional)Equip on ha estat (Ex: Betis)
temp (Opcional)Temporada on ha jugat a 1a, 2a o 2aB (Ex: '2015-16')

Exemple

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

Partits jugador

Paràmetres adicionals:

ParàmetreDescripció
jugIdentificador del jugador
tempIdentifica la temporada. Exemples: '2005-06', '1999-00', etc.
equipoIdentificador de l'equip

Exemple

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

Partits entrenador

Paràmetres adicionals:

ParàmetreDescripció
entIdentificador de l'entrenador
tempIdentifica la temporada. Exemples: '2005-06', '1999-00', etc.
equipoIdentificador de l'equip

Exemple

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

Partits equip

Paràmetres adicionals:

ParàmetreDescripció
tempIdentifica la temporada. Exemples: '2005-06', '1999-00', etc.
equipoIdentificador de l'equip
cat (Opcional)Identifica la categoria. Valors possibles: '1a', '2a', '2aB1', '2aB2', '2aB3', '2aB4', 'eng', 'ger', 'ita', 'fra', 'por', 'hol'.

Exemple

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

Partits equip contra rival

Paràmetres adicionals:

ParàmetreDescripció
equipoIdentificador de l'equip
rivIdentificador de l'equip
temp (Opcional)Identifica la temporada. Exemples: '2005-06', '1999-00', etc.
cat (Opcional)Identifica la categoria. Valors possibles: '1a', '2a', '2aB1', '2aB2', '2aB3', '2aB4', 'eng', 'ger', 'ita', 'fra', 'por', 'hol'.

Exemple

Resultat
{"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 d'usuari

En el següent enllaç trobarà una descripció més detallada de l'especificació de la API i de totes les consultes disponibles, així com el format dels fitxers resultants.: http://api.bdfutbol.com/v2/api2.pdf

Última actualització: 13/11/2018