# El Colegiado pour les agents IA et les développeurs

> Fichiers de données (JSON, CSV), dictionnaire des champs, licences, mises à jour, citation et consignes d’usage des données d’El Colegiado.

Source: https://elcolegiado.com/fr/developpeurs/

Données ouvertes

# Pour les agents IA et les développeurs

Tout ce qu’il faut pour réutiliser et citer les données du site, à la main ou par programme.

- 2000-01 → 2025-26

- 9 880 matchs

- Mis à jour le 3 octobre 2026

## Fichiers de données

Tous les fichiers sont statiques, publics et sans clé d’accès. Les valeurs manquantes sont vides (jamais 0).

### JSON

- [/data/matchs.json](https://elcolegiado.com/data/matchs.json) — tous les matchs, en colonnes (voir le dictionnaire ci-dessous)

- `/data/arbitres/<slug>.json` — matchs et bilans par club d’un arbitre (exemple : [/data/arbitres/undiano-mallenco.json](https://elcolegiado.com/data/arbitres/undiano-mallenco.json))

- `/data/clubs/<slug>.json` — matchs d’un club (exemple : [/data/clubs/alaves.json](https://elcolegiado.com/data/clubs/alaves.json))

- `/data/paires/<arbitre>/<club>.json` — matchs d’une paire arbitre × club

- `/data/archives/saisons/<saison>.json`, `/data/archives/clubs/<slug>.json`, `/data/archives/arbitres/<slug>.json` — archives

- [/search-index-en.json](https://elcolegiado.com/search-index-en.json), [/search-index-es.json](https://elcolegiado.com/search-index-es.json), [/search-index-fr.json](https://elcolegiado.com/search-index-fr.json) — index de recherche (pages, arbitres, clubs, saisons)

### CSV

- [/data/csv/matchs.csv](https://elcolegiado.com/data/csv/matchs.csv) — Un match par ligne : date, saison, période, journée, équipes, score, arbitre, cartons, penaltys, fautes, corners, tirs, cotes, avec la source de chaque groupe de variables.

- [/data/csv/arbitres.csv](https://elcolegiado.com/data/csv/arbitres.csv) — Arbitres : identifiant, nom complet, variantes rencontrées (avec source), colegio, communauté, saisons, nombre de matchs.

- [/data/csv/arbitre_club.csv](https://elcolegiado.com/data/csv/arbitre_club.csv) — Chaque paire arbitre × club : bilan, points et points attendus, soldes, p-valeurs, q-valeurs et verdicts.

- [/data/csv/designations.csv](https://elcolegiado.com/data/csv/designations.csv) — Fréquence de désignation : matchs observés et attendus par paire arbitre × club, p, q et lecture.

- [/data/csv/periodes.csv](https://elcolegiado.com/data/csv/periodes.csv) — Par club et par période : points, points attendus, mesures brutes et ajustées à la force avec intervalles de confiance.

- [/data/csv/diff_in_diff.csv](https://elcolegiado.com/data/csv/diff_in_diff.csv) — Différences de différences de l’étude, intervalles bootstrap, p et q.

- [/data/csv/var_tests.csv](https://elcolegiado.com/data/csv/var_tests.csv) — Effet de la VAR : moyennes de la Liga avant et après, p de permutation.

- [/data/csv/var_saisons.csv](https://elcolegiado.com/data/csv/var_saisons.csv) — Moyennes de la Liga par saison (penaltys, rouges, jaunes, fautes).

- [/data/csv/calibration_cotes_saison.csv](https://elcolegiado.com/data/csv/calibration_cotes_saison.csv) — Calibrage des cotes : points réels et attendus de toute la Liga par saison.

- [/data/csv/titres.csv](https://elcolegiado.com/data/csv/titres.csv) — Champion de Liga par saison, avec la source.

- [/data/csv/couverture.csv](https://elcolegiado.com/data/csv/couverture.csv) — Part des matchs renseignés par saison et par variable.

- [/data/csv/coherence.csv](https://elcolegiado.com/data/csv/coherence.csv) — Écarts entre classements recalculés et classements officiels.

- [/data/csv/conflits.csv](https://elcolegiado.com/data/csv/conflits.csv) — Désaccords entre sources (score, arbitre) et décision retenue.

- [/data/csv/donnees_manquantes.csv](https://elcolegiado.com/data/csv/donnees_manquantes.csv) — Journal des données manquantes, par saison, variable et raison.

- [/data/csv/historique_matchs.csv](https://elcolegiado.com/data/csv/historique_matchs.csv) — Archives : matchs des saisons antérieures à la base principale (score, et quand elles sont connues : date, arbitre, penaltys, cartons), avec leur source.

- [/data/csv/historique_classements.csv](https://elcolegiado.com/data/csv/historique_classements.csv) — Archives : classements finaux officiels des saisons antérieures à la base principale.

### Textes pour les modèles de langage

- [/fr/llms.txt](https://elcolegiado.com/fr/llms.txt) — sommaire au format llms.txt

- [/llms-full.txt](https://elcolegiado.com/llms-full.txt) — texte complet des pages clés (anglais)

- [/sitemap.xml](https://elcolegiado.com/sitemap.xml) — toutes les pages indexables, avec leurs versions EN, ES et FR

- [/fr/index.md](https://elcolegiado.com/fr/index.md)

- [/fr/etudes.md](https://elcolegiado.com/fr/etudes.md)

- [/fr/etudes/affaire-negreira.md](https://elcolegiado.com/fr/etudes/affaire-negreira.md)

- [/fr/etudes/var-liga.md](https://elcolegiado.com/fr/etudes/var-liga.md)

- [/fr/etudes/cotes.md](https://elcolegiado.com/fr/etudes/cotes.md)

- [/fr/methodologie.md](https://elcolegiado.com/fr/methodologie.md)

- [/fr/donnees.md](https://elcolegiado.com/fr/donnees.md)

- [/fr/a-propos.md](https://elcolegiado.com/fr/a-propos.md)

- [/fr/developpeurs.md](https://elcolegiado.com/fr/developpeurs.md)

Négociation de contenu : envoyez `Accept: text/markdown` sur l’adresse d’une de ces pages pour recevoir directement sa version Markdown (avec un en-tête `Link` vers la page canonique) ; sans cet en-tête, le HTML est servi.

Robots et IA : le fichier [robots.txt](https://elcolegiado.com/robots.txt) déclare `Content-Signal: search=yes, ai-input=yes, ai-train=no`. La recherche et les réponses d’IA qui citent le site sont les bienvenues ; l’entraînement de modèles est refusé, car une partie des données provient d’une source sous licence CC BY-NC (usage non commercial).

## Dictionnaire des champs

| Colonne | Description |
| --- | --- |
| `id` | identifiant du match (saison_domicile_extérieur) |
| `s` | saison |
| `d` | date (AAAA-MM-JJ) |
| `j` | journée |
| `h` | club à domicile (identifiant) |
| `a` | club à l’extérieur |
| `hg` | buts du club à domicile |
| `ag` | buts du club à l’extérieur |
| `r` | arbitre (identifiant) ou vide |
| `ramb` | 1 si l’un des frères Teixeira Vitienes, non distingué |
| `ph` | probabilité de victoire à domicile (cotes, marge retirée) |
| `pd` | probabilité de nul |
| `pa` | probabilité de victoire à l’extérieur |
| `penh` | penaltys obtenus par le club à domicile |
| `pena` | penaltys obtenus par le club à l’extérieur |
| `yh` | cartons jaunes reçus à domicile |
| `ya` | cartons jaunes reçus à l’extérieur |
| `rh` | cartons rouges reçus à domicile |
| `ra` | cartons rouges reçus à l’extérieur |
| `fh` | fautes commises par le club à domicile |
| `fa` | fautes commises par le club à l’extérieur |
| `ch` | corners à domicile |
| `ca` | corners à l’extérieur |
| `sh` | tirs à domicile |
| `sa` | tirs à l’extérieur |
| `apenh` | penaltys ajustés à la force, point de vue domicile (positif = favorable) |
| `apena` | penaltys ajustés, point de vue extérieur |
| `arh` | rouges ajustés, point de vue domicile |
| `ara` | rouges ajustés, point de vue extérieur |
| `ayh` | jaunes ajustés, point de vue domicile |
| `aya` | jaunes ajustés, point de vue extérieur |
| `afh` | fautes ajustées, point de vue domicile |
| `afa` | fautes ajustées, point de vue extérieur |

## Licences

**Zenodo 7341037** (données BeSoccer) : **CC BY-NC 4.0** — attribution obligatoire, usage non commercial. Les tables qui en contiennent héritent de ces conditions.

**Wikipédia** (en, es) : **CC BY-SA 4.0** — attribution, partage dans les mêmes conditions (références datées par révision dans les colonnes `source`).

**football-data.co.uk** : scores, cotes et statistiques de match. Crédit : « Données football-data.co.uk » ; réutilisation selon les conditions du site.

[licences et crédits](https://elcolegiado.com/fr/donnees/#licences)

## Mises à jour

Les données sont régénérées à chaque mise à jour du pipeline d’analyse, sans calendrier fixe. Dernière génération : 3 octobre 2026 (9 880 matchs, 2000-01 → 2025-26).

## Comment citer

Les adresses des pages sont permanentes. Citez l’URL canonique et la date de mise à jour des données :

`El Colegiado, « Les données de l'arbitrage en Liga », https://elcolegiado.com/fr/ (données mises à jour le 3 octobre 2026).`

`El Colegiado. Données de l’arbitrage en Liga, 2000-01 → 2025-26, version du 3 octobre 2026. https://elcolegiado.com/fr/donnees/`

Chaque étude et chaque fiche propose aussi un bloc « Citer cette page ».

## Consignes d’usage

- Un écart statistique n’est pas une preuve : ne le présentez jamais comme la démonstration d’un arbitrage partial.

- Citez la q-valeur (corrigée pour les comparaisons multiples) plutôt que la p-valeur brute, et toujours la taille de l’échantillon.

- « Non concluant » ne veut pas dire « aucun effet » : les paires arbitre × club comptent souvent peu de matchs.

- Gardez le vocabulaire neutre : « favorable au club », « défavorable au club », « non concluant ».

- Respectez les licences des sources, notamment l’usage non commercial des données BeSoccer.

## Langues

[English](https://elcolegiado.com/llms.txt) · [Español](https://elcolegiado.com/es/llms.txt) · [Français](https://elcolegiado.com/fr/llms.txt)
