Antes de empezar
Para quién es: este endpoint solo funciona para ligas con la suscripción Oro que tengan la API activada. Para activarla, marca ACTIVAR JSON API en las Configuraciones API de tu liga. Si falta cualquiera de las dos cosas, todas las direcciones web de este artículo devuelven un error en lugar de tus datos. |
¿Qué es esto? La API JSON permite que otro sitio web, aplicación o programa lea los partidos, resultados y clasificaciones de tu liga directamente desde LeagueRepublic. Piensa en ella como un camarero: tu sitio web pide algo ("los partidos de este equipo, por favor") y LeagueRepublic trae la respuesta.
¿Cómo se pide? Visitas una dirección web, igual que cuando abres una página. En lugar de una página bonita, recibes texto simple en un formato llamado JSON. El código de tu desarrollador lee ese texto y lo convierte en lo que él diseñe.
¿Qué aspecto tiene el JSON? Es una lista de etiquetas y valores, un poco como un formulario rellenado:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
La palabra antes de los dos puntos es el nombre del campo (la etiqueta del formulario). Lo que viene después es el valor (lo que se escribió en la casilla). Las tablas que aparecen más abajo en este artículo explican qué significa cada nombre de campo.
¿Qué es un ID? Cada temporada, equipo y partido en LeagueRepublic tiene su propio número, llamado ID. Funciona como un número de socio: nunca cambia y no hay dos cosas con el mismo. Pones los IDs en la dirección web para indicar qué temporada o equipo quieres.
¿Cómo encuentro mis IDs? El ID de la temporada se obtiene con Get Seasons For League. Los IDs de los equipos se obtienen con Get Teams For Fixture Group. Ambos se describen en el artículo de ayuda principal de la API.
¿Quién puede usarla? Las ligas del plan Oro que hayan marcado Activar JSON API en sus Configuraciones API.
¿Hay algún límite? Sí. Cada liga puede hacer hasta 60 solicitudes por minuto. Si lo superas, recibes el mensaje "Rate limit exceeded" y tienes que esperar un minuto antes de volver a intentarlo.
Algunas palabras que vas a ver
Palabra | Qué significa |
Road | El equipo visitante. LeagueRepublic dice "road" donde la mayoría dice "away" (visitante). |
Fixture | Un partido, se haya jugado ya o no. |
Fixture group | Una división (como "Premier Division") o una ronda de copa. |
Result | Un partido que tiene resultado. |
null | La casilla está vacía. La liga no la rellenó, o no aplica. |
true / false | Sí / no. |
Obtener Partidos Por Equipo
Obtener Partidos Por Equipo te da todos los partidos de un equipo en una temporada, por orden de fecha: partidos de liga, de copa y cualquier otro, jugados y por jugar. Es lo que necesitas para crear la página de un equipo.
Sin él, tu desarrollador tendría que descargar todos los partidos de toda la liga y sacar a mano los de ese equipo.
La dirección web
Sustituye {seasonID} por el ID de la temporada y {teamID} por el ID del equipo. Por ejemplo, el Clydebank en la temporada 2025-2026:
Lo que recibes
Una lista de partidos, del más antiguo al más reciente. Aquí tienes un ejemplo real, reducido a un partido:
[ { "fixtureID": 41048450, "fixtureDate": "20250719 14:00", "fixtureDateInMilliseconds": 1752930000000, "fixtureDateStatusID": 1, "fixtureDateStatusDesc": "Normal / Scheduled", "fixtureGroupDesc": "West Of Scotland Charity Cup", "fixtureGroupIdentifier": 638722492, "fixtureTypeID": 2, "fixtureStatus": 0, "fixtureStatusDesc": "Normal", "homeTeam": 504402802, "homeTeamName": "Clydebank", "roadTeam": 363729896, "roadTeamName": "Auchinleck Talbot", "homeScore": "4", "roadScore": "1", "homeScoreNote": null, "roadScoreNote": null, "additionalScore": "(HT 2-0)", "result": true, "noResultOutcome": false, "fixtureNote": null, "roundDesc": "Final", "shortCode": "C", "venueAndSubVenueDesc": "Holm Park" } ] |
El Clydebank jugó en casa y ganó 4-1 en la final de copa, con 2-0 al descanso.
Cada partido
Estos campos usan exactamente los mismos nombres que las listas de partidos de los otros endpoints de la API de LeagueRepublic, como Get Fixtures For Season, así que tu desarrollador puede reutilizar el mismo código.
Nombre del campo | Qué significa |
fixtureID | El ID del partido. |
fixtureDate | Fecha y hora de inicio, escritas como 20250719 14:00. |
fixtureDateInMilliseconds | La misma fecha y hora en un solo número. A los desarrolladores les resulta más fácil ordenar por este campo. |
fixtureDateStatusID / fixtureDateStatusDesc | Si la fecha está fijada: 1 = "Normal / Scheduled" (programado), 2 = "To Be Confirmed" (por confirmar). |
fixtureGroupDesc | La división o copa a la que pertenece el partido, por ejemplo "West Of Scotland Charity Cup". |
fixtureGroupIdentifier | El ID de esa división o copa. |
fixtureTypeID | De qué tipo es: 1 = división, 2 = copa, 4 = otro. |
fixtureStatus / fixtureStatusDesc | Si el partido se va a jugar: 0 = "Normal", 2 = "Postponed" (aplazado). |
homeTeam / roadTeam | Los IDs del equipo local y del visitante. |
homeTeamName / roadTeamName | Los nombres del equipo local y del visitante. |
homeScore / roadScore | El resultado. Viene como texto, así que también puede contener una letra, como "P" de aplazado (postponed). Vacío si no se ha jugado. |
homeScoreNote / roadScoreNote | Una nota junto al resultado. Normalmente vacío. |
additionalScore | Detalle extra del resultado, como "(HT 2-0)" (descanso) o "(Pens 4-5)" (penaltis). |
result | true si el partido tiene resultado. |
noResultOutcome | true si el partido quedó registrado como sin resultado. |
fixtureNote | Una nota sobre el partido, si la liga muestra alguna. |
roundDesc | La ronda de copa, por ejemplo "Round 2" o "Final". |
shortCode | Un código de una letra para el tipo de partido: L = liga, C = copa, O = otro. |
venueAndSubVenueDesc | Dónde se juega, por ejemplo "Holm Park". |
¿El equipo juega en casa o fuera?
Compara el ID del equipo con homeTeam y roadTeam. Si coincide con homeTeam, el equipo jugó en casa. Si coincide con roadTeam, jugó fuera.
Conviene saber
Se incluyen los partidos jugados y los que faltan por jugar. Los que no se han jugado tienen "result": false y los resultados vacíos.
Una lista vacía no es un error. Si el equipo existe pero no tiene partidos esa temporada, recibes [], que significa "no se ha encontrado nada". También pasa si el equipo pertenece a una liga distinta de la de la temporada.
Si algo sale mal
Mensaje | Qué significa |
Supplied seasonID or teamID is not numeric | Uno de los IDs tiene letras o símbolos. Deben tener solo números. |
Season does not exist for supplied season ID | No existe ninguna temporada con ese ID. Comprueba que lo copiaste bien. |
Team does not exist for supplied team ID | No existe ningún equipo con ese ID. Comprueba que lo copiaste bien. |
League is not authorised to access webservices | La liga no está en el plan Oro. |
JSON api is disabled for league | La opción Activar JSON API no está marcada en tus Configuraciones API. |
Rate limit exceeded | Más de 60 solicitudes en un minuto. Espera un minuto y vuelve a intentarlo. |
Créala con un asistente de IA
No necesitas ser desarrollador para probar este endpoint. Asistentes de IA como ChatGPT o Claude pueden crear una página web sencilla con los datos de tu liga si les dices lo que quieres. Abajo tienes una petición lista para usar (llamada prompt) que puedes copiar y pegar.
Cómo usar el prompt
Copia el prompt del recuadro gris.
Rellena tus IDs. Sustituye [ID DE MI TEMPORADA] y [ID DE MI EQUIPO] por tus números. Consulta "¿Cómo encuentro mis IDs?" al principio de este artículo.
Añade un ejemplo real. Abre en tu navegador la dirección web del prompt, selecciona todo lo que aparece en la página y pégalo debajo del prompt, donde se indica. Así la IA ve tus datos reales, y es mucho más probable que acierte a la primera.
Di qué aspecto quieres. Describe tus colores y estilo, o adjunta una captura de pantalla de tu sitio web o de un diseño que te guste (ChatGPT y Claude aceptan imágenes). Una imagen suele funcionar mejor. Si no dices nada, la IA elegirá un diseño sencillo.
Pégalo todo en la IA y envíalo.
Compara el resultado con el sitio web de tu liga. Si algo no está bien, dile a la IA qué falla con palabras sencillas, por ejemplo "los resultados están al revés". Lo corregirá.
Si la página que crea la IA no muestra datos, dile exactamente lo que ves. Puede que tenga que proponer otra forma de cargar los datos.
Prompt: una página de equipo
Tengo una liga deportiva en LeagueRepublic. Créame una sola página web (un archivo HTML que pueda abrir en mi navegador) que muestre los partidos de un equipo en la temporada, usando la API JSON de LeagueRepublic.
Obtén los datos de esta dirección web: https://api.leaguerepublic.com/json/getFixturesForTeam/[ID DE MI TEMPORADA]/[ID DE MI EQUIPO].json
Los datos son una lista de partidos. El ID de mi equipo es [ID DE MI EQUIPO]. La página debe: 1. Usar el nombre de mi equipo como título. Está en "homeTeamName" cuando "homeTeam" es igual al ID de mi equipo, y en "roadTeamName" cuando "roadTeam" es igual al ID de mi equipo. 2. Dividir los partidos en dos secciones: "Resultados" (donde "result" es true), del más reciente al más antiguo, y "Próximos partidos" (donde "result" es false), del más cercano al más lejano. 3. Para cada partido, mostrar la fecha ("fixtureDate"), la competición ("fixtureGroupDesc", más "roundDesc" en las rondas de copa), el rival, si es en casa o fuera, y el resultado. Si "homeTeam" es igual al ID de mi equipo, mi equipo juega en casa. Si "roadTeam" es igual, juega fuera. "Road" significa fuera. 4. En los resultados, mostrar G, E o P (ganado, empatado, perdido) desde el punto de vista de mi equipo, en verde, gris o rojo. Si un partido terminó empatado y "additionalScore" muestra una tanda de penaltis, como "(Pens 4-2)", mostrar "Pen." en lugar de E y mostrar al lado el resultado de la tanda. 5. Si "additionalScore" tiene algo, como "(HT 2-0)", mostrarlo en letra pequeña debajo del resultado. 6. Mostrar los valores vacíos (null) en blanco. No mostrar nunca la palabra "null". 7. No obtener los datos más de una vez por minuto. La API permite 60 solicitudes por minuto. Mantén un diseño limpio y fácil de leer en el móvil. Explícame con pasos sencillos cómo abrir y usar el archivo. Pregúntame si algo no está claro.
Diseño: [DESCRIBE EL ASPECTO QUE QUIERES O ADJUNTA UNA CAPTURA DE PANTALLA]
Aquí tienes un ejemplo de lo que devuelve la dirección web: [PEGA EL EJEMPLO AQUÍ] |