API et données

Ce que vous pouvez obtenir

5 datasets par clé. Chacun enveloppe le même calcul que le site sert déjà : une seule source de vérité.

1. Power rankings NBA

   GET/api/v1/power-rankings

   Paramètres · ?year=

   Les 30 équipes classées par notre propre modèle (différentiel, forme, % de victoires, parcours), avec la raison de chaque place et le mouvement par rapport à la photo précédente.

   Couverture · NBA · une saison par appel (year = année de début ; 2025 = 2025-26) · calculé sur nos feuilles de match de saison régulière.

   Fraîcheur · Recalculé à partir des feuilles de match ingérées (en saison : chaque jour) ; la réponse est mise en cache 1 heure et déclare last_game.

   Appel · /api/v1/power-rankings?year=2025

2. Taux de change entre ligues

   GET/api/v1/cambio

   Paramètres · ?de= ?a=

   Ce que vaut la production d'un joueur quand il change de compétition : facteur, échantillon et fourchette par statistique (points, rebonds, passes, minutes), à partir de joueurs qui ont réellement fait ce parcours.

   Couverture · NBA · Liga Endesa · EuroLiga · EuroCup · NCAA · G League · seuls les parcours effectués par au moins 12 joueurs sont publiés (15 matchs et 8 minutes par match dans chaque saison).

   Fraîcheur · Facteurs recalculés par lot sur les saisons terminées (pas en temps réel) ; la réponse est mise en cache 1 heure.

   Appel · /api/v1/cambio?de=acb&a=nba

3. On/off par joueur

   GET/api/v1/onoff

   Paramètres · ?id=

   Le net rating de l'équipe avec le joueur sur le terrain et sans lui, avec les minutes de chaque côté, calculé à partir des vrais cinq de sa dernière saison avec données.

   Couverture · NBA · un joueur par appel (id = l'identifiant SportiveWorld du joueur, celui de sa fiche) · saison régulière.

   Fraîcheur · Calculé à chaque appel à partir des cinq ingérés ; sans cache.

   Appel · /api/v1/onoff?id=<id-de-jugador>

4. Leaders WNBA

   GET/api/v1/wnba-leaders

   Paramètres · ?season=

   Les leaders d'une saison aux points, rebonds et passes par match (avec matchs joués et équipe) et, à part, les joueuses espagnoles.

   Couverture · WNBA · une saison par appel (season = année) · sur les matchs joués de nos feuilles de match.

   Fraîcheur · Feuilles de match ingérées par notre cron pendant la saison ; la réponse est mise en cache 1 heure.

   Appel · /api/v1/wnba-leaders?season=2026

5. Leaders G League

   GET/api/v1/gleague-leaders

   Paramètres · ?season=

   Les leaders d'une saison de NBA G League aux points, rebonds et passes par match et, à part, les joueurs espagnols.

   Couverture · NBA G League · une saison par appel (season = année) · sur les matchs joués de nos feuilles de match.

   Fraîcheur · Feuilles de match ingérées par notre cron pendant la saison ; la réponse est mise en cache 1 heure.

   Appel · /api/v1/gleague-leaders?season=2025

Exemple réel

Voici comment on demande et comment ça répond. L'enveloppe est toujours la même : dataset, source, licence, quota consommé et la donnée.

curl -H "Authorization: Bearer TU_CLAVE" \
  https://www.sportiveworld.com/api/v1/power-rankings?year=2025

{
  "dataset": "power-rankings",
  "source": "SportiveWorld",
  "license": "Datos de SportiveWorld. Uso bajo licencia; cita la fuente. Rankings e índices son cálculo propio.",
  "quota": { "used": 1, "limit": 1000, "plan": "media" },
  "data": {
    "season": { "year": 2025, "label": "2025-26", "live": false, "compared_to": "2024-25", "last_game": "2026-04-12" },
    "method": "closed",
    "teams": [
      { "rank": 1, "prev_rank": 1, "move": 0, "abbr": "OKC", "name": "Thunder", "conference": "West",
        "wins": 64, "losses": 18, "win_pct": 0.78, "mov": 11.2, "net": 11.1, "off": 117.6, "def": 106.5,
        "score": 1.762, "why": [{ "k": "pr_mov", "v": "+11.2" }, { "k": "pr_def", "v": "1" }] },
      "… 29 equipos más"
    ]
  }
}

Réponse tronquée ; le corps « data » est celui que la production a servi le 2026-09-19. La donnée vive s'obtient avec la clé.