feat: implement MCP server and dashboard for football data platform

Add complete Nike football data platform with: - FastMCP server exposing football data tools over HTTP - RapidAPI client for free-api-live-football-data integration - Bootstrap web dashboard with live match/standings views - REST API endpoints for dashboard consumption - Docker support with multi-stage build - Comprehensive README with architecture docs - Minimal .gitignore replacing verbose Python template
2026-03-21 18:19:42 +00:00
parent b8689d530a
commit ee8436d5b8
81 changed files with 50251 additions and 176 deletions
--- a/docs/api_samples/01_popular_leagues.json
+++ b/docs/api_samples/01_popular_leagues.json
@@ -0,0 +1,77 @@
+{
+  "status": "success",
+  "response": {
+    "popular": [
+      {
+        "id": 47,
+        "name": "Premier League",
+        "localizedName": "Premier League",
+        "ccode": "ENG",
+        "logo": "https://images.fotmob.com/image_resources/logo/leaguelogo/dark/47.png"
+      },
+      {
+        "id": 42,
+        "name": "Champions League",
+        "localizedName": "Champions League",
+        "ccode": "INT",
+        "logo": "https://images.fotmob.com/image_resources/logo/leaguelogo/dark/42.png"
+      },
+      {
+        "id": 87,
+        "name": "LaLiga",
+        "localizedName": "LaLiga",
+        "ccode": "ESP",
+        "logo": "https://images.fotmob.com/image_resources/logo/leaguelogo/dark/87.png"
+      },
+      {
+        "id": 77,
+        "name": "World Cup",
+        "localizedName": "FIFA World Cup",
+        "ccode": "INT",
+        "logo": "https://images.fotmob.com/image_resources/logo/leaguelogo/dark/77.png"
+      },
+      {
+        "id": 54,
+        "name": "Bundesliga",
+        "localizedName": "Bundesliga",
+        "ccode": "GER",
+        "logo": "https://images.fotmob.com/image_resources/logo/leaguelogo/dark/54.png"
+      },
+      {
+        "id": 73,
+        "name": "Europa League",
+        "localizedName": "Europa League",
+        "ccode": "INT",
+        "logo": "https://images.fotmob.com/image_resources/logo/leaguelogo/dark/73.png"
+      },
+      {
+        "id": 53,
+        "name": "Ligue 1",
+        "localizedName": "Ligue 1",
+        "ccode": "FRA",
+        "logo": "https://images.fotmob.com/image_resources/logo/leaguelogo/dark/53.png"
+      },
+      {
+        "id": 55,
+        "name": "Serie A",
+        "localizedName": "Serie A",
+        "ccode": "ITA",
+        "logo": "https://images.fotmob.com/image_resources/logo/leaguelogo/dark/55.png"
+      },
+      {
+        "id": 138,
+        "name": "Copa del Rey",
+        "localizedName": "Copa del Rey",
+        "ccode": "ESP",
+        "logo": "https://images.fotmob.com/image_resources/logo/leaguelogo/dark/138.png"
+      },
+      {
+        "id": 132,
+        "name": "FA Cup",
+        "localizedName": "FA Cup",
+        "ccode": "ENG",
+        "logo": "https://images.fotmob.com/image_resources/logo/leaguelogo/dark/132.png"
+      }
+    ]
+  }
+}
--- a/docs/api_samples/01_search_leagues_epl.json
+++ b/docs/api_samples/01_search_leagues_epl.json
@@ -0,0 +1,175 @@
+{
+  "status": "success",
+  "response": {
+    "suggestions": [
+      {
+        "type": "league",
+        "id": "47",
+        "score": 301131,
+        "name": "Premier League",
+        "ccode": "ENG"
+      },
+      {
+        "type": "league",
+        "id": "519",
+        "score": 300091,
+        "name": "Premier League",
+        "ccode": "EGY"
+      },
+      {
+        "type": "league",
+        "id": "9066",
+        "score": 300073,
+        "name": "Premier League",
+        "ccode": "TAN"
+      },
+      {
+        "type": "league",
+        "id": "63",
+        "score": 300071,
+        "name": "Premier League",
+        "ccode": "RUS"
+      },
+      {
+        "type": "league",
+        "id": "10028",
+        "score": 300058,
+        "name": "Premier League Qualification",
+        "ccode": "TAN"
+      },
+      {
+        "type": "league",
+        "id": "441",
+        "score": 300054,
+        "name": "Premier League",
+        "ccode": "UKR"
+      },
+      {
+        "type": "league",
+        "id": "522",
+        "score": 300054,
+        "name": "Premier League",
+        "ccode": "GHA"
+      },
+      {
+        "type": "league",
+        "id": "9084",
+        "score": 300050,
+        "name": "Premier League 2",
+        "ccode": "ENG"
+      },
+      {
+        "type": "league",
+        "id": "10176",
+        "score": 300041,
+        "name": "Premier League 2 Div 2",
+        "ccode": "ENG"
+      },
+      {
+        "type": "league",
+        "id": "10068",
+        "score": 300036,
+        "name": "Premier League U18",
+        "ccode": "ENG"
+      },
+      {
+        "type": "league",
+        "id": "263",
+        "score": 300024,
+        "name": "Premier League",
+        "ccode": "BLR"
+      },
+      {
+        "type": "league",
+        "id": "225",
+        "score": 300023,
+        "name": "Premier League",
+        "ccode": "KAZ"
+      },
+      {
+        "type": "league",
+        "id": "461",
+        "score": 300021,
+        "name": "Premier League",
+        "ccode": "SIN"
+      },
+      {
+        "type": "league",
+        "id": "9986",
+        "score": 300021,
+        "name": "Premier League",
+        "ccode": "CAN"
+      },
+      {
+        "type": "league",
+        "id": "262",
+        "score": 300020,
+        "name": "Premier League",
+        "ccode": "AZE"
+      },
+      {
+        "type": "league",
+        "id": "10443",
+        "score": 300019,
+        "name": "Premier League",
+        "ccode": "BAN"
+      },
+      {
+        "type": "league",
+        "id": "9829",
+        "score": 300018,
+        "name": "Premier League Qualification",
+        "ccode": "UKR"
+      },
+      {
+        "type": "league",
+        "id": "9333",
+        "score": 300017,
+        "name": "Premier League Qualification",
+        "ccode": "RUS"
+      },
+      {
+        "type": "league",
+        "id": "118",
+        "score": 300014,
+        "name": "Premier League",
+        "ccode": "ARM"
+      },
+      {
+        "type": "league",
+        "id": "267",
+        "score": 300013,
+        "name": "Premier League",
+        "ccode": "BIH"
+      },
+      {
+        "type": "league",
+        "id": "10783",
+        "score": 300011,
+        "name": "Women's Premier League",
+        "ccode": "KSA"
+      },
+      {
+        "type": "league",
+        "id": "9255",
+        "score": 300010,
+        "name": "Premier League qualification",
+        "ccode": "BLR"
+      },
+      {
+        "type": "league",
+        "id": "250",
+        "score": 300008,
+        "name": "Premier League",
+        "ccode": "FRO"
+      },
+      {
+        "type": "league",
+        "id": "529",
+        "score": 300008,
+        "name": "Premier League",
+        "ccode": "KUW"
+      }
+    ]
+  }
+}
--- a/docs/api_samples/01_search_leagues_mls.json
+++ b/docs/api_samples/01_search_leagues_mls.json
@@ -0,0 +1,21 @@
+{
+  "status": "success",
+  "response": {
+    "suggestions": [
+      {
+        "type": "league",
+        "id": "130",
+        "score": 300491,
+        "name": "MLS",
+        "ccode": "USA"
+      },
+      {
+        "type": "league",
+        "id": "10282",
+        "score": 300014,
+        "name": "MLS Next Pro",
+        "ccode": "USA"
+      }
+    ]
+  }
+}
--- a/docs/api_samples/02_search_teams_arsenal.json
+++ b/docs/api_samples/02_search_teams_arsenal.json
@@ -0,0 +1,79 @@
+{
+  "status": "success",
+  "response": {
+    "suggestions": [
+      {
+        "type": "team",
+        "id": "9825",
+        "score": 300993,
+        "name": "Arsenal",
+        "leagueId": 47,
+        "leagueName": "Premier League"
+      },
+      {
+        "type": "team",
+        "id": "258657",
+        "score": 300043,
+        "name": "Arsenal (W)",
+        "leagueId": 9227,
+        "leagueName": "WSL"
+      },
+      {
+        "type": "team",
+        "id": "950214",
+        "score": 300010,
+        "name": "Arsenal U21",
+        "leagueId": 9084,
+        "leagueName": "Premier League 2"
+      },
+      {
+        "type": "team",
+        "id": "1113566",
+        "score": 300008,
+        "name": "Arsenal U18",
+        "leagueId": 10068,
+        "leagueName": "Premier League U18"
+      },
+      {
+        "type": "team",
+        "id": "10098",
+        "score": 300001,
+        "name": "Arsenal Sarandi",
+        "leagueId": 9213,
+        "leagueName": "Primera B Metropolitana"
+      },
+      {
+        "type": "team",
+        "id": "1677",
+        "score": 300001,
+        "name": "Arsenal Tula",
+        "leagueId": 338,
+        "leagueName": "First League"
+      },
+      {
+        "type": "team",
+        "id": "1142489",
+        "score": 300000,
+        "name": "Arsenal Dzerzhinsk",
+        "leagueId": 263,
+        "leagueName": "Premier League"
+      },
+      {
+        "type": "team",
+        "id": "324771",
+        "score": 300000,
+        "name": "FK Arsenal Tivat",
+        "leagueId": 232,
+        "leagueName": "1. CFL"
+      },
+      {
+        "type": "team",
+        "id": "553807",
+        "score": 300000,
+        "name": "Arsenal Tula II",
+        "leagueId": 9123,
+        "leagueName": "Second League Division B Group 3"
+      }
+    ]
+  }
+}
--- a/docs/api_samples/02_search_teams_tfc.json
+++ b/docs/api_samples/02_search_teams_tfc.json
@@ -0,0 +1,31 @@
+{
+  "status": "success",
+  "response": {
+    "suggestions": [
+      {
+        "type": "team",
+        "id": "56453",
+        "score": 300012,
+        "name": "Toronto FC",
+        "leagueId": 130,
+        "leagueName": "Major League Soccer"
+      },
+      {
+        "type": "team",
+        "id": "1022954",
+        "score": 300001,
+        "name": "Inter Toronto FC",
+        "leagueId": 9986,
+        "leagueName": "Premier League"
+      },
+      {
+        "type": "team",
+        "id": "614319",
+        "score": 300000,
+        "name": "Toronto FC II",
+        "leagueId": 10282,
+        "leagueName": "MLS Next Pro"
+      }
+    ]
+  }
+}
--- a/docs/api_samples/03_league_matches_epl.json
+++ b/docs/api_samples/03_league_matches_epl.json
--- a/docs/api_samples/03_league_matches_mls.json
+++ b/docs/api_samples/03_league_matches_mls.json
@@ -0,0 +1,6 @@
+{
+  "status": "success",
+  "response": {
+    "matches": []
+  }
+}
--- a/docs/api_samples/03_matches_by_date_20260308.json
+++ b/docs/api_samples/03_matches_by_date_20260308.json
--- a/docs/api_samples/04_match_detail.json
+++ b/docs/api_samples/04_match_detail.json
@@ -0,0 +1,4 @@
+{
+  "status": "failed",
+  "message": "Request Failed Please try Again"
+}
--- a/docs/api_samples/04_match_detail_tfc.json
+++ b/docs/api_samples/04_match_detail_tfc.json
@@ -0,0 +1,4 @@
+{
+  "status": "failed",
+  "message": "Request Failed Please try Again"
+}
--- a/docs/api_samples/04_match_location.json
+++ b/docs/api_samples/04_match_location.json
@@ -0,0 +1,4 @@
+{
+  "status": "failed",
+  "message": "Request Failed Please try Again"
+}
--- a/docs/api_samples/04_match_location_tfc.json
+++ b/docs/api_samples/04_match_location_tfc.json
@@ -0,0 +1,4 @@
+{
+  "status": "failed",
+  "message": "Request Failed Please try Again"
+}
--- a/docs/api_samples/04_match_score.json
+++ b/docs/api_samples/04_match_score.json
@@ -0,0 +1,4 @@
+{
+  "status": "failed",
+  "message": "Request Failed Please try Again"
+}
--- a/docs/api_samples/04_match_score_tfc.json
+++ b/docs/api_samples/04_match_score_tfc.json
@@ -0,0 +1,4 @@
+{
+  "status": "failed",
+  "message": "Request Failed Please try Again"
+}
--- a/docs/api_samples/04_match_status.json
+++ b/docs/api_samples/04_match_status.json
@@ -0,0 +1,4 @@
+{
+  "status": "failed",
+  "message": "Request Failed Please try Again"
+}
--- a/docs/api_samples/04_match_status_tfc.json
+++ b/docs/api_samples/04_match_status_tfc.json
@@ -0,0 +1,4 @@
+{
+  "status": "failed",
+  "message": "Request Failed Please try Again"
+}
--- a/docs/api_samples/05_match_highlights_tfc.json
+++ b/docs/api_samples/05_match_highlights_tfc.json
@@ -0,0 +1,4 @@
+{
+  "status": "failed",
+  "message": "Request Failed Please try Again"
+}
--- a/docs/api_samples/05_match_referee_tfc.json
+++ b/docs/api_samples/05_match_referee_tfc.json
@@ -0,0 +1,4 @@
+{
+  "status": "failed",
+  "message": "Request Failed Please try Again"
+}
--- a/docs/api_samples/05_match_stats_tfc.json
+++ b/docs/api_samples/05_match_stats_tfc.json
@@ -0,0 +1,4 @@
+{
+  "status": "failed",
+  "message": "Request Failed Please try Again"
+}
--- a/docs/api_samples/06_lineup_away_tfc.json
+++ b/docs/api_samples/06_lineup_away_tfc.json
@@ -0,0 +1,3 @@
+{
+  "message": "You have exceeded the MONTHLY quota for Requests on your current plan, BASIC. Upgrade your plan at https://rapidapi.com/Creativesdev/api/free-api-live-football-data"
+}
--- a/docs/api_samples/06_lineup_home_tfc.json
+++ b/docs/api_samples/06_lineup_home_tfc.json
@@ -0,0 +1,4 @@
+{
+  "status": "failed",
+  "message": "Request Failed Please try Again"
+}
--- a/docs/api_samples/07_squad_tfc.json
+++ b/docs/api_samples/07_squad_tfc.json
@@ -0,0 +1,827 @@
+{
+  "status": "success",
+  "response": {
+    "list": {
+      "squad": [
+        {
+          "title": "coach",
+          "members": [
+            {
+              "id": 308837,
+              "height": null,
+              "age": 59,
+              "dateOfBirth": "1966-12-17",
+              "name": "Robin Fraser",
+              "ccode": "USA",
+              "cname": "USA",
+              "role": {
+                "key": "coach",
+                "fallback": "Coach"
+              },
+              "excludeFromRanking": true
+            }
+          ]
+        },
+        {
+          "title": "keepers",
+          "members": [
+            {
+              "id": 1715087,
+              "name": "Adisa De Rosario",
+              "shirtNumber": null,
+              "ccode": "CAN",
+              "cname": "Canada",
+              "role": {
+                "key": "keeper_long",
+                "fallback": "Keeper"
+              },
+              "positionId": 0,
+              "injured": true,
+              "injury": {
+                "id": "35",
+                "expectedReturn": "Early April 2026"
+              },
+              "rating": null,
+              "goals": 0,
+              "penalties": 0,
+              "assists": 0,
+              "rcards": 0,
+              "ycards": 0,
+              "excludeFromRanking": true,
+              "positionIds": "11",
+              "positionIdsDesc": "GK",
+              "height": 185,
+              "age": 21,
+              "dateOfBirth": "2004-10-27",
+              "transferValue": 100000
+            },
+            {
+              "id": 1338704,
+              "name": "Luka Gavran",
+              "shirtNumber": 1,
+              "ccode": "CAN",
+              "cname": "Canada",
+              "role": {
+                "key": "keeper_long",
+                "fallback": "Keeper"
+              },
+              "positionId": 0,
+              "injury": null,
+              "rating": 4.87,
+              "goals": 0,
+              "penalties": 0,
+              "assists": 0,
+              "rcards": 0,
+              "ycards": 0,
+              "excludeFromRanking": false,
+              "positionIds": "11",
+              "positionIdsDesc": "GK",
+              "height": 198,
+              "age": 25,
+              "dateOfBirth": "2000-05-09",
+              "transferValue": 242993
+            },
+            {
+              "id": 342699,
+              "name": "William Yarbrough",
+              "shirtNumber": 23,
+              "ccode": "USA",
+              "cname": "USA",
+              "role": {
+                "key": "keeper_long",
+                "fallback": "Keeper"
+              },
+              "positionId": 0,
+              "injury": null,
+              "rating": null,
+              "goals": 0,
+              "penalties": 0,
+              "assists": 0,
+              "rcards": 0,
+              "ycards": 0,
+              "excludeFromRanking": true,
+              "positionIds": "11",
+              "positionIdsDesc": "GK",
+              "height": 187,
+              "age": 36,
+              "dateOfBirth": "1989-03-20",
+              "transferValue": 50000
+            }
+          ]
+        },
+        {
+          "title": "defenders",
+          "members": [
+            {
+              "id": 574923,
+              "name": "Benjam\u00edn Kuscevic",
+              "shirtNumber": null,
+              "ccode": "CHI",
+              "cname": "Chile",
+              "role": {
+                "key": "defender_long",
+                "fallback": "Defender"
+              },
+              "positionId": 1,
+              "injury": null,
+              "rating": null,
+              "goals": 0,
+              "penalties": 0,
+              "assists": 0,
+              "rcards": 0,
+              "ycards": 0,
+              "excludeFromRanking": true,
+              "positionIds": "34",
+              "positionIdsDesc": "CB",
+              "height": 186,
+              "age": 29,
+              "dateOfBirth": "1996-05-02",
+              "transferValue": 1483178
+            },
+            {
+              "id": 825691,
+              "name": "Henry Wingo",
+              "shirtNumber": 2,
+              "ccode": "USA",
+              "cname": "USA",
+              "role": {
+                "key": "defender_long",
+                "fallback": "Defender"
+              },
+              "positionId": 1,
+              "injured": true,
+              "injury": {
+                "id": "42",
+                "expectedReturn": "Early April 2026"
+              },
+              "rating": 6.14,
+              "goals": 0,
+              "penalties": 0,
+              "assists": 0,
+              "rcards": 0,
+              "ycards": 0,
+              "excludeFromRanking": false,
+              "positionIds": "71",
+              "positionIdsDesc": "RM",
+              "height": 183,
+              "age": 30,
+              "dateOfBirth": "1995-10-04",
+              "transferValue": 130182
+            },
+            {
+              "id": 1130753,
+              "name": "Zane Monlouis",
+              "shirtNumber": 12,
+              "ccode": "JAM",
+              "cname": "Jamaica",
+              "role": {
+                "key": "defender_long",
+                "fallback": "Defender"
+              },
+              "positionId": 1,
+              "injury": null,
+              "rating": 6.44,
+              "goals": 0,
+              "penalties": 0,
+              "assists": 0,
+              "rcards": 0,
+              "ycards": 0,
+              "excludeFromRanking": false,
+              "positionIds": "34",
+              "positionIdsDesc": "CB",
+              "height": 185,
+              "age": 22,
+              "dateOfBirth": "2003-10-16",
+              "transferValue": 502064
+            },
+            {
+              "id": 1346549,
+              "name": "Nicksoen Gomis",
+              "shirtNumber": 15,
+              "ccode": "FRA",
+              "cname": "France",
+              "role": {
+                "key": "defender_long",
+                "fallback": "Defender"
+              },
+              "positionId": 1,
+              "injured": true,
+              "injury": {
+                "id": "73",
+                "expectedReturn": "Late March 2026"
+              },
+              "rating": null,
+              "goals": 0,
+              "penalties": 0,
+              "assists": 0,
+              "rcards": 0,
+              "ycards": 0,
+              "excludeFromRanking": true,
+              "positionIds": "36,38",
+              "positionIdsDesc": "CB,LB",
+              "height": 185,
+              "age": 23,
+              "dateOfBirth": "2002-03-15",
+              "transferValue": 238195
+            },
+            {
+              "id": 1106934,
+              "name": "Kobe Franklin",
+              "shirtNumber": 19,
+              "ccode": "CAN",
+              "cname": "Canada",
+              "role": {
+                "key": "defender_long",
+                "fallback": "Defender"
+              },
+              "positionId": 1,
+              "injury": null,
+              "rating": 5.44,
+              "goals": 0,
+              "penalties": 0,
+              "assists": 0,
+              "rcards": 0,
+              "ycards": 0,
+              "excludeFromRanking": false,
+              "positionIds": "32,38",
+              "positionIdsDesc": "RB,LB",
+              "height": 168,
+              "age": 22,
+              "dateOfBirth": "2003-05-10",
+              "transferValue": 240778
+            },
+            {
+              "id": 729506,
+              "name": "Richie Laryea",
+              "shirtNumber": 22,
+              "ccode": "CAN",
+              "cname": "Canada",
+              "role": {
+                "key": "defender_long",
+                "fallback": "Defender"
+              },
+              "positionId": 1,
+              "injury": null,
+              "rating": 6.19,
+              "goals": 0,
+              "penalties": 0,
+              "assists": 0,
+              "rcards": 0,
+              "ycards": 0,
+              "excludeFromRanking": false,
+              "positionIds": "38,32,66,34",
+              "positionIdsDesc": "LB,RB,CDM,CB",
+              "height": 175,
+              "age": 31,
+              "dateOfBirth": "1995-01-07",
+              "transferValue": 470837
+            },
+            {
+              "id": 431956,
+              "name": "Walker Zimmerman",
+              "shirtNumber": 25,
+              "ccode": "USA",
+              "cname": "USA",
+              "role": {
+                "key": "defender_long",
+                "fallback": "Defender"
+              },
+              "positionId": 1,
+              "injury": null,
+              "rating": 5.51,
+              "goals": 0,
+              "penalties": 0,
+              "assists": 0,
+              "rcards": 0,
+              "ycards": 0,
+              "excludeFromRanking": false,
+              "positionIds": "34",
+              "positionIdsDesc": "CB",
+              "height": 191,
+              "age": 32,
+              "dateOfBirth": "1993-05-19",
+              "transferValue": 1163870
+            },
+            {
+              "id": 664764,
+              "name": "Raheem Edwards",
+              "shirtNumber": 44,
+              "ccode": "CAN",
+              "cname": "Canada",
+              "role": {
+                "key": "defender_long",
+                "fallback": "Defender"
+              },
+              "positionId": 1,
+              "injury": null,
+              "rating": 6.88,
+              "goals": 0,
+              "penalties": 0,
+              "assists": 0,
+              "rcards": 0,
+              "ycards": 1,
+              "excludeFromRanking": false,
+              "positionIds": "38,68",
+              "positionIdsDesc": "LB,LWB",
+              "height": 173,
+              "age": 30,
+              "dateOfBirth": "1995-07-17",
+              "transferValue": 246577
+            },
+            {
+              "id": 1261310,
+              "name": "Kosi Thompson",
+              "shirtNumber": 47,
+              "ccode": "CAN",
+              "cname": "Canada",
+              "role": {
+                "key": "defender_long",
+                "fallback": "Defender"
+              },
+              "positionId": 1,
+              "injury": null,
+              "rating": 6.16,
+              "goals": 0,
+              "penalties": 0,
+              "assists": 0,
+              "rcards": 0,
+              "ycards": 0,
+              "excludeFromRanking": false,
+              "positionIds": "32,36,62",
+              "positionIdsDesc": "RB,CB,RWB",
+              "height": 178,
+              "age": 23,
+              "dateOfBirth": "2003-01-27",
+              "transferValue": 726678
+            },
+            {
+              "id": 1357562,
+              "name": "Adam Pearlman",
+              "shirtNumber": 51,
+              "ccode": "CAN",
+              "cname": "Canada",
+              "role": {
+                "key": "defender_long",
+                "fallback": "Defender"
+              },
+              "positionId": 1,
+              "injury": null,
+              "rating": null,
+              "goals": 0,
+              "penalties": 0,
+              "assists": 0,
+              "rcards": 0,
+              "ycards": 0,
+              "excludeFromRanking": true,
+              "positionIds": "32,72,33",
+              "positionIdsDesc": "RB,RM,CB",
+              "height": 183,
+              "age": 20,
+              "dateOfBirth": "2005-04-05",
+              "transferValue": 571247
+            },
+            {
+              "id": 1504606,
+              "name": "Lazar Stefanovic",
+              "shirtNumber": 76,
+              "ccode": "CAN",
+              "cname": "Canada",
+              "role": {
+                "key": "defender_long",
+                "fallback": "Defender"
+              },
+              "positionId": 1,
+              "injury": null,
+              "rating": null,
+              "goals": 0,
+              "penalties": 0,
+              "assists": 0,
+              "rcards": 0,
+              "ycards": 0,
+              "excludeFromRanking": true,
+              "positionIds": "37",
+              "positionIdsDesc": "CB",
+              "height": 187,
+              "age": 19,
+              "dateOfBirth": "2006-08-10",
+              "transferValue": 874785
+            },
+            {
+              "id": 1780464,
+              "name": "Stefan Kapor",
+              "shirtNumber": 98,
+              "ccode": "CAN",
+              "cname": "Canada",
+              "role": {
+                "key": "defender_long",
+                "fallback": "Defender"
+              },
+              "positionId": 1,
+              "injury": null,
+              "rating": null,
+              "goals": 0,
+              "penalties": 0,
+              "assists": 0,
+              "rcards": 0,
+              "ycards": 0,
+              "excludeFromRanking": true,
+              "positionIds": null,
+              "positionIdsDesc": null,
+              "height": null,
+              "age": 16,
+              "dateOfBirth": "2009-04-04",
+              "transferValue": null
+            }
+          ]
+        },
+        {
+          "title": "midfielders",
+          "members": [
+            {
+              "id": 1187623,
+              "name": "Matheus Pereira",
+              "shirtNumber": 3,
+              "ccode": "BRA",
+              "cname": "Brazil",
+              "role": {
+                "key": "midfielder_long",
+                "fallback": "Midfielder"
+              },
+              "positionId": 2,
+              "injured": true,
+              "injury": {
+                "id": "47",
+                "expectedReturn": "Early April 2026"
+              },
+              "rating": null,
+              "goals": 0,
+              "penalties": 0,
+              "assists": 0,
+              "rcards": 0,
+              "ycards": 0,
+              "excludeFromRanking": true,
+              "positionIds": "78,107,59",
+              "positionIdsDesc": "LM,LW,LWB",
+              "height": 172,
+              "age": 25,
+              "dateOfBirth": "2000-12-21",
+              "transferValue": 1867261
+            },
+            {
+              "id": 1053698,
+              "name": "Jos\u00e9 Cifuentes",
+              "shirtNumber": 8,
+              "ccode": "ECU",
+              "cname": "Ecuador",
+              "role": {
+                "key": "midfielder_long",
+                "fallback": "Midfielder"
+              },
+              "positionId": 2,
+              "injury": null,
+              "rating": 6.83,
+              "goals": 0,
+              "penalties": 0,
+              "assists": 0,
+              "rcards": 0,
+              "ycards": 0,
+              "excludeFromRanking": false,
+              "positionIds": "64,76,86",
+              "positionIdsDesc": "CDM,CM,CAM",
+              "height": 178,
+              "age": 26,
+              "dateOfBirth": "1999-03-12",
+              "transferValue": 1895906
+            },
+            {
+              "id": 830601,
+              "name": "Djordje Mihailovic",
+              "shirtNumber": 10,
+              "ccode": "USA",
+              "cname": "USA",
+              "role": {
+                "key": "midfielder_long",
+                "fallback": "Midfielder"
+              },
+              "positionId": 2,
+              "injury": null,
+              "rating": 7.14,
+              "goals": 1,
+              "penalties": 0,
+              "assists": 0,
+              "rcards": 0,
+              "ycards": 0,
+              "excludeFromRanking": false,
+              "positionIds": "85,107,78,115",
+              "positionIdsDesc": "CAM,LW,LM,ST",
+              "height": 177,
+              "age": 27,
+              "dateOfBirth": "1998-11-10",
+              "transferValue": 6067551
+            },
+            {
+              "id": 1364471,
+              "name": "Alonso Coello",
+              "shirtNumber": 14,
+              "ccode": "ESP",
+              "cname": "Spain",
+              "role": {
+                "key": "midfielder_long",
+                "fallback": "Midfielder"
+              },
+              "positionId": 2,
+              "injury": null,
+              "rating": 6.23,
+              "goals": 0,
+              "penalties": 0,
+              "assists": 0,
+              "rcards": 0,
+              "ycards": 0,
+              "excludeFromRanking": false,
+              "positionIds": "73,66",
+              "positionIdsDesc": "CM,CDM",
+              "height": 185,
+              "age": 26,
+              "dateOfBirth": "1999-10-12",
+              "transferValue": 623924
+            },
+            {
+              "id": 432605,
+              "name": "Jonathan Osorio",
+              "shirtNumber": 21,
+              "ccode": "CAN",
+              "cname": "Canada",
+              "role": {
+                "key": "midfielder_long",
+                "fallback": "Midfielder"
+              },
+              "positionId": 2,
+              "injury": null,
+              "rating": 7.07,
+              "goals": 0,
+              "penalties": 0,
+              "assists": 1,
+              "rcards": 0,
+              "ycards": 0,
+              "excludeFromRanking": false,
+              "positionIds": "66,77,86,78",
+              "positionIdsDesc": "CDM,CM,CAM,LM",
+              "height": 175,
+              "age": 33,
+              "dateOfBirth": "1992-06-12",
+              "transferValue": 676957
+            },
+            {
+              "id": 1455365,
+              "name": "Markus Cimermancic",
+              "shirtNumber": 71,
+              "ccode": "CAN",
+              "cname": "Canada",
+              "role": {
+                "key": "midfielder_long",
+                "fallback": "Midfielder"
+              },
+              "positionId": 2,
+              "injury": null,
+              "rating": null,
+              "goals": 0,
+              "penalties": 0,
+              "assists": 0,
+              "rcards": 0,
+              "ycards": 0,
+              "excludeFromRanking": true,
+              "positionIds": "76",
+              "positionIdsDesc": "CM",
+              "height": 175,
+              "age": 21,
+              "dateOfBirth": "2004-10-01",
+              "transferValue": 255919
+            },
+            {
+              "id": 1778338,
+              "name": "Malik Henry",
+              "shirtNumber": 78,
+              "ccode": "CAN",
+              "cname": "Canada",
+              "role": {
+                "key": "midfielder_long",
+                "fallback": "Midfielder"
+              },
+              "positionId": 2,
+              "injury": null,
+              "rating": 6.44,
+              "goals": 0,
+              "penalties": 0,
+              "assists": 0,
+              "rcards": 0,
+              "ycards": 1,
+              "excludeFromRanking": false,
+              "positionIds": "72,83",
+              "positionIdsDesc": "RM,RW",
+              "height": 163,
+              "age": 23,
+              "dateOfBirth": "2002-07-23",
+              "transferValue": 193874
+            }
+          ]
+        },
+        {
+          "title": "attackers",
+          "members": [
+            {
+              "id": 1113737,
+              "name": "Theo Corbeanu",
+              "shirtNumber": 7,
+              "ccode": "CAN",
+              "cname": "Canada",
+              "role": {
+                "key": "attacker_long",
+                "fallback": "Attacker"
+              },
+              "positionId": 3,
+              "injured": true,
+              "injury": {
+                "id": "14",
+                "expectedReturn": "Late April 2026"
+              },
+              "rating": null,
+              "goals": 0,
+              "penalties": 0,
+              "assists": 0,
+              "rcards": 0,
+              "ycards": 0,
+              "excludeFromRanking": true,
+              "positionIds": "87,83,104,72,84",
+              "positionIdsDesc": "LW,RW,ST,RM,CAM",
+              "height": 190,
+              "age": 23,
+              "dateOfBirth": "2002-05-17",
+              "transferValue": 1258500
+            },
+            {
+              "id": 848011,
+              "name": "Josh Sargent",
+              "shirtNumber": 9,
+              "ccode": "USA",
+              "cname": "USA",
+              "role": {
+                "key": "attacker_long",
+                "fallback": "Attacker"
+              },
+              "positionId": 3,
+              "injury": null,
+              "rating": null,
+              "goals": 0,
+              "penalties": 0,
+              "assists": 0,
+              "rcards": 0,
+              "ycards": 0,
+              "excludeFromRanking": true,
+              "positionIds": "115",
+              "positionIdsDesc": "ST",
+              "height": 185,
+              "age": 26,
+              "dateOfBirth": "2000-02-20",
+              "transferValue": 22347702
+            },
+            {
+              "id": 643482,
+              "name": "Derrick Etienne Jr.",
+              "shirtNumber": 11,
+              "ccode": "HAI",
+              "cname": "Haiti",
+              "role": {
+                "key": "attacker_long",
+                "fallback": "Attacker"
+              },
+              "positionId": 3,
+              "injury": null,
+              "rating": 6.71,
+              "goals": 1,
+              "penalties": 0,
+              "assists": 0,
+              "rcards": 0,
+              "ycards": 0,
+              "excludeFromRanking": false,
+              "positionIds": "115,87,79",
+              "positionIdsDesc": "ST,LW,LM",
+              "height": 178,
+              "age": 29,
+              "dateOfBirth": "1996-11-25",
+              "transferValue": 495791
+            },
+            {
+              "id": 1579304,
+              "name": "Emilio Aristiz\u00e1bal",
+              "shirtNumber": 17,
+              "ccode": "COL",
+              "cname": "Colombia",
+              "role": {
+                "key": "attacker_long",
+                "fallback": "Attacker"
+              },
+              "positionId": 3,
+              "injury": null,
+              "rating": 5.67,
+              "goals": 0,
+              "penalties": 0,
+              "assists": 0,
+              "rcards": 0,
+              "ycards": 0,
+              "excludeFromRanking": false,
+              "positionIds": "106",
+              "positionIdsDesc": "ST",
+              "height": 187,
+              "age": 20,
+              "dateOfBirth": "2005-08-05",
+              "transferValue": 1020000
+            },
+            {
+              "id": 655524,
+              "name": "D\u00e1niel Sall\u00f3i",
+              "shirtNumber": 20,
+              "ccode": "HUN",
+              "cname": "Hungary",
+              "role": {
+                "key": "attacker_long",
+                "fallback": "Attacker"
+              },
+              "positionId": 3,
+              "injury": null,
+              "rating": 6.1,
+              "goals": 0,
+              "penalties": 0,
+              "assists": 0,
+              "rcards": 0,
+              "ycards": 0,
+              "excludeFromRanking": false,
+              "positionIds": "107,78,83",
+              "positionIdsDesc": "LW,LM,RW",
+              "height": 185,
+              "age": 29,
+              "dateOfBirth": "1996-07-19",
+              "transferValue": 1598605
+            },
+            {
+              "id": 1338703,
+              "name": "Deandre Kerr",
+              "shirtNumber": 29,
+              "ccode": "CAN",
+              "cname": "Canada",
+              "role": {
+                "key": "attacker_long",
+                "fallback": "Attacker"
+              },
+              "positionId": 3,
+              "injured": true,
+              "injury": {
+                "id": "87",
+                "expectedReturn": "Late March 2026"
+              },
+              "rating": null,
+              "goals": 0,
+              "penalties": 0,
+              "assists": 0,
+              "rcards": 0,
+              "ycards": 0,
+              "excludeFromRanking": true,
+              "positionIds": "115",
+              "positionIdsDesc": "ST",
+              "height": 180,
+              "age": 23,
+              "dateOfBirth": "2002-11-29",
+              "transferValue": 1095554
+            },
+            {
+              "id": 1276785,
+              "name": "Jules-Anthony Vilsaint",
+              "shirtNumber": 99,
+              "ccode": "CAN",
+              "cname": "Canada",
+              "role": {
+                "key": "attacker_long",
+                "fallback": "Attacker"
+              },
+              "positionId": 3,
+              "injury": null,
+              "rating": null,
+              "goals": 0,
+              "penalties": 0,
+              "assists": 0,
+              "rcards": 0,
+              "ycards": 0,
+              "excludeFromRanking": true,
+              "positionIds": "106",
+              "positionIdsDesc": "ST",
+              "height": 193,
+              "age": 23,
+              "dateOfBirth": "2003-01-06",
+              "transferValue": 286274
+            }
+          ]
+        }
+      ],
+      "isNationalTeam": false
+    }
+  }
+}
--- a/docs/api_samples/08_standings_mls.json
+++ b/docs/api_samples/08_standings_mls.json
@@ -0,0 +1,4 @@
+{
+  "status": "failed",
+  "message": "Request Failed Please try Again"
+}
--- a/docs/api_samples/09_head_to_head_tfc.json
+++ b/docs/api_samples/09_head_to_head_tfc.json
@@ -0,0 +1,3 @@
+{
+  "message": "You have exceeded the MONTHLY quota for Requests on your current plan, BASIC. Upgrade your plan at https://rapidapi.com/Creativesdev/api/free-api-live-football-data"
+}
--- a/docs/api_samples/extra_get_standing_all_47.json
+++ b/docs/api_samples/extra_get_standing_all_47.json
@@ -0,0 +1,347 @@
+{
+  "status": "success",
+  "response": {
+    "standing": [
+      {
+        "name": "Arsenal",
+        "shortName": "Arsenal",
+        "id": 9825,
+        "pageUrl": "/teams/9825/overview/arsenal",
+        "deduction": null,
+        "ongoing": null,
+        "played": 30,
+        "wins": 20,
+        "draws": 7,
+        "losses": 3,
+        "scoresStr": "59-22",
+        "goalConDiff": 37,
+        "pts": 67,
+        "idx": 1,
+        "qualColor": "#2AD572"
+      },
+      {
+        "name": "Manchester City",
+        "shortName": "Man City",
+        "id": 8456,
+        "pageUrl": "/teams/8456/overview/manchester-city",
+        "deduction": null,
+        "ongoing": null,
+        "played": 29,
+        "wins": 18,
+        "draws": 6,
+        "losses": 5,
+        "scoresStr": "59-27",
+        "goalConDiff": 32,
+        "pts": 60,
+        "idx": 2,
+        "qualColor": "#2AD572"
+      },
+      {
+        "name": "Manchester United",
+        "shortName": "Man United",
+        "id": 10260,
+        "pageUrl": "/teams/10260/overview/manchester-united",
+        "deduction": null,
+        "ongoing": null,
+        "played": 29,
+        "wins": 14,
+        "draws": 9,
+        "losses": 6,
+        "scoresStr": "51-40",
+        "goalConDiff": 11,
+        "pts": 51,
+        "idx": 3,
+        "qualColor": "#2AD572"
+      },
+      {
+        "name": "Aston Villa",
+        "shortName": "Aston Villa",
+        "id": 10252,
+        "pageUrl": "/teams/10252/overview/aston-villa",
+        "deduction": null,
+        "ongoing": null,
+        "played": 29,
+        "wins": 15,
+        "draws": 6,
+        "losses": 8,
+        "scoresStr": "39-34",
+        "goalConDiff": 5,
+        "pts": 51,
+        "idx": 4,
+        "qualColor": "#2AD572"
+      },
+      {
+        "name": "Chelsea",
+        "shortName": "Chelsea",
+        "id": 8455,
+        "pageUrl": "/teams/8455/overview/chelsea",
+        "deduction": null,
+        "ongoing": null,
+        "played": 29,
+        "wins": 13,
+        "draws": 9,
+        "losses": 7,
+        "scoresStr": "53-34",
+        "goalConDiff": 19,
+        "pts": 48,
+        "idx": 5,
+        "qualColor": "#0046A7"
+      },
+      {
+        "name": "Liverpool",
+        "shortName": "Liverpool",
+        "id": 8650,
+        "pageUrl": "/teams/8650/overview/liverpool",
+        "deduction": null,
+        "ongoing": null,
+        "played": 29,
+        "wins": 14,
+        "draws": 6,
+        "losses": 9,
+        "scoresStr": "48-39",
+        "goalConDiff": 9,
+        "pts": 48,
+        "idx": 6,
+        "qualColor": null
+      },
+      {
+        "name": "Brentford",
+        "shortName": "Brentford",
+        "id": 9937,
+        "pageUrl": "/teams/9937/overview/brentford",
+        "deduction": null,
+        "ongoing": null,
+        "played": 29,
+        "wins": 13,
+        "draws": 5,
+        "losses": 11,
+        "scoresStr": "44-40",
+        "goalConDiff": 4,
+        "pts": 44,
+        "idx": 7,
+        "qualColor": null
+      },
+      {
+        "name": "Everton",
+        "shortName": "Everton",
+        "id": 8668,
+        "pageUrl": "/teams/8668/overview/everton",
+        "deduction": null,
+        "ongoing": null,
+        "played": 29,
+        "wins": 12,
+        "draws": 7,
+        "losses": 10,
+        "scoresStr": "34-33",
+        "goalConDiff": 1,
+        "pts": 43,
+        "idx": 8,
+        "qualColor": null
+      },
+      {
+        "name": "AFC Bournemouth",
+        "shortName": "Bournemouth",
+        "id": 8678,
+        "pageUrl": "/teams/8678/overview/afc-bournemouth",
+        "deduction": null,
+        "ongoing": null,
+        "played": 29,
+        "wins": 9,
+        "draws": 13,
+        "losses": 7,
+        "scoresStr": "44-46",
+        "goalConDiff": -2,
+        "pts": 40,
+        "idx": 9,
+        "qualColor": null
+      },
+      {
+        "name": "Fulham",
+        "shortName": "Fulham",
+        "id": 9879,
+        "pageUrl": "/teams/9879/overview/fulham",
+        "deduction": null,
+        "ongoing": null,
+        "played": 29,
+        "wins": 12,
+        "draws": 4,
+        "losses": 13,
+        "scoresStr": "40-43",
+        "goalConDiff": -3,
+        "pts": 40,
+        "idx": 10,
+        "qualColor": null
+      },
+      {
+        "name": "Sunderland",
+        "shortName": "Sunderland",
+        "id": 8472,
+        "pageUrl": "/teams/8472/overview/sunderland",
+        "deduction": null,
+        "ongoing": null,
+        "played": 29,
+        "wins": 10,
+        "draws": 10,
+        "losses": 9,
+        "scoresStr": "30-34",
+        "goalConDiff": -4,
+        "pts": 40,
+        "idx": 11,
+        "qualColor": null
+      },
+      {
+        "name": "Newcastle United",
+        "shortName": "Newcastle",
+        "id": 10261,
+        "pageUrl": "/teams/10261/overview/newcastle-united",
+        "deduction": null,
+        "ongoing": null,
+        "played": 29,
+        "wins": 11,
+        "draws": 6,
+        "losses": 12,
+        "scoresStr": "42-43",
+        "goalConDiff": -1,
+        "pts": 39,
+        "idx": 12,
+        "qualColor": null
+      },
+      {
+        "name": "Crystal Palace",
+        "shortName": "Crystal Palace",
+        "id": 9826,
+        "pageUrl": "/teams/9826/overview/crystal-palace",
+        "deduction": null,
+        "ongoing": null,
+        "played": 29,
+        "wins": 10,
+        "draws": 8,
+        "losses": 11,
+        "scoresStr": "33-35",
+        "goalConDiff": -2,
+        "pts": 38,
+        "idx": 13,
+        "qualColor": null
+      },
+      {
+        "name": "Brighton & Hove Albion",
+        "shortName": "Brighton",
+        "id": 10204,
+        "pageUrl": "/teams/10204/overview/brighton-hove-albion",
+        "deduction": null,
+        "ongoing": null,
+        "played": 29,
+        "wins": 9,
+        "draws": 10,
+        "losses": 10,
+        "scoresStr": "38-36",
+        "goalConDiff": 2,
+        "pts": 37,
+        "idx": 14,
+        "qualColor": null
+      },
+      {
+        "name": "Leeds United",
+        "shortName": "Leeds",
+        "id": 8463,
+        "pageUrl": "/teams/8463/overview/leeds-united",
+        "deduction": null,
+        "ongoing": null,
+        "played": 29,
+        "wins": 7,
+        "draws": 10,
+        "losses": 12,
+        "scoresStr": "37-48",
+        "goalConDiff": -11,
+        "pts": 31,
+        "idx": 15,
+        "qualColor": null
+      },
+      {
+        "name": "Tottenham Hotspur",
+        "shortName": "Tottenham",
+        "id": 8586,
+        "pageUrl": "/teams/8586/overview/tottenham-hotspur",
+        "deduction": null,
+        "ongoing": null,
+        "played": 29,
+        "wins": 7,
+        "draws": 8,
+        "losses": 14,
+        "scoresStr": "39-46",
+        "goalConDiff": -7,
+        "pts": 29,
+        "idx": 16,
+        "qualColor": null
+      },
+      {
+        "name": "Nottingham Forest",
+        "shortName": "Nottm Forest",
+        "id": 10203,
+        "pageUrl": "/teams/10203/overview/nottingham-forest",
+        "deduction": null,
+        "ongoing": null,
+        "played": 29,
+        "wins": 7,
+        "draws": 7,
+        "losses": 15,
+        "scoresStr": "28-43",
+        "goalConDiff": -15,
+        "pts": 28,
+        "idx": 17,
+        "qualColor": null
+      },
+      {
+        "name": "West Ham United",
+        "shortName": "West Ham",
+        "id": 8654,
+        "pageUrl": "/teams/8654/overview/west-ham-united",
+        "deduction": null,
+        "ongoing": null,
+        "played": 29,
+        "wins": 7,
+        "draws": 7,
+        "losses": 15,
+        "scoresStr": "35-54",
+        "goalConDiff": -19,
+        "pts": 28,
+        "idx": 18,
+        "qualColor": "#FF4646"
+      },
+      {
+        "name": "Burnley",
+        "shortName": "Burnley",
+        "id": 8191,
+        "pageUrl": "/teams/8191/overview/burnley",
+        "deduction": null,
+        "ongoing": null,
+        "played": 29,
+        "wins": 4,
+        "draws": 7,
+        "losses": 18,
+        "scoresStr": "32-58",
+        "goalConDiff": -26,
+        "pts": 19,
+        "idx": 19,
+        "qualColor": "#FF4646"
+      },
+      {
+        "name": "Wolverhampton Wanderers",
+        "shortName": "Wolves",
+        "id": 8602,
+        "pageUrl": "/teams/8602/overview/wolverhampton-wanderers",
+        "deduction": null,
+        "ongoing": null,
+        "played": 30,
+        "wins": 3,
+        "draws": 7,
+        "losses": 20,
+        "scoresStr": "22-52",
+        "goalConDiff": -30,
+        "pts": 16,
+        "idx": 20,
+        "qualColor": "#FF4646"
+      }
+    ]
+  }
+}
--- a/docs/api_samples/extra_get_top_players_by_goals_47.json
+++ b/docs/api_samples/extra_get_top_players_by_goals_47.json
@@ -0,0 +1,67 @@
+{
+  "status": "success",
+  "response": {
+    "players": [
+      {
+        "id": 737066,
+        "name": "Erling Haaland",
+        "teamId": 8456,
+        "teamName": "Manchester City",
+        "goals": 22,
+        "value": 22,
+        "stat": {
+          "name": "goals",
+          "value": 22,
+          "format": "number",
+          "fractions": 0
+        },
+        "teamColors": {
+          "darkMode": "#76b4e5",
+          "lightMode": "#69A8D8",
+          "fontDarkMode": "rgba(29, 29, 29, 1.0)",
+          "fontLightMode": "rgba(255, 255, 255, 1.0)"
+        }
+      },
+      {
+        "id": 1302005,
+        "name": "Igor Thiago",
+        "teamId": 9937,
+        "teamName": "Brentford",
+        "goals": 18,
+        "value": 18,
+        "stat": {
+          "name": "goals",
+          "value": 18,
+          "format": "number",
+          "fractions": 0
+        },
+        "teamColors": {
+          "darkMode": "#C00808",
+          "lightMode": "#C00808",
+          "fontDarkMode": "rgba(255, 255, 255, 1.0)",
+          "fontLightMode": "rgba(255, 255, 255, 1.0)"
+        }
+      },
+      {
+        "id": 933576,
+        "name": "Antoine Semenyo",
+        "teamId": 8456,
+        "teamName": "Manchester City",
+        "goals": 15,
+        "value": 15,
+        "stat": {
+          "name": "goals",
+          "value": 15,
+          "format": "number",
+          "fractions": 0
+        },
+        "teamColors": {
+          "darkMode": "#76b4e5",
+          "lightMode": "#69A8D8",
+          "fontDarkMode": "rgba(29, 29, 29, 1.0)",
+          "fontLightMode": "rgba(255, 255, 255, 1.0)"
+        }
+      }
+    ]
+  }
+}
--- a/docs/api_samples/extra_get_trendingnews_.json
+++ b/docs/api_samples/extra_get_trendingnews_.json
@@ -0,0 +1,62 @@
+{
+  "status": "success",
+  "response": {
+    "news": [
+      {
+        "id": "ftbpro_01kk79jmekr0",
+        "imageUrl": "https://images2.minutemediacdn.com/image/upload/c_crop,w_1024,h_576,x_0,y_8/c_fill,w_912,h_516,f_auto,q_auto,g_auto/images/voltaxMediaLibrary/mmsport/si/01kk7af3bceybg72beqv.jpg",
+        "title": "Arsenal Need To Sell a Superstar: Four Players To Consider\u2014Ranked",
+        "gmtTime": "2026-03-08T23:00:00.000Z",
+        "sourceStr": "SI",
+        "sourceIconUrl": "https://images.fotmob.com/image_resources/news/si.png",
+        "page": {
+          "url": "/embed/news/01kk79jmekr0/arsenal-need-sell-superstar-four-players-considerranked"
+        }
+      },
+      {
+        "id": "ftbpro_01kk77nh7348",
+        "imageUrl": "https://images2.minutemediacdn.com/image/upload/c_crop,w_1919,h_1079,x_0,y_0/c_fill,w_912,h_516,f_auto,q_auto,g_auto/images/voltaxMediaLibrary/mmsport/si/01kk7b4hp7157m0sbm2f.jpg",
+        "title": "Transfer News, Rumors: Shock Zubimendi U-Turn Stings Man Utd; Real Madrid\u2019s Rodri Twist",
+        "gmtTime": "2026-03-09T00:05:00.000Z",
+        "sourceStr": "SI",
+        "sourceIconUrl": "https://images.fotmob.com/image_resources/news/si.png",
+        "page": {
+          "url": "/embed/news/01kk77nh7348/transfer-news-rumors-shock-zubimendi-u-turn-stings-man-utd-real-madrids-rodri-twist"
+        }
+      },
+      {
+        "id": "ftbpro_01khv73gpnbm",
+        "imageUrl": "https://images2.minutemediacdn.com/image/upload/c_crop,w_2141,h_1204,x_0,y_107/c_fill,w_912,h_516,f_auto,q_auto,g_auto/images/voltaxMediaLibrary/mmsport/si/01kj7qd6q1tmdh64dpn7.jpg",
+        "title": "Real Madrid\u2019s 10 Best Kits of All Time\u2014Ranked",
+        "gmtTime": "2026-03-08T22:00:00.000Z",
+        "sourceStr": "SI",
+        "sourceIconUrl": "https://images.fotmob.com/image_resources/news/si.png",
+        "page": {
+          "url": "/embed/news/01khv73gpnbm/real-madrids-10-best-kits-all-timeranked"
+        }
+      },
+      {
+        "id": "90hptfhwzvo61817ve6yo5cwr",
+        "imageUrl": "https://images.performgroup.com/di/library/omnisport/de/3d/pervis-estupinan_1vh3xc9744gyb15kz1mabotx3x.png?t=-741518868&w=520&h=300",
+        "title": "AC Milan 1-0 Inter: Estupinan strike settles Derby della Madonnina",
+        "gmtTime": "2026-03-08T22:55:22.000Z",
+        "sourceStr": "FotMob",
+        "sourceIconUrl": "https://images.fotmob.com/image_resources/news/fotmob.png",
+        "page": {
+          "url": "/news/90hptfhwzvo61817ve6yo5cwr-ac-milan-1-0-inter-estupinan-strike-settles-derby-della-madonnina"
+        }
+      },
+      {
+        "id": "ftbpro_01kk714gxhgj",
+        "imageUrl": "https://images2.minutemediacdn.com/image/upload/c_crop,w_1024,h_576,x_0,y_0/c_fill,w_912,h_516,f_auto,q_auto,g_auto/images/voltaxMediaLibrary/mmsport/si/01kk76ca6tg3gfyxsk6a.jpg",
+        "title": "'They Should Have Took Me'\u2014Tottenham Jibed By Record-Breaking English Manager",
+        "gmtTime": "2026-03-08T20:00:01.000Z",
+        "sourceStr": "SI",
+        "sourceIconUrl": "https://images.fotmob.com/image_resources/news/si.png",
+        "page": {
+          "url": "/embed/news/01kk714gxhgj/they-should-have-took-metottenham-jibed-record-breaking-english-manager"
+        }
+      }
+    ]
+  }
+}
--- a/docs/api_samples/sportsdb/01_v1_search_teams_arsenal.json
+++ b/docs/api_samples/sportsdb/01_v1_search_teams_arsenal.json
@@ -0,0 +1,70 @@
+{
+  "teams": [
+    {
+      "idTeam": "133604",
+      "idESPN": "359",
+      "idAPIfootball": "42",
+      "intLoved": "9",
+      "strTeam": "Arsenal",
+      "strTeamAlternate": "Arsenal Football Club, AFC, Arsenal FC",
+      "strTeamShort": "ARS",
+      "intFormedYear": "1892",
+      "strSport": "Soccer",
+      "strLeague": "English Premier League",
+      "idLeague": "4328",
+      "strLeague2": "FA Cup",
+      "idLeague2": "4482",
+      "strLeague3": "EFL Cup",
+      "idLeague3": "4570",
+      "strLeague4": "UEFA Champions League",
+      "idLeague4": "4480",
+      "strLeague5": "Emirates Cup",
+      "idLeague5": "5648",
+      "strLeague6": "",
+      "idLeague6": null,
+      "strLeague7": "",
+      "idLeague7": null,
+      "strDivision": null,
+      "idVenue": "15528",
+      "strStadium": "Emirates Stadium",
+      "strKeywords": "Gunners, Gooners",
+      "strRSS": "",
+      "strLocation": "Holloway, London, England",
+      "intStadiumCapacity": "60338",
+      "strWebsite": "www.arsenal.com",
+      "strFacebook": "www.facebook.com/Arsenal",
+      "strTwitter": "twitter.com/arsenal",
+      "strInstagram": "instagram.com/arsenal",
+      "strDescriptionEN": "Arsenal Football Club is a professional football club based in Islington, London, England, that plays in the Premier League, the top flight of English football. The club has won 13 League titles, a record 13 FA Cups, 2 League Cups, 15 FA Community Shields, 1 League Centenary Trophy, 1 UEFA Cup Winners' Cup and 1 Inter-Cities Fairs Cup.\r\n\r\nArsenal was the first club from the South of England to join The Football League, in 1893, and they reached the First Division in 1904. Relegated only once, in 1913, they continue the longest streak in the top division, and have won the second-most top-flight matches in English football history. In the 1930s, Arsenal won five League Championships and two FA Cups, and another FA Cup and two Championships after the war. In 1970\u201371, they won their first League and FA Cup Double. Between 1989 and 2005, they won five League titles and five FA Cups, including two more Doubles. They completed the 20th century with the highest average league position.\r\n\r\nHerbert Chapman won Arsenal's first national trophies, but died prematurely. He helped introduce the WM formation, floodlights, and shirt numbers, and added the white sleeves and brighter red to the club's kit. Ars\u00e8ne Wenger was the longest-serving manager and won the most trophies. He won a record 7 FA Cups, and his title-winning team set an English record for the longest top-flight unbeaten league run at 49 games between 2003 and 2004, receiving the nickname The Invincibles.\r\n\r\nIn 1886, Woolwich munitions workers founded the club as Dial Square. In 1913, the club crossed the city to Arsenal Stadium in Highbury, becoming close neighbours of Tottenham Hotspur, and creating the North London derby. In 2006, they moved to the nearby Emirates Stadium. In terms of revenue, Arsenal is the ninth highest-earning football club in the world, earned \u20ac487.6m in 2016\u201317 season. Based on social media activity from 2014 to 2015, Arsenal's fanbase is the fifth largest in the world. In 2018, Forbes estimated the club was the third most valuable in England, with the club being worth $2.24 billion.",
+      "strDescriptionDE": "Der FC Arsenal (offiziell: Arsenal Football Club) \u2013 auch bekannt als (The) Arsenal, (The) Gunners (deutsche \u00dcbersetzung: \u201eSch\u00fctzen\u201c oder \u201eKanoniere\u201c) oder im deutschen Sprachraum auch Arsenal London genannt \u2013 ist ein 1886 gegr\u00fcndeter Fu\u00dfballverein aus dem Ortsteil Holloway des Nordlondoner Bezirks Islington. Mit 13 englischen Meisterschaften und elf FA-Pokalsiegen z\u00e4hlt der Klub zu den erfolgreichsten englischen Fu\u00dfballvereinen.Erst \u00fcber 40 Jahre nach der Gr\u00fcndung gewann Arsenal mit f\u00fcnf Ligatiteln und zwei FA Cups in den 1930er Jahren seine ersten bedeutenden Titel. Der n\u00e4chste Meilenstein war in der Saison 1970/71 der Gewinn des zweiten englischen \u201eDoubles\u201c im 20. Jahrhundert. In den vergangenen 20 Jahren etablierte sich Arsenal endg\u00fcltig als einer der erfolgreichsten englischen Fu\u00dfballvereine, und beim Gewinn zweier weiterer Doubles zu Beginn des 21. Jahrhunderts blieb die Mannschaft in der Ligasaison 2003/04 als zweite in der englischen Fu\u00dfballgeschichte ungeschlagen. Zunehmende europ\u00e4ische Ambitionen unterstrich der Verein in der Spielzeit 2005/06, als Arsenal als erster Londoner Verein das Finale der Champions League erreichte.",
+      "strDescriptionFR": "Arsenal Football Club est un club de football anglais fond\u00e9 le 1er d\u00e9cembre 1886 \u00e0 Londres. Son si\u00e8ge est situ\u00e9 dans le borough londonien d'Islington.\r\n\r\nArsenal participe au championnat d'Angleterre de football depuis 1919 dont il a remport\u00e9 treize \u00e9ditions, ce qui en fait le troisi\u00e8me club le plus titr\u00e9 d'Angleterre, ainsi que treize coupes d'Angleterre ce qui constitue un record (devant Manchester United, qui en a remport\u00e9 12). Sur le plan continental, les Gunners (en fran\u00e7ais : \u00ab les canonniers \u00bb) comptent \u00e0 leur palmar\u00e8s une Coupe d'Europe des vainqueurs de coupe obtenue en 1994. Deux fois finalistes de cette coupe des vainqueurs de coupe en 1980 et 1995, ils ont \u00e9galement atteint les finales de la coupe de l'UEFA en 2000, de la Ligue des champions en 2006 et de l'Europa League en 2019.\r\n\r\nR\u00e9sident d\u00e8s 1913 du stade de Highbury, situ\u00e9 dans un quartier du nord de Londres, le club s\u2019est install\u00e9 en 2006 dans une nouvelle enceinte de 60 355 places : l'Emirates Stadium, situ\u00e9 \u00e0 Ashburton Grove. Arsenal nourrit une certaine rivalit\u00e9 avec les nombreux autres clubs de la capitale, mais celle l'opposant \u00e0 Tottenham Hotspur, avec qui il dispute chaque ann\u00e9e le \u00ab North London derby \u00bb est particuli\u00e8rement ancienne et profonde.\r\n\r\nLe club est dirig\u00e9 par Chips Keswick (en) qui succ\u00e8de pour raisons de sant\u00e9 en juin 2013 \u00e0 Peter Hill-Wood, fils et petit-fils des anciens pr\u00e9sidents Denis et Samuel Hill-Wood. Il remplace son p\u00e8re \u00e0 la mort de ce dernier, en 1982, apr\u00e8s vingt ans de responsabilit\u00e9s. Son entra\u00eeneur depuis le 29 novembre 2019 est le Su\u00e9dois Fredrik Ljungberg, ancien joueur du club, apr\u00e8s le limogeage de l\u2019Espagnol Unai Emery. Cependant le 20 d\u00e9cembre 2019, l'Espagnol Mikel Arteta, lui aussi ancien joueur du club, est nomm\u00e9 entra\u00eeneur. Il \u00e9tait avant sa nomination l'assistant de Pep Guardiola \u00e0 Manchester City",
+      "strDescriptionCN": null,
+      "strDescriptionIT": "L'Arsenal Football Club, noto semplicemente come Arsenal, \u00e8 una societ\u00e0 calcistica inglese con sede a Londra, pi\u00f9 precisamente nel quartiere di Holloway, nel borgo di Islington.[3]\r\n\r\nFondato nel 1886, \u00e8 uno dei quattordici club che rappresentano la citt\u00e0 di Londra a livello professionistico,[4] nonch\u00e9 uno dei pi\u00f9 antichi del Paese. Milita nella massima serie del calcio inglese ininterrottamente dal 1919-1920, risultando quindi la squadra da pi\u00f9 tempo presente in First Division/Premier League. \u00c8 la prima squadra della capitale del Regno Unito per successi sportivi e, in ambito federale, la terza dopo Manchester United e Liverpool, essendosi aggiudicata nel corso della sua storia tredici campionati inglesi, dodici FA Cup (record di vittorie, condiviso con il Manchester United), due League Cup e quattordici Community Shield (una condivisa),[5] mentre in ambito internazionale ha conquistato una Coppa delle Coppe ed una Coppa delle Fiere. Inoltre \u00e8 una delle tredici squadre che hanno raggiunto le finali di tutte le tre principali competizioni gestite dalla UEFA: Champions League (2005-2006), Coppa UEFA (1999-2000) e Coppa delle Coppe (1979-1980, 1993-1994 e 1994-1995).[6]\r\n\r\nI colori sociali, rosso per la maglietta e bianco per i pantaloncini, hanno sub\u00ecto variazioni pi\u00f9 o meno evidenti nel corso degli anni. Anche la sede del club \u00e8 stata cambiata pi\u00f9 volte: inizialmente la squadra giocava a Woolwich, ma nel 1913 si spost\u00f2 all'Arsenal Stadium, nel quartiere di Highbury; dal 2006 disputa invece le sue partite casalinghe nel nuovo Emirates Stadium. Lo stemma \u00e8 stato modificato ripetutamente, ma al suo interno \u00e8 sempre comparso almeno un cannone. Proprio per questo motivo i giocatori ed i tifosi dell'Arsenal sono spesso soprannominati Gunners (in italiano \"cannonieri\").\r\n\r\nL'Arsenal conta su una schiera di tifosi molto nutrita, distribuita in ogni parte del mondo. Nel corso degli anni sono sorte profonde rivalit\u00e0 con i sostenitori di club concittadini, la pi\u00f9 sentita delle quali \u00e8 quella con i seguaci del Tottenham Hotspur, con i quali i Gunners giocano regolarmente il North London derby.[7] L'Arsenal \u00e8 anche uno dei club pi\u00f9 ricchi del mondo, con un patrimonio stimato di 1,3 miliardi di dollari, secondo la rivista Forbes nel 2014, facendone il quinto club pi\u00f9 ricco del pianeta e il secondo in Inghilterra.[8]",
+      "strDescriptionJP": "\u30a2\u30fc\u30bb\u30ca\u30eb\u30fb\u30d5\u30c3\u30c8\u30dc\u30fc\u30eb\u30fb\u30af\u30e9\u30d6\uff08Arsenal Football Club\u3001\u30a4\u30ae\u30ea\u30b9\u82f1\u8a9e\u767a\u97f3: [\u02c8\u0251\u02d0s\u0259nl \u02c8fut\u02ccb\u0254\u02d0l kl\u028cb]\uff09\u306f\u3001\u30a4\u30f3\u30b0\u30e9\u30f3\u30c9\u306e\u9996\u90fd\u30ed\u30f3\u30c9\u30f3\u5317\u90e8\u3092\u30db\u30fc\u30e0\u30bf\u30a6\u30f3\u3068\u3059\u308b\u3001\u30a4\u30f3\u30b0\u30e9\u30f3\u30c9\u30d7\u30ed\u30b5\u30c3\u30ab\u30fc\u30ea\u30fc\u30b0\uff08\u30d7\u30ec\u30df\u30a2\u30ea\u30fc\u30b0\uff09\u306b\u52a0\u76df\u3059\u308b\u30d7\u30ed\u30b5\u30c3\u30ab\u30fc\u30af\u30e9\u30d6\u3002\u30af\u30e9\u30d6\u30ab\u30e9\u30fc\u306f\u8d64\u3068\u767d\u3002\r\n\r\n\u73fe\u5728\u306e\u30db\u30fc\u30e0\u30b9\u30bf\u30b8\u30a2\u30e0\u306f\u30ed\u30f3\u30c9\u30f3\u306e\u30a8\u30df\u30ec\u30fc\u30c4\u30fb\u30b9\u30bf\u30b8\u30a2\u30e0\uff08\u53ce\u5bb9\u4eba\u657060,260\u4eba\uff09\u3002\u30d7\u30ec\u30df\u30a2\u30ea\u30fc\u30b0\u306b\u6240\u5c5e\u3057\u3001\u540c\u30ea\u30fc\u30b0\u306b\u304a\u3044\u30663\u56de\u306e\u512a\u52dd\u8a18\u9332\u3092\u6301\u3064\uff08\u30d5\u30c3\u30c8\u30dc\u30fc\u30eb\u30ea\u30fc\u30b0\u6642\u4ee3\u3092\u542b\u3081\u308b\u306813\u56de\uff09\u30022003-2004\u30b7\u30fc\u30ba\u30f3\u306b\u306f\u7121\u6557\u512a\u52dd\u3092\u9054\u6210\u3057\u305f\u30a4\u30f3\u30b0\u30e9\u30f3\u30c9\u5c48\u6307\u306e\u5f37\u8c6a\u3067\u3042\u308b\u30021886\u5e74\u306b\u8ecd\u9700\u5de5\u5834\u306e\u52b4\u50cd\u8005\u306e\u30af\u30e9\u30d6\u3068\u3057\u3066\u5275\u8a2d\u3055\u308c\u305f\u305f\u3081\u3001\u30c1\u30fc\u30e0\u306e\u30a8\u30f3\u30d6\u30ec\u30e0\u306f\u5927\u7832\u306e\u30de\u30fc\u30af\u3092\u6301\u3064\u3002\u300c\u30ac\u30ca\u30fc\u30ba\uff08Gunners\uff09\u300d\u306e\u611b\u79f0\u3067\u77e5\u3089\u308c[1]\u3001\u30b5\u30dd\u30fc\u30bf\u30fc\u306f\u300c\u30b0\u30fc\u30ca\u30fc\uff08Gooner\uff09\u300d\u3068\u547c\u3070\u308c\u308b\u3002\r\n\r\n\u30af\u30e9\u30d6\u306e\u30e2\u30c3\u30c8\u30fc\u306f\u300c\u52dd\u5229\u306f\u8abf\u548c\u306e\u4e2d\u304b\u3089\u751f\u307e\u308c\u308b\uff08\u30e9\u30c6\u30f3\u8a9e: Victoria Concordia Crescit\uff09\u300d\u30021949\u5e74\u304b\u3089\u4f7f\u7528\u3055\u308c\u305f\u30af\u30ec\u30b9\u30c8\u306b\u521d\u3081\u3066\u767b\u5834\u3059\u308b\u3002\u73fe\u884c\u306e\u30af\u30ec\u30b9\u30c8\u306f2002\u5e74\u304b\u3089\u4f7f\u7528\u3055\u308c\u3066\u304a\u308a\u3001\u5927\u7832\u306e\u4e0a\u306b\u30b5\u30f3\u30bb\u30ea\u30d5\u4f53\u3067\u30c1\u30fc\u30e0\u540d\u304c\u66f8\u304b\u308c\u3066\u3044\u308b\u3002",
+      "strDescriptionRU": "\u00ab\u0410\u0440\u0441\u0435\u043d\u0430\u0301\u043b\u00bb (\u043e\u0444\u0438\u0446\u0438\u0430\u043b\u044c\u043d\u043e\u0435 \u043f\u043e\u043b\u043d\u043e\u0435 \u043d\u0430\u0437\u0432\u0430\u043d\u0438\u0435 \u2014 \u0424\u0443\u0442\u0431\u043e\u043b\u044c\u043d\u044b\u0439 \u043a\u043b\u0443\u0431 \u00ab\u0410\u0440\u0441\u0435\u043d\u0430\u043b\u00bb, \u0430\u043d\u0433\u043b. Arsenal Football Club, \u0430\u043d\u0433\u043b\u0438\u0439\u0441\u043a\u043e\u0435 \u043f\u0440\u043e\u0438\u0437\u043d\u043e\u0448\u0435\u043d\u0438\u0435: [\u02c8\u0251rs\u0259n\u0259l 'futb\u0254:l kl\u028cb]) \u2014 \u0430\u043d\u0433\u043b\u0438\u0439\u0441\u043a\u0438\u0439 \u043f\u0440\u043e\u0444\u0435\u0441\u0441\u0438\u043e\u043d\u0430\u043b\u044c\u043d\u044b\u0439 \u0444\u0443\u0442\u0431\u043e\u043b\u044c\u043d\u044b\u0439 \u043a\u043b\u0443\u0431 \u0438\u0437 \u0421\u0435\u0432\u0435\u0440\u043d\u043e\u0433\u043e \u041b\u043e\u043d\u0434\u043e\u043d\u0430, \u0432\u044b\u0441\u0442\u0443\u043f\u0430\u044e\u0449\u0438\u0439 \u0432 \u041f\u0440\u0435\u043c\u044c\u0435\u0440-\u043b\u0438\u0433\u0435. \u041e\u0441\u043d\u043e\u0432\u0430\u043d \u0432 \u043e\u043a\u0442\u044f\u0431\u0440\u0435 1886 \u0433\u043e\u0434\u0430. \u041a\u043b\u0443\u0431 13 \u0440\u0430\u0437 \u0441\u0442\u0430\u043d\u043e\u0432\u0438\u043b\u0441\u044f \u0447\u0435\u043c\u043f\u0438\u043e\u043d\u043e\u043c \u0410\u043d\u0433\u043b\u0438\u0438, 13 \u0440\u0430\u0437 \u0432\u044b\u0438\u0433\u0440\u044b\u0432\u0430\u043b \u041a\u0443\u0431\u043e\u043a \u0410\u043d\u0433\u043b\u0438\u0438. \u0414\u043e\u043c\u0430\u0448\u043d\u0438\u043c \u0441\u0442\u0430\u0434\u0438\u043e\u043d\u043e\u043c \u043a\u043b\u0443\u0431\u0430 \u044f\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u042d\u043c\u0438\u0440\u0435\u0439\u0442\u0441, \u0432\u043c\u0435\u0449\u0430\u044e\u0449\u0438\u0439 60 704 \u0437\u0440\u0438\u0442\u0435\u043b\u0435\u0439[1].\r\n\r\n\u00ab\u0410\u0440\u0441\u0435\u043d\u0430\u043b\u00bb \u043f\u0440\u043e\u0432\u0451\u043b \u0431\u043e\u0301\u043b\u044c\u0448\u0443\u044e \u0447\u0430\u0441\u0442\u044c \u0441\u0432\u043e\u0435\u0439 \u0438\u0441\u0442\u043e\u0440\u0438\u0438 \u0432 \u0432\u044b\u0441\u0448\u0435\u043c \u0434\u0438\u0432\u0438\u0437\u0438\u043e\u043d\u0435 \u0430\u043d\u0433\u043b\u0438\u0439\u0441\u043a\u043e\u0433\u043e \u0444\u0443\u0442\u0431\u043e\u043b\u0430, \u0432 1892 \u0433\u043e\u0434\u0443 \u0441\u0442\u0430\u043b \u043e\u0434\u043d\u0438\u043c \u0438\u0437 \u043a\u043b\u0443\u0431\u043e\u0432-\u043e\u0441\u043d\u043e\u0432\u0430\u0442\u0435\u043b\u0435\u0439 \u0430\u043d\u0433\u043b\u0438\u0439\u0441\u043a\u043e\u0439 \u041f\u0440\u0435\u043c\u044c\u0435\u0440-\u043b\u0438\u0433\u0438[4]. \u0422\u0430\u043a\u0436\u0435 \u043a\u043b\u0443\u0431 \u044f\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0440\u0435\u043a\u043e\u0440\u0434\u0441\u043c\u0435\u043d\u043e\u043c \u043f\u043e \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u0443 \u0441\u0435\u0437\u043e\u043d\u043e\u0432 \u043f\u043e\u0434\u0440\u044f\u0434, \u043f\u0440\u043e\u0432\u0435\u0434\u0451\u043d\u043d\u044b\u0445 \u0432 \u0432\u044b\u0441\u0448\u0435\u043c \u0434\u0438\u0432\u0438\u0437\u0438\u043e\u043d\u0435 \u0447\u0435\u043c\u043f\u0438\u043e\u043d\u0430\u0442\u0430 \u0410\u043d\u0433\u043b\u0438\u0438, \u043d\u0430\u0447\u0438\u043d\u0430\u044f \u0441 1919 \u0433\u043e\u0434\u0430[5].\r\n\r\n\u041f\u043e \u0434\u0430\u043d\u043d\u044b\u043c Forbes \u043d\u0430 2018 \u0433\u043e\u0434, \u00ab\u0410\u0440\u0441\u0435\u043d\u0430\u043b\u00bb \u0437\u0430\u043d\u0438\u043c\u0430\u043b \u0448\u0435\u0441\u0442\u043e\u0435 \u043c\u0435\u0441\u0442\u043e \u0432 \u0441\u043f\u0438\u0441\u043a\u0435 \u0441\u0430\u043c\u044b\u0445 \u0434\u043e\u0440\u043e\u0433\u0438\u0445 \u0444\u0443\u0442\u0431\u043e\u043b\u044c\u043d\u044b\u0445 \u043a\u043b\u0443\u0431\u043e\u0432 \u043c\u0438\u0440\u0430 \u0438 \u043e\u0446\u0435\u043d\u0438\u0432\u0430\u043b\u0441\u044f \u0432 \u0441\u0443\u043c\u043c\u0443 2,238 \u043c\u043b\u0440\u0434. \u0434\u043e\u043b\u043b\u0430\u0440\u043e\u0432 \u0421\u0428\u0410[6]. \u041f\u043e \u0434\u0430\u043d\u043d\u044b\u043c \u0430\u0443\u0434\u0438\u0442\u043e\u0440\u0441\u043a\u043e\u0439 \u043a\u043e\u043c\u043f\u0430\u043d\u0438\u0438 Deloitte, \u043f\u043e \u0438\u0442\u043e\u0433\u0430\u043c \u0441\u0435\u0437\u043e\u043d\u0430 2016/17 \u00ab\u0410\u0440\u0441\u0435\u043d\u0430\u043b\u00bb \u0437\u0430\u043d\u0438\u043c\u0430\u043b 6-\u044e \u0441\u0442\u0440\u043e\u0447\u043a\u0443 \u0432 \u0440\u0435\u0439\u0442\u0438\u043d\u0433\u0435 \u0441\u0430\u043c\u044b\u0445 \u0434\u043e\u0445\u043e\u0434\u043d\u044b\u0445 \u0444\u0443\u0442\u0431\u043e\u043b\u044c\u043d\u044b\u0445 \u043a\u043b\u0443\u0431\u043e\u0432 \u0441 \u0434\u043e\u0445\u043e\u0434\u043e\u043c \u0432 \u0440\u0430\u0437\u043c\u0435\u0440\u0435 487,6 \u043c\u043b\u043d \u0435\u0432\u0440\u043e[7].",
+      "strDescriptionES": "El Arsenal Football Club (pronunciaci\u00f3n en ingl\u00e9s: /\u02c8\u0251\u02d0(\u0279)s\u0259n\u0259l \u02c8f\u028at\u02ccb\u0254l kl\u028cb/) es un club de f\u00fatbol profesional con sede en Holloway, Londres, Inglaterra, que juega en la m\u00e1xima categor\u00eda del f\u00fatbol de ese pa\u00eds, la Premier League. Uno de los m\u00e1s laureados del f\u00fatbol ingl\u00e9s, ha ganado 43 t\u00edtulos en su pa\u00eds, incluyendo 13 campeonatos de liga y un r\u00e9cord de 13 Copas de Inglaterra; tambi\u00e9n ha ganado dos t\u00edtulos internacionales: la Copa europea de Ferias en 1970 y la Recopa de Europa en 1994.\r\n\r\nFundado en 1886 en el sudeste de Londres, en 1893, se convirti\u00f3 en el primer club del sur de Inglaterra en unirse a la Football League. Gan\u00f3 sus primeros t\u00edtulos \u2014cinco ligas y dos FA Cups\u2014 en los a\u00f1os 1930. Luego de un per\u00edodo de escasez en los a\u00f1os posteriores a la Segunda Guerra Mundial, se convirti\u00f3 en el segundo club del siglo XX en ganar el doblete, obteniendo el Campeonato de Liga y la FA Cup de la temporada 1970-71. Los logros siguieron en los a\u00f1os 1990 y 2000. Durante esos a\u00f1os, Arsenal gan\u00f3 un doblete de copas nacionales, dos dobletes de Liga y Copa, y dos bicampeonatos de la Copa de Inglaterra. Finaliz\u00f3 una temporada de Liga invicto y se convirti\u00f3 en el primer club de Londres en llegar a la final de la Liga de Campeones de la UEFA.\r\n\r\nLos colores tradicionales del club, el blanco y el rojo, han evolucionado con el tiempo. Del mismo modo, fue cambiando la ubicaci\u00f3n del club; fundado en el distrito de Woolwich, en el sureste de Londres, en 1913 se mud\u00f3 al norte de Londres, m\u00e1s exactamente en el distrito de Highbury, donde fue establecido el Arsenal Stadium, que funcion\u00f3 hasta 2006, donde se hizo un traslado m\u00e1s corto, hacia los alrededores de Holloway, donde se levant\u00f3 el actual Emirates Stadium. La estad\u00eda hist\u00f3rica del Arsenal en el norte de Londres, ha creado con el tiempo una fuerte rivalidad con el Tottenham Hotspur, conocida como el Derbi del Norte de Londres.4\u200b\r\n\r\nArsenal posee una de las aficiones m\u00e1s numerosas del mundo.5\u200b6\u200b7\u200b Seg\u00fan la revista Forbes, el club fue el quinto club m\u00e1s valioso del mundo en 2014, con un valor de 1300 millones libras.8\u200b",
+      "strDescriptionPT": "Arsenal Football Club \u00e9 um clube de futebol, fundado e baseado em Londres, capital da Inglaterra.\r\n\r\nO clube disputa a Premier League e \u00e9 um dos mais bem sucedidos do futebol ingl\u00eas, tendo ganhado por 13 vezes o t\u00edtulo de campe\u00e3o do Campeonato Ingl\u00eas, sendo o terceiro em n\u00famero de conquistas, e por 13 vezes a Copa da Inglaterra (recorde), sendo tamb\u00e9m detentor do recorde de maior per\u00edodo de invencibilidade no Campeonato Ingl\u00eas e tamb\u00e9m o de ser o \u00fanico a ganhar a Premier League invicto. No plano internacional, conquistou a Recopa Europeia e a Ta\u00e7a das Cidades com Feiras, j\u00e1 tendo sido finalista da Liga dos Campe\u00f5es da UEFA, a principal competi\u00e7\u00e3o europeia de clubes.\r\n\r\nO Arsenal mudou de localiza\u00e7\u00e3o ao longo do tempo, tendo sido fundado em Woolwich, sudeste de Londres, em 1913 mudou-se para o norte de Londres, para o Arsenal Stadium, em Highbury. Em 2006 foi conclu\u00edda a constru\u00e7\u00e3o do Emirates Stadium, que est\u00e1 localizado nas proximidades de Holloway, o que foi prometido desde 2004, ap\u00f3s o clube fechar neg\u00f3cio com a Emirates Airlines, tendo capacidade para mais de 60.000 expectadores.[3]\r\n\r\nO Arsenal tem muitos torcedores por todo mundo, possuindo uma s\u00e9rie de rivalidades de longa data com outros clubes, sendo a mais not\u00e1vel delas contra os vizinhos do Tottenham, com quem disputa regularmente o North London Derby, bastante intensas tamb\u00e9m contra o Chelsea e o Manchester United.[4]\r\n\r\nSuas cores t\u00eam sido tradicionalmente vermelho e branco, mas seus uniformes evolu\u00edram ao longo da hist\u00f3ria. Um outro grande feito \u00e9 o de ser um dos 5 \u00fanicos clubes do mundo que j\u00e1 venceram a Sele\u00e7\u00e3o Brasileira.[5] J\u00e1 o Arsenal Ladies, \u00e9 um dos clubes mais bem sucedidos do futebol feminino na Inglaterra.",
+      "strDescriptionSE": null,
+      "strDescriptionNL": null,
+      "strDescriptionHU": null,
+      "strDescriptionNO": "Arsenal Football Club er en engelsk fotballklubb som spiller i Premier League. Klubben ble stiftet i 1886, og ble valgt inn i The Football League i 1893. \u00abThe Gunners\u00bb, som er kallenavnet til Arsenal, spiller hjemmekampene sine p\u00e5 Emirates Stadium i Holloway. Holloway er et sted i bydelen Islington som ligger i det nordlige London.",
+      "strDescriptionIL": null,
+      "strDescriptionPL": null,
+      "strColour1": "#EF0107",
+      "strColour2": "#fbffff",
+      "strColour3": "#013373",
+      "strGender": "Male",
+      "strCountry": "England",
+      "strBadge": "https://r2.thesportsdb.com/images/media/team/badge/uyhbfe1612467038.png",
+      "strLogo": "https://r2.thesportsdb.com/images/media/team/logo/q2mxlz1512644512.png",
+      "strFanart1": "https://r2.thesportsdb.com/images/media/team/fanart/ouqjzl1769332470.jpg",
+      "strFanart2": "https://r2.thesportsdb.com/images/media/team/fanart/db23ct1769332477.jpg",
+      "strFanart3": "https://r2.thesportsdb.com/images/media/team/fanart/k3r9od1769332483.jpg",
+      "strFanart4": "https://r2.thesportsdb.com/images/media/team/fanart/2uvo8p1731313907.jpg",
+      "strBanner": "https://r2.thesportsdb.com/images/media/team/banner/24sngv1718273065.jpg",
+      "strEquipment": "https://r2.thesportsdb.com/images/media/team/equipment/fwav4f1752100996.png",
+      "strYoutube": "www.youtube.com/user/ArsenalTour",
+      "strLocked": "unlocked"
+    }
+  ]
+}
--- a/docs/api_samples/sportsdb/01_v1_search_teams_tfc.json
+++ b/docs/api_samples/sportsdb/01_v1_search_teams_tfc.json
@@ -0,0 +1,70 @@
+{
+  "teams": [
+    {
+      "idTeam": "134148",
+      "idESPN": null,
+      "idAPIfootball": "1601",
+      "intLoved": "2",
+      "strTeam": "Toronto FC",
+      "strTeamAlternate": "",
+      "strTeamShort": "TOR",
+      "intFormedYear": "2006",
+      "strSport": "Soccer",
+      "strLeague": "American Major League Soccer",
+      "idLeague": "4346",
+      "strLeague2": "Leagues Cup",
+      "idLeague2": "5281",
+      "strLeague3": "",
+      "idLeague3": null,
+      "strLeague4": "",
+      "idLeague4": null,
+      "strLeague5": "",
+      "idLeague5": null,
+      "strLeague6": "",
+      "idLeague6": null,
+      "strLeague7": "",
+      "idLeague7": null,
+      "strDivision": null,
+      "idVenue": "16782",
+      "strStadium": "BMO Field",
+      "strKeywords": "",
+      "strRSS": "",
+      "strLocation": "Toronto, Ontario",
+      "intStadiumCapacity": "30991",
+      "strWebsite": "www.torontofc.ca",
+      "strFacebook": "www.facebook.com/torontofc",
+      "strTwitter": "twitter.com/torontofc",
+      "strInstagram": "www.instagram.com/torontofc",
+      "strDescriptionEN": "Toronto Football Club is a Canadian professional soccer club based in Toronto. The club competes in Major League Soccer (MLS) as a member of the Eastern Conference. The team plays its home matches at BMO Field, located at Exhibition Place on Toronto's shoreline west of Downtown Toronto. Toronto FC joined MLS in 2007 as an expansion team and was the first Canadian-based franchise in the league.\r\n\r\nThe first team is operated by Maple Leaf Sports & Entertainment, which also operates the MLS Next Pro affiliate team Toronto FC II and most other professional sports franchises in the city, like the Toronto Maple Leafs of the NHL, Toronto Raptors of the NBA and the Toronto Argonauts of the CFL.\r\n\r\nIn 2017, Toronto FC won the domestic treble with the MLS Cup, Supporters' Shield and Canadian Championship. They are seven-time winners of the Canadian Championship and were runners-up of the 2018 CONCACAF Champions League, as well as the MLS Cup in 2016 and 2019.\r\n\r\nAs of 2019, the club has an estimated value of US$395 million, making them the fifth most valuable club behind Atlanta United, LA Galaxy, Los Angeles FC, and Seattle Sounders, and have the highest player payroll in Major League Soccer.",
+      "strDescriptionDE": null,
+      "strDescriptionFR": null,
+      "strDescriptionCN": null,
+      "strDescriptionIT": "Il Toronto FC \u00e8 una societ\u00e0 calcistica canadese con sede nella citt\u00e0 di Toronto, fondata nel 2005. Milita nella Major League Soccer (MLS), il massimo campionato di calcio degli Stati Uniti d'America e del Canada.[1]\r\n\r\n\u00c8 stato il primo club non statunitense ad entrare a far parte della MLS e il primo ad aggiudicarsi la MLS.[2] \u00c8 stato inoltre il primo club nordamericano (e finora unico) a centrare il treble, ovvero la vittoria della coppa nazionale (2017), della stagione regolare (2017) e della MLS Cup (2017) in un'unica stagione. In ambito nazionale vanta la vittoria di 7 Canadian Championship, mentre in ambito internazionale ha raggiunto la finale della CONCACAF Champions League nel 2018.\r\n\r\nIl club \u00e8 una delle 5 squadre ad ad aver conquistato nella stessa stagione l'MLS Cup e il Supporters' Shield.\r\n\r\nLa squadra disputa le partite interne allo stadio BMO Field di Toronto.",
+      "strDescriptionJP": null,
+      "strDescriptionRU": null,
+      "strDescriptionES": null,
+      "strDescriptionPT": null,
+      "strDescriptionSE": null,
+      "strDescriptionNL": null,
+      "strDescriptionHU": null,
+      "strDescriptionNO": null,
+      "strDescriptionIL": null,
+      "strDescriptionPL": null,
+      "strColour1": "#B81137",
+      "strColour2": "#455560",
+      "strColour3": "",
+      "strGender": "Male",
+      "strCountry": "Canada",
+      "strBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "strLogo": "https://r2.thesportsdb.com/images/media/team/logo/d1tbhj1547221736.png",
+      "strFanart1": "https://r2.thesportsdb.com/images/media/team/fanart/qxsttq1420795117.jpg",
+      "strFanart2": "https://r2.thesportsdb.com/images/media/team/fanart/ryfs3t1547729361.jpg",
+      "strFanart3": "https://r2.thesportsdb.com/images/media/team/fanart/vbstx91547729367.jpg",
+      "strFanart4": "https://r2.thesportsdb.com/images/media/team/fanart/tyw1av1547729372.jpg",
+      "strBanner": "https://r2.thesportsdb.com/images/media/team/banner/pssp4z1547805955.jpg",
+      "strEquipment": "https://www.thesportsdb.com/images/media/team/equipment/ly8y4n1766576019.png",
+      "strYoutube": "www.youtube.com/torontofc",
+      "strLocked": "unlocked"
+    }
+  ]
+}
--- a/docs/api_samples/sportsdb/01_v2_search_leagues_epl.json
+++ b/docs/api_samples/sportsdb/01_v2_search_leagues_epl.json
@@ -0,0 +1,3 @@
+{
+  "Message": "No data found"
+}
--- a/docs/api_samples/sportsdb/01_v2_search_leagues_mls.json
+++ b/docs/api_samples/sportsdb/01_v2_search_leagues_mls.json
@@ -0,0 +1,13 @@
+{
+  "search": [
+    {
+      "idLeague": "5279",
+      "strLeague": "MLS Next Pro",
+      "strSport": "Soccer",
+      "strBadge": "https://r2.thesportsdb.com/images/media/league/badge/vokzs71650475719.png",
+      "strCountry": "United States",
+      "strCurrentSeason": "2026",
+      "strGender": "Male"
+    }
+  ]
+}
--- a/docs/api_samples/sportsdb/02_v1_team_detail_tfc.json
+++ b/docs/api_samples/sportsdb/02_v1_team_detail_tfc.json
@@ -0,0 +1,70 @@
+{
+  "teams": [
+    {
+      "idTeam": "134148",
+      "idESPN": null,
+      "idAPIfootball": "1601",
+      "intLoved": "2",
+      "strTeam": "Toronto FC",
+      "strTeamAlternate": "",
+      "strTeamShort": "TOR",
+      "intFormedYear": "2006",
+      "strSport": "Soccer",
+      "strLeague": "American Major League Soccer",
+      "idLeague": "4346",
+      "strLeague2": "Leagues Cup",
+      "idLeague2": "5281",
+      "strLeague3": "",
+      "idLeague3": null,
+      "strLeague4": "",
+      "idLeague4": null,
+      "strLeague5": "",
+      "idLeague5": null,
+      "strLeague6": "",
+      "idLeague6": null,
+      "strLeague7": "",
+      "idLeague7": null,
+      "strDivision": null,
+      "idVenue": "16782",
+      "strStadium": "BMO Field",
+      "strKeywords": "",
+      "strRSS": "",
+      "strLocation": "Toronto, Ontario",
+      "intStadiumCapacity": "30991",
+      "strWebsite": "www.torontofc.ca",
+      "strFacebook": "www.facebook.com/torontofc",
+      "strTwitter": "twitter.com/torontofc",
+      "strInstagram": "www.instagram.com/torontofc",
+      "strDescriptionEN": "Toronto Football Club is a Canadian professional soccer club based in Toronto. The club competes in Major League Soccer (MLS) as a member of the Eastern Conference. The team plays its home matches at BMO Field, located at Exhibition Place on Toronto's shoreline west of Downtown Toronto. Toronto FC joined MLS in 2007 as an expansion team and was the first Canadian-based franchise in the league.\r\n\r\nThe first team is operated by Maple Leaf Sports & Entertainment, which also operates the MLS Next Pro affiliate team Toronto FC II and most other professional sports franchises in the city, like the Toronto Maple Leafs of the NHL, Toronto Raptors of the NBA and the Toronto Argonauts of the CFL.\r\n\r\nIn 2017, Toronto FC won the domestic treble with the MLS Cup, Supporters' Shield and Canadian Championship. They are seven-time winners of the Canadian Championship and were runners-up of the 2018 CONCACAF Champions League, as well as the MLS Cup in 2016 and 2019.\r\n\r\nAs of 2019, the club has an estimated value of US$395 million, making them the fifth most valuable club behind Atlanta United, LA Galaxy, Los Angeles FC, and Seattle Sounders, and have the highest player payroll in Major League Soccer.",
+      "strDescriptionDE": null,
+      "strDescriptionFR": null,
+      "strDescriptionCN": null,
+      "strDescriptionIT": "Il Toronto FC \u00e8 una societ\u00e0 calcistica canadese con sede nella citt\u00e0 di Toronto, fondata nel 2005. Milita nella Major League Soccer (MLS), il massimo campionato di calcio degli Stati Uniti d'America e del Canada.[1]\r\n\r\n\u00c8 stato il primo club non statunitense ad entrare a far parte della MLS e il primo ad aggiudicarsi la MLS.[2] \u00c8 stato inoltre il primo club nordamericano (e finora unico) a centrare il treble, ovvero la vittoria della coppa nazionale (2017), della stagione regolare (2017) e della MLS Cup (2017) in un'unica stagione. In ambito nazionale vanta la vittoria di 7 Canadian Championship, mentre in ambito internazionale ha raggiunto la finale della CONCACAF Champions League nel 2018.\r\n\r\nIl club \u00e8 una delle 5 squadre ad ad aver conquistato nella stessa stagione l'MLS Cup e il Supporters' Shield.\r\n\r\nLa squadra disputa le partite interne allo stadio BMO Field di Toronto.",
+      "strDescriptionJP": null,
+      "strDescriptionRU": null,
+      "strDescriptionES": null,
+      "strDescriptionPT": null,
+      "strDescriptionSE": null,
+      "strDescriptionNL": null,
+      "strDescriptionHU": null,
+      "strDescriptionNO": null,
+      "strDescriptionIL": null,
+      "strDescriptionPL": null,
+      "strColour1": "#B81137",
+      "strColour2": "#455560",
+      "strColour3": "",
+      "strGender": "Male",
+      "strCountry": "Canada",
+      "strBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "strLogo": "https://r2.thesportsdb.com/images/media/team/logo/d1tbhj1547221736.png",
+      "strFanart1": "https://r2.thesportsdb.com/images/media/team/fanart/qxsttq1420795117.jpg",
+      "strFanart2": "https://r2.thesportsdb.com/images/media/team/fanart/ryfs3t1547729361.jpg",
+      "strFanart3": "https://r2.thesportsdb.com/images/media/team/fanart/vbstx91547729367.jpg",
+      "strFanart4": "https://r2.thesportsdb.com/images/media/team/fanart/tyw1av1547729372.jpg",
+      "strBanner": "https://r2.thesportsdb.com/images/media/team/banner/pssp4z1547805955.jpg",
+      "strEquipment": "https://www.thesportsdb.com/images/media/team/equipment/ly8y4n1766576019.png",
+      "strYoutube": "www.youtube.com/torontofc",
+      "strLocked": "unlocked"
+    }
+  ]
+}
--- a/docs/api_samples/sportsdb/03_v1_next_tfc.json
+++ b/docs/api_samples/sportsdb/03_v1_next_tfc.json
@@ -0,0 +1,484 @@
+{
+  "events": [
+    {
+      "idEvent": "2406753",
+      "idAPIfootball": "1490151",
+      "strTimestamp": "2026-03-14T17:00:00",
+      "strEvent": "Toronto FC vs New York Red Bulls",
+      "strEventAlternate": "New York Red Bulls @ Toronto FC",
+      "strFilename": "American Major League Soccer 2026-03-14 Toronto FC vs New York Red Bulls",
+      "strSport": "Soccer",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strLeagueBadge": "https://r2.thesportsdb.com/images/media/league/badge/dqo6r91549878326.png",
+      "strSeason": "2026",
+      "strDescriptionEN": null,
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "New York Red Bulls",
+      "intHomeScore": null,
+      "intRound": "4",
+      "intAwayScore": null,
+      "intSpectators": null,
+      "strOfficial": "",
+      "dateEvent": "2026-03-14",
+      "dateEventLocal": null,
+      "strTime": "17:00:00",
+      "strTimeLocal": null,
+      "strGroup": null,
+      "idHomeTeam": "134148",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "idAwayTeam": "134156",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/suytvy1473536462.png",
+      "intScore": null,
+      "intScoreVotes": null,
+      "strResult": null,
+      "idVenue": "16782",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strCity": null,
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/4wgouh1706716030.jpg",
+      "strSquare": "https://r2.thesportsdb.com/images/media/event/square/l0z2931706714037.jpg",
+      "strFanart": null,
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/rt3hqv1706713405.jpg",
+      "strBanner": "https://r2.thesportsdb.com/images/media/event/banner/6lpnqd1706718691.jpg",
+      "strMap": null,
+      "strTweet1": null,
+      "strVideo": null,
+      "strStatus": "Not Started",
+      "strPostponed": "no",
+      "strLocked": "unlocked"
+    },
+    {
+      "idEvent": "2406768",
+      "idAPIfootball": "1490165",
+      "strTimestamp": "2026-03-21T17:00:00",
+      "strEvent": "Toronto FC vs Columbus Crew",
+      "strEventAlternate": "Columbus Crew @ Toronto FC",
+      "strFilename": "American Major League Soccer 2026-03-21 Toronto FC vs Columbus Crew",
+      "strSport": "Soccer",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strLeagueBadge": "https://r2.thesportsdb.com/images/media/league/badge/dqo6r91549878326.png",
+      "strSeason": "2026",
+      "strDescriptionEN": null,
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "Columbus Crew",
+      "intHomeScore": null,
+      "intRound": "5",
+      "intAwayScore": null,
+      "intSpectators": null,
+      "strOfficial": "",
+      "dateEvent": "2026-03-21",
+      "dateEventLocal": null,
+      "strTime": "17:00:00",
+      "strTimeLocal": null,
+      "strGroup": null,
+      "idHomeTeam": "134148",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "idAwayTeam": "134152",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/dzs8cp1629059854.png",
+      "intScore": null,
+      "intScoreVotes": null,
+      "strResult": null,
+      "idVenue": "16782",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strCity": null,
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/gdbc391706715993.jpg",
+      "strSquare": "https://r2.thesportsdb.com/images/media/event/square/pp3i0l1706714009.jpg",
+      "strFanart": null,
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/xab3h11706713371.jpg",
+      "strBanner": "https://r2.thesportsdb.com/images/media/event/banner/y2lohb1706718675.jpg",
+      "strMap": null,
+      "strTweet1": null,
+      "strVideo": null,
+      "strStatus": "Not Started",
+      "strPostponed": "no",
+      "strLocked": "unlocked"
+    },
+    {
+      "idEvent": "2406782",
+      "idAPIfootball": "1490180",
+      "strTimestamp": "2026-04-04T17:00:00",
+      "strEvent": "Toronto FC vs Colorado Rapids",
+      "strEventAlternate": "Colorado Rapids @ Toronto FC",
+      "strFilename": "American Major League Soccer 2026-04-04 Toronto FC vs Colorado Rapids",
+      "strSport": "Soccer",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strLeagueBadge": "https://r2.thesportsdb.com/images/media/league/badge/dqo6r91549878326.png",
+      "strSeason": "2026",
+      "strDescriptionEN": null,
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "Colorado Rapids",
+      "intHomeScore": null,
+      "intRound": "6",
+      "intAwayScore": null,
+      "intSpectators": null,
+      "strOfficial": "",
+      "dateEvent": "2026-04-04",
+      "dateEventLocal": null,
+      "strTime": "17:00:00",
+      "strTimeLocal": null,
+      "strGroup": null,
+      "idHomeTeam": "134148",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "idAwayTeam": "134794",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/uppupv1473536412.png",
+      "intScore": null,
+      "intScoreVotes": null,
+      "strResult": null,
+      "idVenue": "16782",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strCity": null,
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/tuqxzy1771753493.jpg",
+      "strSquare": "https://r2.thesportsdb.com/images/media/event/square/oqmxey1771754131.jpg",
+      "strFanart": null,
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/re0wo71771753307.jpg",
+      "strBanner": "https://r2.thesportsdb.com/images/media/event/banner/b4c9171771753983.jpg",
+      "strMap": null,
+      "strTweet1": null,
+      "strVideo": null,
+      "strStatus": "Not Started",
+      "strPostponed": "no",
+      "strLocked": "unlocked"
+    },
+    {
+      "idEvent": "2406798",
+      "idAPIfootball": "1490196",
+      "strTimestamp": "2026-04-11T17:00:00",
+      "strEvent": "Toronto FC vs FC Cincinnati",
+      "strEventAlternate": "FC Cincinnati @ Toronto FC",
+      "strFilename": "American Major League Soccer 2026-04-11 Toronto FC vs FC Cincinnati",
+      "strSport": "Soccer",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strLeagueBadge": "https://r2.thesportsdb.com/images/media/league/badge/dqo6r91549878326.png",
+      "strSeason": "2026",
+      "strDescriptionEN": null,
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "FC Cincinnati",
+      "intHomeScore": null,
+      "intRound": "7",
+      "intAwayScore": null,
+      "intSpectators": null,
+      "strOfficial": "",
+      "dateEvent": "2026-04-11",
+      "dateEventLocal": null,
+      "strTime": "17:00:00",
+      "strTimeLocal": null,
+      "strGroup": null,
+      "idHomeTeam": "134148",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "idAwayTeam": "136688",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/vvhsqc1707631046.png",
+      "intScore": null,
+      "intScoreVotes": null,
+      "strResult": null,
+      "idVenue": "16782",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strCity": null,
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/oag8hp1674489270.jpg",
+      "strSquare": "https://r2.thesportsdb.com/images/media/event/square/r6l2dl1706713803.jpg",
+      "strFanart": null,
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/p5mxz71706713223.jpg",
+      "strBanner": "https://r2.thesportsdb.com/images/media/event/banner/3do5bk1706718587.jpg",
+      "strMap": null,
+      "strTweet1": null,
+      "strVideo": null,
+      "strStatus": "Not Started",
+      "strPostponed": "no",
+      "strLocked": "unlocked"
+    },
+    {
+      "idEvent": "2406813",
+      "idAPIfootball": "1490212",
+      "strTimestamp": "2026-04-18T17:00:00",
+      "strEvent": "Toronto FC vs Austin FC",
+      "strEventAlternate": "Austin FC @ Toronto FC",
+      "strFilename": "American Major League Soccer 2026-04-18 Toronto FC vs Austin FC",
+      "strSport": "Soccer",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strLeagueBadge": "https://r2.thesportsdb.com/images/media/league/badge/dqo6r91549878326.png",
+      "strSeason": "2026",
+      "strDescriptionEN": null,
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "Austin FC",
+      "intHomeScore": null,
+      "intRound": "8",
+      "intAwayScore": null,
+      "intSpectators": null,
+      "strOfficial": "",
+      "dateEvent": "2026-04-18",
+      "dateEventLocal": null,
+      "strTime": "17:00:00",
+      "strTimeLocal": null,
+      "strGroup": null,
+      "idHomeTeam": "134148",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "idAwayTeam": "140079",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/a3dlg61595434277.png",
+      "intScore": null,
+      "intScoreVotes": null,
+      "strResult": null,
+      "idVenue": "16782",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strCity": null,
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/adf29m1771753504.jpg",
+      "strSquare": "https://r2.thesportsdb.com/images/media/event/square/ko7gbq1771754143.jpg",
+      "strFanart": null,
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/c7qigg1771753319.jpg",
+      "strBanner": "https://r2.thesportsdb.com/images/media/event/banner/iitgo81771753993.jpg",
+      "strMap": null,
+      "strTweet1": null,
+      "strVideo": null,
+      "strStatus": "Not Started",
+      "strPostponed": "no",
+      "strLocked": "unlocked"
+    },
+    {
+      "idEvent": "2406829",
+      "idAPIfootball": "1490227",
+      "strTimestamp": "2026-04-22T23:30:00",
+      "strEvent": "Toronto FC vs Philadelphia Union",
+      "strEventAlternate": "Philadelphia Union @ Toronto FC",
+      "strFilename": "American Major League Soccer 2026-04-22 Toronto FC vs Philadelphia Union",
+      "strSport": "Soccer",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strLeagueBadge": "https://r2.thesportsdb.com/images/media/league/badge/dqo6r91549878326.png",
+      "strSeason": "2026",
+      "strDescriptionEN": null,
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "Philadelphia Union",
+      "intHomeScore": null,
+      "intRound": "9",
+      "intAwayScore": null,
+      "intSpectators": null,
+      "strOfficial": "",
+      "dateEvent": "2026-04-22",
+      "dateEventLocal": null,
+      "strTime": "23:30:00",
+      "strTimeLocal": null,
+      "strGroup": null,
+      "idHomeTeam": "134148",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "idAwayTeam": "134142",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/gyznyo1602103682.png",
+      "intScore": null,
+      "intScoreVotes": null,
+      "strResult": null,
+      "idVenue": "16782",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strCity": null,
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/qx2k6k1706715901.jpg",
+      "strSquare": "https://r2.thesportsdb.com/images/media/event/square/ail0fh1706713966.jpg",
+      "strFanart": null,
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/8sfg181706713309.jpg",
+      "strBanner": "https://r2.thesportsdb.com/images/media/event/banner/z0ucvs1706718638.jpg",
+      "strMap": null,
+      "strTweet1": null,
+      "strVideo": null,
+      "strStatus": "Not Started",
+      "strPostponed": "no",
+      "strLocked": "unlocked"
+    },
+    {
+      "idEvent": "2406839",
+      "idAPIfootball": "1490237",
+      "strTimestamp": "2026-04-25T17:00:00",
+      "strEvent": "Toronto FC vs Atlanta United",
+      "strEventAlternate": "Atlanta United @ Toronto FC",
+      "strFilename": "American Major League Soccer 2026-04-25 Toronto FC vs Atlanta United",
+      "strSport": "Soccer",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strLeagueBadge": "https://r2.thesportsdb.com/images/media/league/badge/dqo6r91549878326.png",
+      "strSeason": "2026",
+      "strDescriptionEN": null,
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "Atlanta United",
+      "intHomeScore": null,
+      "intRound": "9",
+      "intAwayScore": null,
+      "intSpectators": null,
+      "strOfficial": "",
+      "dateEvent": "2026-04-25",
+      "dateEventLocal": null,
+      "strTime": "17:00:00",
+      "strTimeLocal": null,
+      "strGroup": null,
+      "idHomeTeam": "134148",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "idAwayTeam": "135851",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/ej091x1602103070.png",
+      "intScore": null,
+      "intScoreVotes": null,
+      "strResult": null,
+      "idVenue": "16782",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strCity": null,
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/0d1mu81674489091.jpg",
+      "strSquare": "https://r2.thesportsdb.com/images/media/event/square/1i0wk21706713736.jpg",
+      "strFanart": null,
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/lh56x71706713125.jpg",
+      "strBanner": "https://r2.thesportsdb.com/images/media/event/banner/349xhb1706718535.jpg",
+      "strMap": null,
+      "strTweet1": null,
+      "strVideo": null,
+      "strStatus": "Not Started",
+      "strPostponed": "no",
+      "strLocked": "unlocked"
+    },
+    {
+      "idEvent": "2406865",
+      "idAPIfootball": "1490252",
+      "strTimestamp": "2026-05-02T17:00:00",
+      "strEvent": "Toronto FC vs San Jose Earthquakes",
+      "strEventAlternate": "San Jose Earthquakes @ Toronto FC",
+      "strFilename": "American Major League Soccer 2026-05-02 Toronto FC vs San Jose Earthquakes",
+      "strSport": "Soccer",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strLeagueBadge": "https://r2.thesportsdb.com/images/media/league/badge/dqo6r91549878326.png",
+      "strSeason": "2026",
+      "strDescriptionEN": null,
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "San Jose Earthquakes",
+      "intHomeScore": null,
+      "intRound": "10",
+      "intAwayScore": null,
+      "intSpectators": null,
+      "strOfficial": "",
+      "dateEvent": "2026-05-02",
+      "dateEventLocal": null,
+      "strTime": "17:00:00",
+      "strTimeLocal": null,
+      "strGroup": null,
+      "idHomeTeam": "134148",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "idAwayTeam": "134157",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/xyrqqt1420781048.png",
+      "intScore": null,
+      "intScoreVotes": null,
+      "strResult": null,
+      "idVenue": "16782",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strCity": null,
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/epsk7c1659976798.jpg",
+      "strSquare": "https://r2.thesportsdb.com/images/media/event/square/3x100g1659980618.jpg",
+      "strFanart": null,
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/fqaaht1644524215.jpg",
+      "strBanner": "https://r2.thesportsdb.com/images/media/event/banner/mu24rs1659979032.jpg",
+      "strMap": null,
+      "strTweet1": null,
+      "strVideo": null,
+      "strStatus": "Not Started",
+      "strPostponed": "no",
+      "strLocked": "unlocked"
+    },
+    {
+      "idEvent": "2406878",
+      "idAPIfootball": "1490267",
+      "strTimestamp": "2026-05-09T17:00:00",
+      "strEvent": "Toronto FC vs Inter Miami",
+      "strEventAlternate": "Inter Miami @ Toronto FC",
+      "strFilename": "American Major League Soccer 2026-05-09 Toronto FC vs Inter Miami",
+      "strSport": "Soccer",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strLeagueBadge": "https://r2.thesportsdb.com/images/media/league/badge/dqo6r91549878326.png",
+      "strSeason": "2026",
+      "strDescriptionEN": null,
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "Inter Miami",
+      "intHomeScore": null,
+      "intRound": "11",
+      "intAwayScore": null,
+      "intSpectators": null,
+      "strOfficial": "",
+      "dateEvent": "2026-05-09",
+      "dateEventLocal": null,
+      "strTime": "17:00:00",
+      "strTimeLocal": null,
+      "strGroup": null,
+      "idHomeTeam": "134148",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "idAwayTeam": "137699",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/m4it3e1602103647.png",
+      "intScore": null,
+      "intScoreVotes": null,
+      "strResult": null,
+      "idVenue": "16782",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strCity": null,
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/yg9alq1706716044.jpg",
+      "strSquare": "https://r2.thesportsdb.com/images/media/event/square/2p6ac91706714071.jpg",
+      "strFanart": null,
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/jqdmuw1706713416.jpg",
+      "strBanner": "https://r2.thesportsdb.com/images/media/event/banner/jaqgyc1706718698.jpg",
+      "strMap": null,
+      "strTweet1": null,
+      "strVideo": null,
+      "strStatus": "Not Started",
+      "strPostponed": "no",
+      "strLocked": "unlocked"
+    },
+    {
+      "idEvent": "2406900",
+      "idAPIfootball": "1490298",
+      "strTimestamp": "2026-05-16T23:30:00",
+      "strEvent": "Charlotte FC vs Toronto FC",
+      "strEventAlternate": "Toronto FC @ Charlotte FC",
+      "strFilename": "American Major League Soccer 2026-05-16 Charlotte FC vs Toronto FC",
+      "strSport": "Soccer",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strLeagueBadge": "https://r2.thesportsdb.com/images/media/league/badge/dqo6r91549878326.png",
+      "strSeason": "2026",
+      "strDescriptionEN": null,
+      "strHomeTeam": "Charlotte FC",
+      "strAwayTeam": "Toronto FC",
+      "intHomeScore": null,
+      "intRound": "12",
+      "intAwayScore": null,
+      "intSpectators": null,
+      "strOfficial": "",
+      "dateEvent": "2026-05-16",
+      "dateEventLocal": null,
+      "strTime": "23:30:00",
+      "strTimeLocal": null,
+      "strGroup": null,
+      "idHomeTeam": "140078",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/b6p4uz1595434047.png",
+      "idAwayTeam": "134148",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "intScore": null,
+      "intScoreVotes": null,
+      "strResult": null,
+      "idVenue": "18776",
+      "strVenue": "Bank of America Stadium",
+      "strCountry": "United States",
+      "strCity": null,
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/dekc1y1674489274.jpg",
+      "strSquare": "https://r2.thesportsdb.com/images/media/event/square/21yoe01706713753.jpg",
+      "strFanart": null,
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/1n0kgw1706713151.jpg",
+      "strBanner": "https://r2.thesportsdb.com/images/media/event/banner/q1vueq1706718550.jpg",
+      "strMap": null,
+      "strTweet1": null,
+      "strVideo": null,
+      "strStatus": "Not Started",
+      "strPostponed": "no",
+      "strLocked": "unlocked"
+    }
+  ]
+}
--- a/docs/api_samples/sportsdb/03_v1_previous_tfc.json
+++ b/docs/api_samples/sportsdb/03_v1_previous_tfc.json
@@ -0,0 +1,244 @@
+{
+  "results": [
+    {
+      "idEvent": "2406751",
+      "idAPIfootball": "1490149",
+      "strTimestamp": "2026-03-08T23:00:00",
+      "strEvent": "FC Cincinnati vs Toronto FC",
+      "strEventAlternate": "Toronto FC @ FC Cincinnati",
+      "strFilename": "American Major League Soccer 2026-03-08 FC Cincinnati vs Toronto FC",
+      "strSport": "Soccer",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strLeagueBadge": "https://r2.thesportsdb.com/images/media/league/badge/dqo6r91549878326.png",
+      "strSeason": "2026",
+      "strDescriptionEN": "",
+      "strHomeTeam": "FC Cincinnati",
+      "strAwayTeam": "Toronto FC",
+      "intHomeScore": "0",
+      "intRound": "3",
+      "intAwayScore": "1",
+      "intSpectators": null,
+      "strOfficial": "",
+      "dateEvent": "2026-03-08",
+      "dateEventLocal": "2026-03-08",
+      "strTime": "23:00:00",
+      "strTimeLocal": "18:00:00",
+      "strGroup": "",
+      "idHomeTeam": "136688",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/vvhsqc1707631046.png",
+      "idAwayTeam": "134148",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "intScore": null,
+      "intScoreVotes": null,
+      "strResult": "",
+      "idVenue": "20820",
+      "strVenue": "TQL Stadium",
+      "strCountry": "United States",
+      "strCity": "",
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/tnm6721674489170.jpg",
+      "strSquare": "https://r2.thesportsdb.com/images/media/event/square/frynnc1706713440.jpg",
+      "strFanart": null,
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/7xrdgm1706713089.jpg",
+      "strBanner": "https://r2.thesportsdb.com/images/media/event/banner/zkk3rl1706718516.jpg",
+      "strMap": null,
+      "strTweet1": "",
+      "strVideo": "https://www.youtube.com/watch?v=LloAaRmqvag",
+      "strStatus": "Match Finished",
+      "strPostponed": "no",
+      "strLocked": "unlocked"
+    },
+    {
+      "idEvent": "2406731",
+      "idAPIfootball": "1490129",
+      "strTimestamp": "2026-03-01T02:30:00",
+      "strEvent": "Vancouver Whitecaps vs Toronto FC",
+      "strEventAlternate": "Toronto FC @ Vancouver Whitecaps",
+      "strFilename": "American Major League Soccer 2026-03-01 Vancouver Whitecaps vs Toronto FC",
+      "strSport": "Soccer",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strLeagueBadge": "https://r2.thesportsdb.com/images/media/league/badge/dqo6r91549878326.png",
+      "strSeason": "2026",
+      "strDescriptionEN": "",
+      "strHomeTeam": "Vancouver Whitecaps",
+      "strAwayTeam": "Toronto FC",
+      "intHomeScore": "3",
+      "intRound": "2",
+      "intAwayScore": "0",
+      "intSpectators": null,
+      "strOfficial": "",
+      "dateEvent": "2026-03-01",
+      "dateEventLocal": "2026-02-28",
+      "strTime": "02:30:00",
+      "strTimeLocal": "18:30:00",
+      "strGroup": "",
+      "idHomeTeam": "134147",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/tpwxpy1473536521.png",
+      "idAwayTeam": "134148",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "intScore": null,
+      "intScoreVotes": null,
+      "strResult": "",
+      "idVenue": "25843",
+      "strVenue": "BC Place",
+      "strCountry": "Canada",
+      "strCity": "",
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/oolq431659976740.jpg",
+      "strSquare": "https://r2.thesportsdb.com/images/media/event/square/ecyoz01706713746.jpg",
+      "strFanart": null,
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/7r0ggq1706713138.jpg",
+      "strBanner": "https://r2.thesportsdb.com/images/media/event/banner/4lwklu1706718544.jpg",
+      "strMap": null,
+      "strTweet1": "",
+      "strVideo": "https://www.youtube.com/watch?v=RTawJpGyvPg",
+      "strStatus": "Match Finished",
+      "strPostponed": "no",
+      "strLocked": "unlocked"
+    },
+    {
+      "idEvent": "2406713",
+      "idAPIfootball": "1490781",
+      "strTimestamp": "2026-02-22T01:30:00",
+      "strEvent": "FC Dallas vs Toronto FC",
+      "strEventAlternate": "Toronto FC @ FC Dallas",
+      "strFilename": "American Major League Soccer 2026-02-22 FC Dallas vs Toronto FC",
+      "strSport": "Soccer",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strLeagueBadge": "https://r2.thesportsdb.com/images/media/league/badge/dqo6r91549878326.png",
+      "strSeason": "2026",
+      "strDescriptionEN": "",
+      "strHomeTeam": "FC Dallas",
+      "strAwayTeam": "Toronto FC",
+      "intHomeScore": "3",
+      "intRound": "1",
+      "intAwayScore": "2",
+      "intSpectators": null,
+      "strOfficial": "",
+      "dateEvent": "2026-02-22",
+      "dateEventLocal": "2026-02-21",
+      "strTime": "01:30:00",
+      "strTimeLocal": "19:30:00",
+      "strGroup": "",
+      "idHomeTeam": "134146",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/vxy8xy1602103187.png",
+      "idAwayTeam": "134148",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "intScore": null,
+      "intScoreVotes": null,
+      "strResult": "",
+      "idVenue": "16781",
+      "strVenue": "Toyota Stadium Dallas",
+      "strCountry": "United States",
+      "strCity": "",
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/9bjukc1659976671.jpg",
+      "strSquare": "https://r2.thesportsdb.com/images/media/event/square/fj461l1659980511.jpg",
+      "strFanart": null,
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/owuytt1644524082.jpg",
+      "strBanner": "https://r2.thesportsdb.com/images/media/event/banner/1yvzoa1659978946.jpg",
+      "strMap": null,
+      "strTweet1": "",
+      "strVideo": "https://www.youtube.com/watch?v=Sf5YmqW5ONo",
+      "strStatus": "Match Finished",
+      "strPostponed": "no",
+      "strLocked": "unlocked"
+    },
+    {
+      "idEvent": "2425216",
+      "idAPIfootball": "1514800",
+      "strTimestamp": "2026-02-14T09:45:00",
+      "strEvent": "Toronto FC vs Polissya Zhytomyr",
+      "strEventAlternate": "Polissya Zhytomyr @ Toronto FC",
+      "strFilename": "Club Friendlies 2026-02-14 Toronto FC vs Polissya Zhytomyr",
+      "strSport": "Soccer",
+      "idLeague": "4569",
+      "strLeague": "Club Friendlies",
+      "strLeagueBadge": "https://r2.thesportsdb.com/images/media/league/badge/gb18781565430778.png",
+      "strSeason": "2026",
+      "strDescriptionEN": "",
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "Polissya Zhytomyr",
+      "intHomeScore": "2",
+      "intRound": "0",
+      "intAwayScore": "1",
+      "intSpectators": null,
+      "strOfficial": "",
+      "dateEvent": "2026-02-14",
+      "dateEventLocal": "2026-02-14",
+      "strTime": "09:45:00",
+      "strTimeLocal": "04:45:00",
+      "strGroup": "",
+      "idHomeTeam": "134148",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "idAwayTeam": "140180",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/6r8o5l1725171180.png",
+      "intScore": null,
+      "intScoreVotes": null,
+      "strResult": "",
+      "idVenue": "16782",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strCity": "",
+      "strPoster": "",
+      "strSquare": "",
+      "strFanart": null,
+      "strThumb": "",
+      "strBanner": "",
+      "strMap": null,
+      "strTweet1": "",
+      "strVideo": "",
+      "strStatus": "Match Finished",
+      "strPostponed": "no",
+      "strLocked": "unlocked"
+    },
+    {
+      "idEvent": "2425209",
+      "idAPIfootball": "1514792",
+      "strTimestamp": "2026-02-11T11:00:00",
+      "strEvent": "Toronto FC vs Fredrikstad",
+      "strEventAlternate": "Fredrikstad @ Toronto FC",
+      "strFilename": "Club Friendlies 2026-02-11 Toronto FC vs Fredrikstad",
+      "strSport": "Soccer",
+      "idLeague": "4569",
+      "strLeague": "Club Friendlies",
+      "strLeagueBadge": "https://r2.thesportsdb.com/images/media/league/badge/gb18781565430778.png",
+      "strSeason": "2026",
+      "strDescriptionEN": "",
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "Fredrikstad",
+      "intHomeScore": "0",
+      "intRound": "0",
+      "intAwayScore": "1",
+      "intSpectators": null,
+      "strOfficial": "",
+      "dateEvent": "2026-02-11",
+      "dateEventLocal": "2026-02-11",
+      "strTime": "11:00:00",
+      "strTimeLocal": "06:00:00",
+      "strGroup": "",
+      "idHomeTeam": "134148",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "idAwayTeam": "134749",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/9se6qv1690695269.png",
+      "intScore": null,
+      "intScoreVotes": null,
+      "strResult": "",
+      "idVenue": "16782",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strCity": "",
+      "strPoster": "",
+      "strSquare": "",
+      "strFanart": null,
+      "strThumb": "",
+      "strBanner": "",
+      "strMap": null,
+      "strTweet1": "",
+      "strVideo": "",
+      "strStatus": "Match Finished",
+      "strPostponed": "no",
+      "strLocked": "unlocked"
+    }
+  ]
+}
--- a/docs/api_samples/sportsdb/03_v2_next_tfc.json
+++ b/docs/api_samples/sportsdb/03_v2_next_tfc.json
@@ -0,0 +1,294 @@
+{
+  "schedule": [
+    {
+      "idEvent": "2406753",
+      "strEvent": "Toronto FC vs New York Red Bulls",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strSport": "Soccer",
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "New York Red Bulls",
+      "idHomeTeam": "134148",
+      "idAwayTeam": "134156",
+      "intRound": "4",
+      "intHomeScore": null,
+      "intAwayScore": null,
+      "strTimestamp": "2026-03-14T17:00:00",
+      "dateEvent": "2026-03-14",
+      "dateEventLocal": null,
+      "strTime": "17:00:00",
+      "strTimeLocal": null,
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/suytvy1473536462.png",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/rt3hqv1706713405.jpg",
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/4wgouh1706716030.jpg",
+      "strVideo": null,
+      "strPostponed": "no",
+      "strFilename": "American Major League Soccer 2026-03-14 Toronto FC vs New York Red Bulls",
+      "strStatus": "Not Started"
+    },
+    {
+      "idEvent": "2406768",
+      "strEvent": "Toronto FC vs Columbus Crew",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strSport": "Soccer",
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "Columbus Crew",
+      "idHomeTeam": "134148",
+      "idAwayTeam": "134152",
+      "intRound": "5",
+      "intHomeScore": null,
+      "intAwayScore": null,
+      "strTimestamp": "2026-03-21T17:00:00",
+      "dateEvent": "2026-03-21",
+      "dateEventLocal": null,
+      "strTime": "17:00:00",
+      "strTimeLocal": null,
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/dzs8cp1629059854.png",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/xab3h11706713371.jpg",
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/gdbc391706715993.jpg",
+      "strVideo": null,
+      "strPostponed": "no",
+      "strFilename": "American Major League Soccer 2026-03-21 Toronto FC vs Columbus Crew",
+      "strStatus": "Not Started"
+    },
+    {
+      "idEvent": "2406782",
+      "strEvent": "Toronto FC vs Colorado Rapids",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strSport": "Soccer",
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "Colorado Rapids",
+      "idHomeTeam": "134148",
+      "idAwayTeam": "134794",
+      "intRound": "6",
+      "intHomeScore": null,
+      "intAwayScore": null,
+      "strTimestamp": "2026-04-04T17:00:00",
+      "dateEvent": "2026-04-04",
+      "dateEventLocal": null,
+      "strTime": "17:00:00",
+      "strTimeLocal": null,
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/uppupv1473536412.png",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/re0wo71771753307.jpg",
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/tuqxzy1771753493.jpg",
+      "strVideo": null,
+      "strPostponed": "no",
+      "strFilename": "American Major League Soccer 2026-04-04 Toronto FC vs Colorado Rapids",
+      "strStatus": "Not Started"
+    },
+    {
+      "idEvent": "2406798",
+      "strEvent": "Toronto FC vs FC Cincinnati",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strSport": "Soccer",
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "FC Cincinnati",
+      "idHomeTeam": "134148",
+      "idAwayTeam": "136688",
+      "intRound": "7",
+      "intHomeScore": null,
+      "intAwayScore": null,
+      "strTimestamp": "2026-04-11T17:00:00",
+      "dateEvent": "2026-04-11",
+      "dateEventLocal": null,
+      "strTime": "17:00:00",
+      "strTimeLocal": null,
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/vvhsqc1707631046.png",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/p5mxz71706713223.jpg",
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/oag8hp1674489270.jpg",
+      "strVideo": null,
+      "strPostponed": "no",
+      "strFilename": "American Major League Soccer 2026-04-11 Toronto FC vs FC Cincinnati",
+      "strStatus": "Not Started"
+    },
+    {
+      "idEvent": "2406813",
+      "strEvent": "Toronto FC vs Austin FC",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strSport": "Soccer",
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "Austin FC",
+      "idHomeTeam": "134148",
+      "idAwayTeam": "140079",
+      "intRound": "8",
+      "intHomeScore": null,
+      "intAwayScore": null,
+      "strTimestamp": "2026-04-18T17:00:00",
+      "dateEvent": "2026-04-18",
+      "dateEventLocal": null,
+      "strTime": "17:00:00",
+      "strTimeLocal": null,
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/a3dlg61595434277.png",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/c7qigg1771753319.jpg",
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/adf29m1771753504.jpg",
+      "strVideo": null,
+      "strPostponed": "no",
+      "strFilename": "American Major League Soccer 2026-04-18 Toronto FC vs Austin FC",
+      "strStatus": "Not Started"
+    },
+    {
+      "idEvent": "2406829",
+      "strEvent": "Toronto FC vs Philadelphia Union",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strSport": "Soccer",
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "Philadelphia Union",
+      "idHomeTeam": "134148",
+      "idAwayTeam": "134142",
+      "intRound": "9",
+      "intHomeScore": null,
+      "intAwayScore": null,
+      "strTimestamp": "2026-04-22T23:30:00",
+      "dateEvent": "2026-04-22",
+      "dateEventLocal": null,
+      "strTime": "23:30:00",
+      "strTimeLocal": null,
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/gyznyo1602103682.png",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/8sfg181706713309.jpg",
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/qx2k6k1706715901.jpg",
+      "strVideo": null,
+      "strPostponed": "no",
+      "strFilename": "American Major League Soccer 2026-04-22 Toronto FC vs Philadelphia Union",
+      "strStatus": "Not Started"
+    },
+    {
+      "idEvent": "2406839",
+      "strEvent": "Toronto FC vs Atlanta United",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strSport": "Soccer",
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "Atlanta United",
+      "idHomeTeam": "134148",
+      "idAwayTeam": "135851",
+      "intRound": "9",
+      "intHomeScore": null,
+      "intAwayScore": null,
+      "strTimestamp": "2026-04-25T17:00:00",
+      "dateEvent": "2026-04-25",
+      "dateEventLocal": null,
+      "strTime": "17:00:00",
+      "strTimeLocal": null,
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/ej091x1602103070.png",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/lh56x71706713125.jpg",
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/0d1mu81674489091.jpg",
+      "strVideo": null,
+      "strPostponed": "no",
+      "strFilename": "American Major League Soccer 2026-04-25 Toronto FC vs Atlanta United",
+      "strStatus": "Not Started"
+    },
+    {
+      "idEvent": "2406865",
+      "strEvent": "Toronto FC vs San Jose Earthquakes",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strSport": "Soccer",
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "San Jose Earthquakes",
+      "idHomeTeam": "134148",
+      "idAwayTeam": "134157",
+      "intRound": "10",
+      "intHomeScore": null,
+      "intAwayScore": null,
+      "strTimestamp": "2026-05-02T17:00:00",
+      "dateEvent": "2026-05-02",
+      "dateEventLocal": null,
+      "strTime": "17:00:00",
+      "strTimeLocal": null,
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/xyrqqt1420781048.png",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/fqaaht1644524215.jpg",
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/epsk7c1659976798.jpg",
+      "strVideo": null,
+      "strPostponed": "no",
+      "strFilename": "American Major League Soccer 2026-05-02 Toronto FC vs San Jose Earthquakes",
+      "strStatus": "Not Started"
+    },
+    {
+      "idEvent": "2406878",
+      "strEvent": "Toronto FC vs Inter Miami",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strSport": "Soccer",
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "Inter Miami",
+      "idHomeTeam": "134148",
+      "idAwayTeam": "137699",
+      "intRound": "11",
+      "intHomeScore": null,
+      "intAwayScore": null,
+      "strTimestamp": "2026-05-09T17:00:00",
+      "dateEvent": "2026-05-09",
+      "dateEventLocal": null,
+      "strTime": "17:00:00",
+      "strTimeLocal": null,
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/m4it3e1602103647.png",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/jqdmuw1706713416.jpg",
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/yg9alq1706716044.jpg",
+      "strVideo": null,
+      "strPostponed": "no",
+      "strFilename": "American Major League Soccer 2026-05-09 Toronto FC vs Inter Miami",
+      "strStatus": "Not Started"
+    },
+    {
+      "idEvent": "2406900",
+      "strEvent": "Charlotte FC vs Toronto FC",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strSport": "Soccer",
+      "strHomeTeam": "Charlotte FC",
+      "strAwayTeam": "Toronto FC",
+      "idHomeTeam": "140078",
+      "idAwayTeam": "134148",
+      "intRound": "12",
+      "intHomeScore": null,
+      "intAwayScore": null,
+      "strTimestamp": "2026-05-16T23:30:00",
+      "dateEvent": "2026-05-16",
+      "dateEventLocal": null,
+      "strTime": "23:30:00",
+      "strTimeLocal": null,
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/b6p4uz1595434047.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "strVenue": "Bank of America Stadium",
+      "strCountry": "United States",
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/1n0kgw1706713151.jpg",
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/dekc1y1674489274.jpg",
+      "strVideo": null,
+      "strPostponed": "no",
+      "strFilename": "American Major League Soccer 2026-05-16 Charlotte FC vs Toronto FC",
+      "strStatus": "Not Started"
+    }
+  ]
+}
--- a/docs/api_samples/sportsdb/03_v2_previous_tfc.json
+++ b/docs/api_samples/sportsdb/03_v2_previous_tfc.json
@@ -0,0 +1,294 @@
+{
+  "schedule": [
+    {
+      "idEvent": "2406751",
+      "strEvent": "FC Cincinnati vs Toronto FC",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strSport": "Soccer",
+      "strHomeTeam": "FC Cincinnati",
+      "strAwayTeam": "Toronto FC",
+      "idHomeTeam": "136688",
+      "idAwayTeam": "134148",
+      "intRound": "3",
+      "intHomeScore": "0",
+      "intAwayScore": "1",
+      "strTimestamp": "2026-03-08T23:00:00",
+      "dateEvent": "2026-03-08",
+      "dateEventLocal": "2026-03-08",
+      "strTime": "23:00:00",
+      "strTimeLocal": "18:00:00",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/vvhsqc1707631046.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "strVenue": "TQL Stadium",
+      "strCountry": "United States",
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/7xrdgm1706713089.jpg",
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/tnm6721674489170.jpg",
+      "strVideo": "https://www.youtube.com/watch?v=LloAaRmqvag",
+      "strPostponed": "no",
+      "strFilename": "American Major League Soccer 2026-03-08 FC Cincinnati vs Toronto FC",
+      "strStatus": "Match Finished"
+    },
+    {
+      "idEvent": "2406731",
+      "strEvent": "Vancouver Whitecaps vs Toronto FC",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strSport": "Soccer",
+      "strHomeTeam": "Vancouver Whitecaps",
+      "strAwayTeam": "Toronto FC",
+      "idHomeTeam": "134147",
+      "idAwayTeam": "134148",
+      "intRound": "2",
+      "intHomeScore": "3",
+      "intAwayScore": "0",
+      "strTimestamp": "2026-03-01T02:30:00",
+      "dateEvent": "2026-03-01",
+      "dateEventLocal": "2026-02-28",
+      "strTime": "02:30:00",
+      "strTimeLocal": "18:30:00",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/tpwxpy1473536521.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "strVenue": "BC Place",
+      "strCountry": "Canada",
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/7r0ggq1706713138.jpg",
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/oolq431659976740.jpg",
+      "strVideo": "https://www.youtube.com/watch?v=RTawJpGyvPg",
+      "strPostponed": "no",
+      "strFilename": "American Major League Soccer 2026-03-01 Vancouver Whitecaps vs Toronto FC",
+      "strStatus": "Match Finished"
+    },
+    {
+      "idEvent": "2406713",
+      "strEvent": "FC Dallas vs Toronto FC",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strSport": "Soccer",
+      "strHomeTeam": "FC Dallas",
+      "strAwayTeam": "Toronto FC",
+      "idHomeTeam": "134146",
+      "idAwayTeam": "134148",
+      "intRound": "1",
+      "intHomeScore": "3",
+      "intAwayScore": "2",
+      "strTimestamp": "2026-02-22T01:30:00",
+      "dateEvent": "2026-02-22",
+      "dateEventLocal": "2026-02-21",
+      "strTime": "01:30:00",
+      "strTimeLocal": "19:30:00",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/vxy8xy1602103187.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "strVenue": "Toyota Stadium Dallas",
+      "strCountry": "United States",
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/owuytt1644524082.jpg",
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/9bjukc1659976671.jpg",
+      "strVideo": "https://www.youtube.com/watch?v=Sf5YmqW5ONo",
+      "strPostponed": "no",
+      "strFilename": "American Major League Soccer 2026-02-22 FC Dallas vs Toronto FC",
+      "strStatus": "Match Finished"
+    },
+    {
+      "idEvent": "2425216",
+      "strEvent": "Toronto FC vs Polissya Zhytomyr",
+      "idLeague": "4569",
+      "strLeague": "Club Friendlies",
+      "strSport": "Soccer",
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "Polissya Zhytomyr",
+      "idHomeTeam": "134148",
+      "idAwayTeam": "140180",
+      "intRound": "0",
+      "intHomeScore": "2",
+      "intAwayScore": "1",
+      "strTimestamp": "2026-02-14T09:45:00",
+      "dateEvent": "2026-02-14",
+      "dateEventLocal": "2026-02-14",
+      "strTime": "09:45:00",
+      "strTimeLocal": "04:45:00",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/6r8o5l1725171180.png",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strThumb": "",
+      "strPoster": "",
+      "strVideo": "",
+      "strPostponed": "no",
+      "strFilename": "Club Friendlies 2026-02-14 Toronto FC vs Polissya Zhytomyr",
+      "strStatus": "Match Finished"
+    },
+    {
+      "idEvent": "2425209",
+      "strEvent": "Toronto FC vs Fredrikstad",
+      "idLeague": "4569",
+      "strLeague": "Club Friendlies",
+      "strSport": "Soccer",
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "Fredrikstad",
+      "idHomeTeam": "134148",
+      "idAwayTeam": "134749",
+      "intRound": "0",
+      "intHomeScore": "0",
+      "intAwayScore": "1",
+      "strTimestamp": "2026-02-11T11:00:00",
+      "dateEvent": "2026-02-11",
+      "dateEventLocal": "2026-02-11",
+      "strTime": "11:00:00",
+      "strTimeLocal": "06:00:00",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/9se6qv1690695269.png",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strThumb": "",
+      "strPoster": "",
+      "strVideo": "",
+      "strPostponed": "no",
+      "strFilename": "Club Friendlies 2026-02-11 Toronto FC vs Fredrikstad",
+      "strStatus": "Match Finished"
+    },
+    {
+      "idEvent": "2425206",
+      "strEvent": "Toronto FC vs AIK",
+      "idLeague": "4569",
+      "strLeague": "Club Friendlies",
+      "strSport": "Soccer",
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "AIK",
+      "idHomeTeam": "134148",
+      "idAwayTeam": "134011",
+      "intRound": "0",
+      "intHomeScore": "2",
+      "intAwayScore": "2",
+      "strTimestamp": "2026-02-08T15:00:00",
+      "dateEvent": "2026-02-08",
+      "dateEventLocal": "2026-02-07",
+      "strTime": "15:00:00",
+      "strTimeLocal": "09:00:00",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rwsrxq1420769503.png",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strThumb": "",
+      "strPoster": "",
+      "strVideo": "",
+      "strPostponed": "no",
+      "strFilename": "Club Friendlies 2026-02-08 Toronto FC vs AIK",
+      "strStatus": "Match Finished"
+    },
+    {
+      "idEvent": "2425183",
+      "strEvent": "Toronto FC vs Jeonbuk Hyundai Motors",
+      "idLeague": "4569",
+      "strLeague": "Club Friendlies",
+      "strSport": "Soccer",
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "Jeonbuk Hyundai Motors",
+      "idHomeTeam": "134148",
+      "idAwayTeam": "138111",
+      "intRound": "0",
+      "intHomeScore": "2",
+      "intAwayScore": "0",
+      "strTimestamp": "2026-01-31T13:00:00",
+      "dateEvent": "2026-01-31",
+      "dateEventLocal": "2026-01-31",
+      "strTime": "13:00:00",
+      "strTimeLocal": "08:00:00",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/8jif3b1747853225.png",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strThumb": "",
+      "strPoster": "",
+      "strVideo": "",
+      "strPostponed": "no",
+      "strFilename": "Club Friendlies 2026-01-31 Toronto FC vs Jeonbuk Hyundai Motors",
+      "strStatus": "Match Finished"
+    },
+    {
+      "idEvent": "2425155",
+      "strEvent": "Toronto FC vs Incheon United",
+      "idLeague": "4569",
+      "strLeague": "Club Friendlies",
+      "strSport": "Soccer",
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "Incheon United",
+      "idHomeTeam": "134148",
+      "idAwayTeam": "138110",
+      "intRound": "0",
+      "intHomeScore": "4",
+      "intAwayScore": "1",
+      "strTimestamp": "2026-01-28T15:00:00",
+      "dateEvent": "2026-01-28",
+      "dateEventLocal": null,
+      "strTime": "15:00:00",
+      "strTimeLocal": null,
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/2no9nq1579473100.png",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strThumb": "",
+      "strPoster": "",
+      "strVideo": null,
+      "strPostponed": "no",
+      "strFilename": "Club Friendlies 2026-01-28 Toronto FC vs Incheon United",
+      "strStatus": "Match Finished"
+    },
+    {
+      "idEvent": "2192510",
+      "strEvent": "Toronto FC vs Orlando City",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strSport": "Soccer",
+      "strHomeTeam": "Toronto FC",
+      "strAwayTeam": "Orlando City",
+      "idHomeTeam": "134148",
+      "idAwayTeam": "135292",
+      "intRound": "51",
+      "intHomeScore": "4",
+      "intAwayScore": "2",
+      "strTimestamp": "2025-10-18T22:00:00",
+      "dateEvent": "2025-10-18",
+      "dateEventLocal": "2025-10-18",
+      "strTime": "22:00:00",
+      "strTimeLocal": "18:00:00",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/qyppxw1423832326.png",
+      "strVenue": "BMO Field",
+      "strCountry": "Canada",
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/vruhs31736768055.jpg",
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/7zrec61674489293.jpg",
+      "strVideo": "https://www.youtube.com/watch?v=n9HxS3fULdk",
+      "strPostponed": "no",
+      "strFilename": "American Major League Soccer 2025-10-18 Toronto FC vs Orlando City",
+      "strStatus": "Match Finished"
+    },
+    {
+      "idEvent": "2192264",
+      "strEvent": "Los Angeles FC vs Toronto FC",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strSport": "Soccer",
+      "strHomeTeam": "Los Angeles FC",
+      "strAwayTeam": "Toronto FC",
+      "idHomeTeam": "136050",
+      "idAwayTeam": "134148",
+      "intRound": "26",
+      "intHomeScore": "2",
+      "intAwayScore": "0",
+      "strTimestamp": "2025-10-09T02:30:00",
+      "dateEvent": "2025-10-09",
+      "dateEventLocal": "2025-10-08",
+      "strTime": "02:30:00",
+      "strTimeLocal": "19:30:00",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/7nbj2a1602103638.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "strVenue": "BMO Stadium",
+      "strCountry": "United States",
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/8tksek1736767451.jpg",
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/8ynzkg1736773640.jpg",
+      "strVideo": "https://www.youtube.com/watch?v=qXM4fqLLJ_I",
+      "strPostponed": "no",
+      "strFilename": "American Major League Soccer 2025-10-09 Los Angeles FC vs Toronto FC",
+      "strStatus": "Match Finished"
+    }
+  ]
+}
--- a/docs/api_samples/sportsdb/04_v1_event_detail.json
+++ b/docs/api_samples/sportsdb/04_v1_event_detail.json
@@ -0,0 +1,52 @@
+{
+  "events": [
+    {
+      "idEvent": "2406751",
+      "idAPIfootball": "1490149",
+      "strTimestamp": "2026-03-08T23:00:00",
+      "strEvent": "FC Cincinnati vs Toronto FC",
+      "strEventAlternate": "Toronto FC @ FC Cincinnati",
+      "strFilename": "American Major League Soccer 2026-03-08 FC Cincinnati vs Toronto FC",
+      "strSport": "Soccer",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strLeagueBadge": "https://r2.thesportsdb.com/images/media/league/badge/dqo6r91549878326.png",
+      "strSeason": "2026",
+      "strDescriptionEN": "",
+      "strHomeTeam": "FC Cincinnati",
+      "strAwayTeam": "Toronto FC",
+      "intHomeScore": "0",
+      "intRound": "3",
+      "intAwayScore": "1",
+      "intSpectators": null,
+      "strOfficial": "",
+      "dateEvent": "2026-03-08",
+      "dateEventLocal": "2026-03-08",
+      "strTime": "23:00:00",
+      "strTimeLocal": "18:00:00",
+      "strGroup": "",
+      "idHomeTeam": "136688",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/vvhsqc1707631046.png",
+      "idAwayTeam": "134148",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "intScore": null,
+      "intScoreVotes": null,
+      "strResult": "",
+      "idVenue": "20820",
+      "strVenue": "TQL Stadium",
+      "strCountry": "United States",
+      "strCity": "",
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/tnm6721674489170.jpg",
+      "strSquare": "https://r2.thesportsdb.com/images/media/event/square/frynnc1706713440.jpg",
+      "strFanart": null,
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/7xrdgm1706713089.jpg",
+      "strBanner": "https://r2.thesportsdb.com/images/media/event/banner/zkk3rl1706718516.jpg",
+      "strMap": null,
+      "strTweet1": "",
+      "strVideo": "https://www.youtube.com/watch?v=LloAaRmqvag",
+      "strStatus": "Match Finished",
+      "strPostponed": "no",
+      "strLocked": "unlocked"
+    }
+  ]
+}
--- a/docs/api_samples/sportsdb/04_v2_event_detail.json
+++ b/docs/api_samples/sportsdb/04_v2_event_detail.json
@@ -0,0 +1,52 @@
+{
+  "lookup": [
+    {
+      "idEvent": "2406751",
+      "idAPIfootball": "1490149",
+      "strTimestamp": "2026-03-08T23:00:00",
+      "strEvent": "FC Cincinnati vs Toronto FC",
+      "strEventAlternate": "Toronto FC @ FC Cincinnati",
+      "strFilename": "American Major League Soccer 2026-03-08 FC Cincinnati vs Toronto FC",
+      "strSport": "Soccer",
+      "idLeague": "4346",
+      "strLeague": "American Major League Soccer",
+      "strLeagueBadge": "https://r2.thesportsdb.com/images/media/league/badge/dqo6r91549878326.png",
+      "strSeason": "2026",
+      "strDescriptionEN": "",
+      "strHomeTeam": "FC Cincinnati",
+      "strAwayTeam": "Toronto FC",
+      "intHomeScore": "0",
+      "intRound": "3",
+      "intAwayScore": "1",
+      "intSpectators": null,
+      "strOfficial": "",
+      "dateEvent": "2026-03-08",
+      "dateEventLocal": "2026-03-08",
+      "strTime": "23:00:00",
+      "strTimeLocal": "18:00:00",
+      "strGroup": "",
+      "idHomeTeam": "136688",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/vvhsqc1707631046.png",
+      "idAwayTeam": "134148",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rsxyrr1473536512.png",
+      "intScore": null,
+      "intScoreVotes": null,
+      "strResult": "",
+      "idVenue": "20820",
+      "strVenue": "TQL Stadium",
+      "strCountry": "United States",
+      "strCity": "",
+      "strPoster": "https://r2.thesportsdb.com/images/media/event/poster/tnm6721674489170.jpg",
+      "strSquare": "https://r2.thesportsdb.com/images/media/event/square/frynnc1706713440.jpg",
+      "strFanart": null,
+      "strThumb": "https://r2.thesportsdb.com/images/media/event/thumb/7xrdgm1706713089.jpg",
+      "strBanner": "https://r2.thesportsdb.com/images/media/event/banner/zkk3rl1706718516.jpg",
+      "strMap": null,
+      "strTweet1": "",
+      "strVideo": "https://www.youtube.com/watch?v=LloAaRmqvag",
+      "strStatus": "Match Finished",
+      "strPostponed": "no",
+      "strLocked": "unlocked"
+    }
+  ]
+}
--- a/docs/api_samples/sportsdb/04_v2_event_lineup.json
+++ b/docs/api_samples/sportsdb/04_v2_event_lineup.json
@@ -0,0 +1,3 @@
+{
+  "Message": "No data found"
+}
--- a/docs/api_samples/sportsdb/04_v2_event_stats.json
+++ b/docs/api_samples/sportsdb/04_v2_event_stats.json
@@ -0,0 +1,3 @@
+{
+  "Message": "No data found"
+}
--- a/docs/api_samples/sportsdb/04_v2_event_timeline.json
+++ b/docs/api_samples/sportsdb/04_v2_event_timeline.json
@@ -0,0 +1,3 @@
+{
+  "Message": "No data found"
+}
--- a/docs/api_samples/sportsdb/05_v1_search_player.json
+++ b/docs/api_samples/sportsdb/05_v1_search_player.json
@@ -0,0 +1,19 @@
+{
+  "player": [
+    {
+      "idPlayer": "34148472",
+      "idTeam": "134781",
+      "strPlayer": "Federico Bernardeschi",
+      "strTeam": "Bologna",
+      "strSport": "Soccer",
+      "strThumb": "https://r2.thesportsdb.com/images/media/player/thumb/ptaxx21515958866.jpg",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/fwmcl01758896784.png",
+      "strNationality": "Italy",
+      "dateBorn": "1994-02-16",
+      "strStatus": "Active",
+      "strGender": "Male",
+      "strPosition": "Winger",
+      "relevance": "28.932828903198242"
+    }
+  ]
+}
--- a/docs/api_samples/sportsdb/05_v2_player_detail.json
+++ b/docs/api_samples/sportsdb/05_v2_player_detail.json
@@ -0,0 +1,75 @@
+{
+  "lookup": [
+    {
+      "idPlayer": "34146036",
+      "idTeam": "134148",
+      "idTeam2": "0",
+      "idTeamNational": null,
+      "idAPIfootball": "18915",
+      "idPlayerManager": null,
+      "idWikidata": "Q6396794",
+      "idTransferMkt": "111114",
+      "idESPN": "140531",
+      "strNationality": "Ireland",
+      "strPlayer": "Kevin Long",
+      "strPlayerAlternate": "",
+      "strTeam": "Toronto FC",
+      "strTeam2": "",
+      "strSport": "Soccer",
+      "intSoccerXMLTeamID": "28",
+      "dateBorn": "1990-08-18",
+      "dateDied": null,
+      "strNumber": "5",
+      "dateSigned": "2010-07-01",
+      "strSigning": "",
+      "strWage": "",
+      "strOutfitter": "",
+      "strKit": "",
+      "strAgent": "",
+      "strBirthLocation": "Cork, Ireland",
+      "strDeathLocation": null,
+      "strEthnicity": "",
+      "strStatus": "Active",
+      "strDescriptionEN": "Kevin Finbarr Long (born 18 August 1990) is an Irish professional footballer who plays for Major League Soccer club Toronto FC and the Republic of Ireland national team.\r\nHe plays mainly as a centre back but can also fill in at full back.\r\n\r\nLong came through the Cork City youth structure, before signing on professional terms in January 2008. He captained Cork City Youths successful FAI Youth Cup and Munster Cup teams in 2009. Shortly after, the centre half made his senior City debut away to St Patricks Athletic coming on as a second half substitute. Long then made his first senior start on 19 July 2009 in a home friendly against Ipswich Town, partnering Dan Murray in defence.\r\n\r\nIt was reported that Long travelled over to Preston North End for a trial, but whilst there, there was interest from League 1 sides Leeds United and Charlton Athletic and Premier League side Burnley.\r\n\r\nHe scored his first goal for Burnley in a 4-3 FA Cup defeat at Southampton on 4 January 2014. On 1 January 2015, Long made his Premier League debut with Burnley in a 3\u20133 draw away to Newcastle United. He replaced the injured Jason Shackell in the 17th minute, but 20 minutes later was replaced by Steven Reid after suffering an injury of his own, becoming the third Burnley player to be taken off injured in the match at St James' Park.\r\n\r\nIn November 2015, after regaining full fitness following his cruciate knee injury, he joined League One side Barnsley on a one-month loan deal. He scored a late winner against Oldham Athletic on his debut to help his side to a 2-1 win. However in his second game he was sent off against Peterborough United.",
+      "strDescriptionDE": null,
+      "strDescriptionFR": null,
+      "strDescriptionCN": null,
+      "strDescriptionIT": null,
+      "strDescriptionJP": null,
+      "strDescriptionRU": null,
+      "strDescriptionES": null,
+      "strDescriptionPT": null,
+      "strDescriptionSE": null,
+      "strDescriptionNL": null,
+      "strDescriptionHU": null,
+      "strDescriptionNO": null,
+      "strDescriptionIL": null,
+      "strDescriptionPL": null,
+      "strGender": "Male",
+      "strSide": "",
+      "strPosition": "Centre-Back",
+      "strCollege": null,
+      "strFacebook": "t.co/fen2q0xYtf",
+      "strWebsite": "",
+      "strTwitter": "twitter.com/kevinlong28",
+      "strInstagram": "www.instagram.com/kevinlong28",
+      "strYoutube": "",
+      "strHeight": "188 cm",
+      "strWeight": "183 lbs",
+      "intLoved": "0",
+      "strThumb": "https://r2.thesportsdb.com/images/media/player/thumb/tq6f5h1557314699.jpg",
+      "strPoster": null,
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/qi34vk1766575443.png",
+      "strCartoon": null,
+      "strRender": "https://r2.thesportsdb.com/images/media/player/render/3idgla1575974022.png",
+      "strBanner": null,
+      "strFanart1": null,
+      "strFanart2": null,
+      "strFanart3": null,
+      "strFanart4": null,
+      "strCreativeCommons": "No",
+      "strLocked": "unlocked",
+      "strLastName": "Long"
+    }
+  ]
+}
--- a/docs/api_samples/sportsdb/05_v2_squad_tfc.json
+++ b/docs/api_samples/sportsdb/05_v2_squad_tfc.json
@@ -0,0 +1,235 @@
+{
+  "list": [
+    {
+      "idPlayer": "34146036",
+      "strPlayer": "Kevin Long",
+      "idTeam": "134148",
+      "strTeam": "Toronto FC",
+      "strThumb": "https://r2.thesportsdb.com/images/media/player/thumb/tq6f5h1557314699.jpg",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/qi34vk1766575443.png",
+      "strRender": "https://r2.thesportsdb.com/images/media/player/render/3idgla1575974022.png",
+      "dateBorn": "1990-08-18",
+      "strPosition": "Centre-Back"
+    },
+    {
+      "idPlayer": "34164645",
+      "strPlayer": "Djordje Mihailovi\u0107",
+      "idTeam": "134148",
+      "strTeam": "Toronto FC",
+      "strThumb": "https://r2.thesportsdb.com/images/media/player/thumb/iexxfp1662720581.jpg",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/kvtl3r1766575412.png",
+      "strRender": "https://r2.thesportsdb.com/images/media/player/render/o48nh11620763928.png",
+      "dateBorn": "1998-11-10",
+      "strPosition": "Attacking Midfield"
+    },
+    {
+      "idPlayer": "34165110",
+      "strPlayer": "Walker Zimmerman",
+      "idTeam": "134148",
+      "strTeam": "Toronto FC",
+      "strThumb": "https://r2.thesportsdb.com/images/media/player/thumb/ql13io1662731506.jpg",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/190oag1766741902.png",
+      "strRender": "https://r2.thesportsdb.com/images/media/player/render/6oe28j1622016455.png",
+      "dateBorn": "1993-05-19",
+      "strPosition": "Centre-Back"
+    },
+    {
+      "idPlayer": "34165262",
+      "strPlayer": "Derrick Etienne",
+      "idTeam": "134148",
+      "strTeam": "Toronto FC",
+      "strThumb": "https://r2.thesportsdb.com/images/media/player/thumb/yv4k1k1548617647.jpg",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/9kwou81766575620.png",
+      "strRender": "https://r2.thesportsdb.com/images/media/player/render/81yr7p1608042138.png",
+      "dateBorn": "1996-11-25",
+      "strPosition": "Left Wing"
+    },
+    {
+      "idPlayer": "34173658",
+      "strPlayer": "Sigurd Rosted",
+      "idTeam": "134148",
+      "strTeam": "Toronto FC",
+      "strThumb": "https://r2.thesportsdb.com/images/media/player/thumb/4eexde1610625953.jpg",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/22mdli1766575883.png",
+      "strRender": "https://r2.thesportsdb.com/images/media/player/render/e1si7s1682678318.png",
+      "dateBorn": "1994-07-22",
+      "strPosition": "Defender"
+    },
+    {
+      "idPlayer": "34176006",
+      "strPlayer": "Henry Wingo",
+      "idTeam": "134148",
+      "strTeam": "Toronto FC",
+      "strThumb": "https://r2.thesportsdb.com/images/media/player/thumb/w5u8is1610712583.jpg",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/83q9ln1766575157.png",
+      "strRender": "https://r2.thesportsdb.com/images/media/player/render/hgv2lj1652986766.png",
+      "dateBorn": "1995-10-04",
+      "strPosition": "Right-Back"
+    },
+    {
+      "idPlayer": "34180209",
+      "strPlayer": "Richie Laryea",
+      "idTeam": "134148",
+      "strTeam": "Toronto FC",
+      "strThumb": "https://r2.thesportsdb.com/images/media/player/thumb/owdl2g1621328018.jpg",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/milfrs1766575517.png",
+      "strRender": "https://r2.thesportsdb.com/images/media/player/render/hxtaz01621328022.png",
+      "dateBorn": "1995-01-07",
+      "strPosition": "Midfielder"
+    },
+    {
+      "idPlayer": "34180872",
+      "strPlayer": "Jos\u00e9 Cifuentes",
+      "idTeam": "134148",
+      "strTeam": "Toronto FC",
+      "strThumb": "https://r2.thesportsdb.com/images/media/player/thumb/2fqfxp1623150919.jpg",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/2eyl0h1766575746.png",
+      "strRender": "https://r2.thesportsdb.com/images/media/player/render/gdgxvl1623150892.png",
+      "dateBorn": "1999-03-12",
+      "strPosition": "Central Midfield"
+    },
+    {
+      "idPlayer": "34180980",
+      "strPlayer": "Jonathan Osorio",
+      "idTeam": "134148",
+      "strTeam": "Toronto FC",
+      "strThumb": "https://r2.thesportsdb.com/images/media/player/thumb/exyn7k1621866558.jpg",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/j30x9f1766575844.png",
+      "strRender": "https://r2.thesportsdb.com/images/media/player/render/o57ift1621866654.png",
+      "dateBorn": "1992-06-12",
+      "strPosition": "Midfielder"
+    },
+    {
+      "idPlayer": "34195803",
+      "strPlayer": "Robin Fraser",
+      "idTeam": "134148",
+      "strTeam": "Toronto FC",
+      "strThumb": "https://r2.thesportsdb.com/images/media/player/thumb/2b2a0u1641470637.jpg",
+      "strCutout": null,
+      "strRender": null,
+      "dateBorn": "1966-12-17",
+      "strPosition": "Manager"
+    },
+    {
+      "idPlayer": "34197810",
+      "strPlayer": "Deandre Kerr",
+      "idTeam": "134148",
+      "strTeam": "Toronto FC",
+      "strThumb": "https://r2.thesportsdb.com/images/media/player/thumb/6294rp1652706567.jpg",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/udw9ui1766575474.png",
+      "strRender": "https://r2.thesportsdb.com/images/media/player/render/7h068n1652706582.png",
+      "dateBorn": "2002-11-29",
+      "strPosition": "Forward"
+    },
+    {
+      "idPlayer": "34199281",
+      "strPlayer": "Kosi Thompson",
+      "idTeam": "134148",
+      "strTeam": "Toronto FC",
+      "strThumb": "https://r2.thesportsdb.com/images/media/player/thumb/s9z1mq1654852335.jpg",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/o4e1kx1766575863.png",
+      "strRender": "https://r2.thesportsdb.com/images/media/player/render/5mzpxf1654852394.png",
+      "dateBorn": "2003-01-27",
+      "strPosition": "Midfielder"
+    },
+    {
+      "idPlayer": "34200759",
+      "strPlayer": "Theo Corbeanu",
+      "idTeam": "134148",
+      "strTeam": "Toronto FC",
+      "strThumb": "https://r2.thesportsdb.com/images/media/player/thumb/y0mbrj1696779390.jpg",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/grbcb41766575664.png",
+      "strRender": "https://r2.thesportsdb.com/images/media/player/render/95xhoq1742905064.png",
+      "dateBorn": "2002-05-17",
+      "strPosition": "Right Winger"
+    },
+    {
+      "idPlayer": "34217581",
+      "strPlayer": "Alonso Coello",
+      "idTeam": "134148",
+      "strTeam": "Toronto FC",
+      "strThumb": "https://r2.thesportsdb.com/images/media/player/thumb/gw9gw21682679020.jpg",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/tkn51q1766575773.png",
+      "strRender": "https://r2.thesportsdb.com/images/media/player/render/35xp641682679116.png",
+      "dateBorn": "1999-10-12",
+      "strPosition": "Midfielder"
+    },
+    {
+      "idPlayer": "34217935",
+      "strPlayer": "Kobe Franklin",
+      "idTeam": "134148",
+      "strTeam": "Toronto FC",
+      "strThumb": "https://r2.thesportsdb.com/images/media/player/thumb/s7e3n91683191394.jpg",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/uku81g1766575824.png",
+      "strRender": "https://r2.thesportsdb.com/images/media/player/render/xsupuc1683191398.png",
+      "dateBorn": "2003-05-10",
+      "strPosition": "Defender"
+    },
+    {
+      "idPlayer": "34220731",
+      "strPlayer": "Jules-Anthony Vilsaint",
+      "idTeam": "134148",
+      "strTeam": "Toronto FC",
+      "strThumb": "https://r2.thesportsdb.com/images/media/player/thumb/4xflwp1695202996.jpg",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/dsxu6f1766575229.png",
+      "strRender": "https://r2.thesportsdb.com/images/media/player/render/f2j8su1695203031.png",
+      "dateBorn": "2003-01-06",
+      "strPosition": "Forward"
+    },
+    {
+      "idPlayer": "34221018",
+      "strPlayer": "Luka Gavran",
+      "idTeam": "134148",
+      "strTeam": "Toronto FC",
+      "strThumb": "https://r2.thesportsdb.com/images/media/player/thumb/8h84ds1695640668.jpg",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/a3ghm91766575645.png",
+      "strRender": "https://r2.thesportsdb.com/images/media/player/render/xx795j1695640681.png",
+      "dateBorn": "2000-05-09",
+      "strPosition": "Goalkeeper"
+    },
+    {
+      "idPlayer": "34229521",
+      "strPlayer": "Nickseon Gomis",
+      "idTeam": "134148",
+      "strTeam": "Toronto FC",
+      "strThumb": "https://r2.thesportsdb.com/images/media/player/thumb/bhf5vs1709718526.jpg",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/7c4l8h1766575544.png",
+      "strRender": "https://r2.thesportsdb.com/images/media/player/render/f5jvw71709718592.png",
+      "dateBorn": "2002-03-15",
+      "strPosition": "Defender"
+    },
+    {
+      "idPlayer": "34334976",
+      "strPlayer": "Zane Monlouis",
+      "idTeam": "134148",
+      "strTeam": "Toronto FC",
+      "strThumb": "https://r2.thesportsdb.com/images/media/player/thumb/8fy1wf1742908301.jpg",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/lcbhkz1766575296.png",
+      "strRender": "https://r2.thesportsdb.com/images/media/player/render/878kzg1742908697.png",
+      "dateBorn": "2003-10-16",
+      "strPosition": "Defender"
+    },
+    {
+      "idPlayer": "34334977",
+      "strPlayer": "Markus Cimermancic",
+      "idTeam": "134148",
+      "strTeam": "Toronto FC",
+      "strThumb": "https://r2.thesportsdb.com/images/media/player/thumb/y4196f1742908482.jpg",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/eynx1q1766575721.png",
+      "strRender": "https://r2.thesportsdb.com/images/media/player/render/tkfqvs1742908599.png",
+      "dateBorn": "2004-10-01",
+      "strPosition": "Central Midfield"
+    },
+    {
+      "idPlayer": "34347948",
+      "strPlayer": "Malik Henry",
+      "idTeam": "134148",
+      "strTeam": "Toronto FC",
+      "strThumb": null,
+      "strCutout": null,
+      "strRender": null,
+      "dateBorn": "2002-07-23",
+      "strPosition": "Central Midfield"
+    }
+  ]
+}
--- a/docs/api_samples/sportsdb/06_v1_standings_epl.json
+++ b/docs/api_samples/sportsdb/06_v1_standings_epl.json
@@ -0,0 +1,424 @@
+{
+  "table": [
+    {
+      "idStanding": "8825962",
+      "intRank": "1",
+      "idTeam": "133604",
+      "strTeam": "Arsenal",
+      "strBadge": "https://r2.thesportsdb.com/images/media/team/badge/uyhbfe1612467038.png/tiny",
+      "idLeague": "4328",
+      "strLeague": "English Premier League",
+      "strSeason": "2025-2026",
+      "strForm": "WWWDD",
+      "strDescription": "Promotion - Champions League (League phase)",
+      "intPlayed": "30",
+      "intWin": "20",
+      "intLoss": "3",
+      "intDraw": "7",
+      "intGoalsFor": "59",
+      "intGoalsAgainst": "22",
+      "intGoalDifference": "37",
+      "intPoints": "67",
+      "dateUpdated": "2026-03-10 07:00:37"
+    },
+    {
+      "idStanding": "8825963",
+      "intRank": "2",
+      "idTeam": "133613",
+      "strTeam": "Manchester City",
+      "strBadge": "https://r2.thesportsdb.com/images/media/team/badge/vwpvry1467462651.png/tiny",
+      "idLeague": "4328",
+      "strLeague": "English Premier League",
+      "strSeason": "2025-2026",
+      "strForm": "DWWWW",
+      "strDescription": "Promotion - Champions League (League phase)",
+      "intPlayed": "29",
+      "intWin": "18",
+      "intLoss": "5",
+      "intDraw": "6",
+      "intGoalsFor": "59",
+      "intGoalsAgainst": "27",
+      "intGoalDifference": "32",
+      "intPoints": "60",
+      "dateUpdated": "2026-03-10 07:00:37"
+    },
+    {
+      "idStanding": "8825964",
+      "intRank": "3",
+      "idTeam": "133612",
+      "strTeam": "Manchester United",
+      "strBadge": "https://r2.thesportsdb.com/images/media/team/badge/xzqdr11517660252.png/tiny",
+      "idLeague": "4328",
+      "strLeague": "English Premier League",
+      "strSeason": "2025-2026",
+      "strForm": "LWWDW",
+      "strDescription": "Promotion - Champions League (League phase)",
+      "intPlayed": "29",
+      "intWin": "14",
+      "intLoss": "6",
+      "intDraw": "9",
+      "intGoalsFor": "51",
+      "intGoalsAgainst": "40",
+      "intGoalDifference": "11",
+      "intPoints": "51",
+      "dateUpdated": "2026-03-10 07:00:37"
+    },
+    {
+      "idStanding": "8825965",
+      "intRank": "4",
+      "idTeam": "133601",
+      "strTeam": "Aston Villa",
+      "strBadge": "https://r2.thesportsdb.com/images/media/team/badge/jykrpv1717309891.png/tiny",
+      "idLeague": "4328",
+      "strLeague": "English Premier League",
+      "strSeason": "2025-2026",
+      "strForm": "LLDWD",
+      "strDescription": "Promotion - Champions League (League phase)",
+      "intPlayed": "29",
+      "intWin": "15",
+      "intLoss": "8",
+      "intDraw": "6",
+      "intGoalsFor": "39",
+      "intGoalsAgainst": "34",
+      "intGoalDifference": "5",
+      "intPoints": "51",
+      "dateUpdated": "2026-03-10 07:00:37"
+    },
+    {
+      "idStanding": "8825966",
+      "intRank": "5",
+      "idTeam": "133610",
+      "strTeam": "Chelsea",
+      "strBadge": "https://r2.thesportsdb.com/images/media/team/badge/yvwvtu1448813215.png/tiny",
+      "idLeague": "4328",
+      "strLeague": "English Premier League",
+      "strSeason": "2025-2026",
+      "strForm": "WLDDW",
+      "strDescription": "Promotion - Europa League (League phase)",
+      "intPlayed": "29",
+      "intWin": "13",
+      "intLoss": "7",
+      "intDraw": "9",
+      "intGoalsFor": "53",
+      "intGoalsAgainst": "34",
+      "intGoalDifference": "19",
+      "intPoints": "48",
+      "dateUpdated": "2026-03-10 07:00:37"
+    },
+    {
+      "idStanding": "8825967",
+      "intRank": "6",
+      "idTeam": "133602",
+      "strTeam": "Liverpool",
+      "strBadge": "https://r2.thesportsdb.com/images/media/team/badge/kfaher1737969724.png/tiny",
+      "idLeague": "4328",
+      "strLeague": "English Premier League",
+      "strSeason": "2025-2026",
+      "strForm": "LWWWL",
+      "strDescription": "",
+      "intPlayed": "29",
+      "intWin": "14",
+      "intLoss": "9",
+      "intDraw": "6",
+      "intGoalsFor": "48",
+      "intGoalsAgainst": "39",
+      "intGoalDifference": "9",
+      "intPoints": "48",
+      "dateUpdated": "2026-03-10 07:00:37"
+    },
+    {
+      "idStanding": "8825968",
+      "intRank": "7",
+      "idTeam": "134355",
+      "strTeam": "Brentford",
+      "strBadge": "https://r2.thesportsdb.com/images/media/team/badge/grv1aw1546453779.png/tiny",
+      "idLeague": "4328",
+      "strLeague": "English Premier League",
+      "strSeason": "2025-2026",
+      "strForm": "DWLDW",
+      "strDescription": "",
+      "intPlayed": "29",
+      "intWin": "13",
+      "intLoss": "11",
+      "intDraw": "5",
+      "intGoalsFor": "44",
+      "intGoalsAgainst": "40",
+      "intGoalDifference": "4",
+      "intPoints": "44",
+      "dateUpdated": "2026-03-10 07:00:37"
+    },
+    {
+      "idStanding": "8825969",
+      "intRank": "8",
+      "idTeam": "133615",
+      "strTeam": "Everton",
+      "strBadge": "https://r2.thesportsdb.com/images/media/team/badge/eqayrf1523184794.png/tiny",
+      "idLeague": "4328",
+      "strLeague": "English Premier League",
+      "strSeason": "2025-2026",
+      "strForm": "WWLLW",
+      "strDescription": "",
+      "intPlayed": "29",
+      "intWin": "12",
+      "intLoss": "10",
+      "intDraw": "7",
+      "intGoalsFor": "34",
+      "intGoalsAgainst": "33",
+      "intGoalDifference": "1",
+      "intPoints": "43",
+      "dateUpdated": "2026-03-10 07:00:37"
+    },
+    {
+      "idStanding": "8825970",
+      "intRank": "9",
+      "idTeam": "134301",
+      "strTeam": "Bournemouth",
+      "strBadge": "https://r2.thesportsdb.com/images/media/team/badge/y08nak1534071116.png/tiny",
+      "idLeague": "4328",
+      "strLeague": "English Premier League",
+      "strSeason": "2025-2026",
+      "strForm": "DDDWD",
+      "strDescription": "",
+      "intPlayed": "29",
+      "intWin": "9",
+      "intLoss": "7",
+      "intDraw": "13",
+      "intGoalsFor": "44",
+      "intGoalsAgainst": "46",
+      "intGoalDifference": "-2",
+      "intPoints": "40",
+      "dateUpdated": "2026-03-10 07:00:37"
+    },
+    {
+      "idStanding": "8825971",
+      "intRank": "10",
+      "idTeam": "133600",
+      "strTeam": "Fulham",
+      "strBadge": "https://r2.thesportsdb.com/images/media/team/badge/xwwvyt1448811086.png/tiny",
+      "idLeague": "4328",
+      "strLeague": "English Premier League",
+      "strSeason": "2025-2026",
+      "strForm": "LWWLL",
+      "strDescription": "",
+      "intPlayed": "29",
+      "intWin": "12",
+      "intLoss": "13",
+      "intDraw": "4",
+      "intGoalsFor": "40",
+      "intGoalsAgainst": "43",
+      "intGoalDifference": "-3",
+      "intPoints": "40",
+      "dateUpdated": "2026-03-10 07:00:37"
+    },
+    {
+      "idStanding": "8825972",
+      "intRank": "11",
+      "idTeam": "133603",
+      "strTeam": "Sunderland",
+      "strBadge": "https://r2.thesportsdb.com/images/media/team/badge/tprtus1448813498.png/tiny",
+      "idLeague": "4328",
+      "strLeague": "English Premier League",
+      "strSeason": "2025-2026",
+      "strForm": "WDLLL",
+      "strDescription": "",
+      "intPlayed": "29",
+      "intWin": "10",
+      "intLoss": "9",
+      "intDraw": "10",
+      "intGoalsFor": "30",
+      "intGoalsAgainst": "34",
+      "intGoalDifference": "-4",
+      "intPoints": "40",
+      "dateUpdated": "2026-03-10 07:00:37"
+    },
+    {
+      "idStanding": "8825973",
+      "intRank": "12",
+      "idTeam": "134777",
+      "strTeam": "Newcastle United",
+      "strBadge": "https://r2.thesportsdb.com/images/media/team/badge/lhwuiz1621593302.png/tiny",
+      "idLeague": "4328",
+      "strLeague": "English Premier League",
+      "strSeason": "2025-2026",
+      "strForm": "WLLWL",
+      "strDescription": "",
+      "intPlayed": "29",
+      "intWin": "11",
+      "intLoss": "12",
+      "intDraw": "6",
+      "intGoalsFor": "42",
+      "intGoalsAgainst": "43",
+      "intGoalDifference": "-1",
+      "intPoints": "39",
+      "dateUpdated": "2026-03-10 07:00:37"
+    },
+    {
+      "idStanding": "8825974",
+      "intRank": "13",
+      "idTeam": "133632",
+      "strTeam": "Crystal Palace",
+      "strBadge": "https://r2.thesportsdb.com/images/media/team/badge/ia6i3m1656014992.png/tiny",
+      "idLeague": "4328",
+      "strLeague": "English Premier League",
+      "strSeason": "2025-2026",
+      "strForm": "WLWLW",
+      "strDescription": "",
+      "intPlayed": "29",
+      "intWin": "10",
+      "intLoss": "11",
+      "intDraw": "8",
+      "intGoalsFor": "33",
+      "intGoalsAgainst": "35",
+      "intGoalDifference": "-2",
+      "intPoints": "38",
+      "dateUpdated": "2026-03-10 07:00:37"
+    },
+    {
+      "idStanding": "8825975",
+      "intRank": "14",
+      "idTeam": "133619",
+      "strTeam": "Brighton and Hove Albion",
+      "strBadge": "https://r2.thesportsdb.com/images/media/team/badge/ywypts1448810904.png/tiny",
+      "idLeague": "4328",
+      "strLeague": "English Premier League",
+      "strSeason": "2025-2026",
+      "strForm": "LWWLL",
+      "strDescription": "",
+      "intPlayed": "29",
+      "intWin": "9",
+      "intLoss": "10",
+      "intDraw": "10",
+      "intGoalsFor": "38",
+      "intGoalsAgainst": "36",
+      "intGoalDifference": "2",
+      "intPoints": "37",
+      "dateUpdated": "2026-03-10 07:00:37"
+    },
+    {
+      "idStanding": "8825976",
+      "intRank": "15",
+      "idTeam": "133635",
+      "strTeam": "Leeds United",
+      "strBadge": "https://r2.thesportsdb.com/images/media/team/badge/jcgrml1756649030.png/tiny",
+      "idLeague": "4328",
+      "strLeague": "English Premier League",
+      "strSeason": "2025-2026",
+      "strForm": "LLDDW",
+      "strDescription": "",
+      "intPlayed": "29",
+      "intWin": "7",
+      "intLoss": "12",
+      "intDraw": "10",
+      "intGoalsFor": "37",
+      "intGoalsAgainst": "48",
+      "intGoalDifference": "-11",
+      "intPoints": "31",
+      "dateUpdated": "2026-03-10 07:00:37"
+    },
+    {
+      "idStanding": "8825977",
+      "intRank": "16",
+      "idTeam": "133616",
+      "strTeam": "Tottenham Hotspur",
+      "strBadge": "https://r2.thesportsdb.com/images/media/team/badge/dfyfhl1604094109.png/tiny",
+      "idLeague": "4328",
+      "strLeague": "English Premier League",
+      "strSeason": "2025-2026",
+      "strForm": "LLLLL",
+      "strDescription": "",
+      "intPlayed": "29",
+      "intWin": "7",
+      "intLoss": "14",
+      "intDraw": "8",
+      "intGoalsFor": "39",
+      "intGoalsAgainst": "46",
+      "intGoalDifference": "-7",
+      "intPoints": "29",
+      "dateUpdated": "2026-03-10 07:00:37"
+    },
+    {
+      "idStanding": "8825978",
+      "intRank": "17",
+      "idTeam": "133720",
+      "strTeam": "Nottingham Forest",
+      "strBadge": "https://r2.thesportsdb.com/images/media/team/badge/bk4qjs1546440351.png/tiny",
+      "idLeague": "4328",
+      "strLeague": "English Premier League",
+      "strSeason": "2025-2026",
+      "strForm": "DLLDL",
+      "strDescription": "",
+      "intPlayed": "29",
+      "intWin": "7",
+      "intLoss": "15",
+      "intDraw": "7",
+      "intGoalsFor": "28",
+      "intGoalsAgainst": "43",
+      "intGoalDifference": "-15",
+      "intPoints": "28",
+      "dateUpdated": "2026-03-10 07:00:37"
+    },
+    {
+      "idStanding": "8825979",
+      "intRank": "18",
+      "idTeam": "133636",
+      "strTeam": "West Ham United",
+      "strBadge": "https://r2.thesportsdb.com/images/media/team/badge/yutyxs1467459956.png/tiny",
+      "idLeague": "4328",
+      "strLeague": "English Premier League",
+      "strSeason": "2025-2026",
+      "strForm": "WLDDW",
+      "strDescription": "Relegation - Championship",
+      "intPlayed": "29",
+      "intWin": "7",
+      "intLoss": "15",
+      "intDraw": "7",
+      "intGoalsFor": "35",
+      "intGoalsAgainst": "54",
+      "intGoalDifference": "-19",
+      "intPoints": "28",
+      "dateUpdated": "2026-03-10 07:00:37"
+    },
+    {
+      "idStanding": "8825980",
+      "intRank": "19",
+      "idTeam": "133623",
+      "strTeam": "Burnley",
+      "strBadge": "https://r2.thesportsdb.com/images/media/team/badge/ql7nl31686893820.png/tiny",
+      "idLeague": "4328",
+      "strLeague": "English Premier League",
+      "strSeason": "2025-2026",
+      "strForm": "LLDWL",
+      "strDescription": "Relegation - Championship",
+      "intPlayed": "29",
+      "intWin": "4",
+      "intLoss": "18",
+      "intDraw": "7",
+      "intGoalsFor": "32",
+      "intGoalsAgainst": "58",
+      "intGoalDifference": "-26",
+      "intPoints": "19",
+      "dateUpdated": "2026-03-10 07:00:37"
+    },
+    {
+      "idStanding": "8825981",
+      "intRank": "20",
+      "idTeam": "133599",
+      "strTeam": "Wolverhampton Wanderers",
+      "strBadge": "https://r2.thesportsdb.com/images/media/team/badge/u9qr031621593327.png/tiny",
+      "idLeague": "4328",
+      "strLeague": "English Premier League",
+      "strSeason": "2025-2026",
+      "strForm": "WWLDD",
+      "strDescription": "Relegation - Championship",
+      "intPlayed": "30",
+      "intWin": "3",
+      "intLoss": "20",
+      "intDraw": "7",
+      "intGoalsFor": "22",
+      "intGoalsAgainst": "52",
+      "intGoalDifference": "-30",
+      "intPoints": "16",
+      "dateUpdated": "2026-03-10 07:00:37"
+    }
+  ]
+}
--- a/docs/api_samples/sportsdb/06_v1_standings_mls.json
+++ b/docs/api_samples/sportsdb/06_v1_standings_mls.json
--- a/docs/api_samples/sportsdb/07_v1_events_today.json
+++ b/docs/api_samples/sportsdb/07_v1_events_today.json
--- a/docs/api_samples/sportsdb/07_v1_events_today_mls.json
+++ b/docs/api_samples/sportsdb/07_v1_events_today_mls.json
@@ -0,0 +1,3 @@
+{
+  "events": null
+}
--- a/docs/api_samples/sportsdb/08_v2_livescores.json
+++ b/docs/api_samples/sportsdb/08_v2_livescores.json
@@ -0,0 +1,290 @@
+{
+  "livescore": [
+    {
+      "idLiveScore": "29571878",
+      "idEvent": "2438107",
+      "strSport": "Soccer",
+      "idLeague": "4432",
+      "strLeague": "Uruguayan Primera Division",
+      "idHomeTeam": "136051",
+      "idAwayTeam": "136052",
+      "strHomeTeam": "Boston River",
+      "strAwayTeam": "Liverpool Montevideo",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/8zq9n91736218442.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/0xat6f1678717839.png",
+      "intHomeScore": "0",
+      "intAwayScore": "1",
+      "intEventScore": null,
+      "intEventScoreTotal": null,
+      "strStatus": "FT",
+      "strProgress": "90",
+      "strEventTime": "00:30",
+      "dateEvent": "2026-03-10",
+      "updated": "2026-03-10 02:22:23"
+    },
+    {
+      "idLiveScore": "29573091",
+      "idEvent": "2404558",
+      "strSport": "Soccer",
+      "idLeague": "5075",
+      "strLeague": "Jamaican Premier League",
+      "idHomeTeam": "139116",
+      "idAwayTeam": "144757",
+      "strHomeTeam": "Waterhouse",
+      "strAwayTeam": "Montego Bay United",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/a3feu21582145219.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/xmp5y51726276300.png",
+      "intHomeScore": "1",
+      "intAwayScore": "0",
+      "intEventScore": null,
+      "intEventScoreTotal": null,
+      "strStatus": "FT",
+      "strProgress": "90",
+      "strEventTime": "00:30",
+      "dateEvent": "2026-03-10",
+      "updated": "2026-03-10 02:31:23"
+    },
+    {
+      "idLiveScore": "29573226",
+      "idEvent": "2429251",
+      "strSport": "Soccer",
+      "idLeague": "4686",
+      "strLeague": "Ecuadorian Serie A",
+      "idHomeTeam": "138231",
+      "idAwayTeam": "140792",
+      "strHomeTeam": "Orense",
+      "strAwayTeam": "Manta",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/0pishb1734023740.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/mwnqej1614891525.png",
+      "intHomeScore": "1",
+      "intAwayScore": "1",
+      "intEventScore": null,
+      "intEventScoreTotal": null,
+      "strStatus": "FT",
+      "strProgress": "90",
+      "strEventTime": "00:30",
+      "dateEvent": "2026-03-10",
+      "updated": "2026-03-10 02:32:23"
+    },
+    {
+      "idLiveScore": "29577082",
+      "idEvent": "2390578",
+      "strSport": "Soccer",
+      "idLeague": "4815",
+      "strLeague": "Costa-Rica Liga FPD",
+      "idHomeTeam": "140122",
+      "idAwayTeam": "139707",
+      "strHomeTeam": "Sporting San Jose",
+      "strAwayTeam": "P\u00e9rez Zeled\u00f3n",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/7wzxlo1606770023.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/rbsepr1589122379.png",
+      "intHomeScore": "3",
+      "intAwayScore": "2",
+      "intEventScore": null,
+      "intEventScoreTotal": null,
+      "strStatus": "FT",
+      "strProgress": "90",
+      "strEventTime": "01:00",
+      "dateEvent": "2026-03-10",
+      "updated": "2026-03-10 03:01:24"
+    },
+    {
+      "idLiveScore": "29580120",
+      "idEvent": "2421648",
+      "strSport": "Soccer",
+      "idLeague": "4819",
+      "strLeague": "Panama Liga Panamena de Futbol",
+      "idHomeTeam": "139738",
+      "idAwayTeam": "145086",
+      "strHomeTeam": "Deportivo \u00c1rabe Unido",
+      "strAwayTeam": "Veraguas United",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/lkhkf11589297941.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/zwx9x51649354013.png",
+      "intHomeScore": "2",
+      "intAwayScore": "3",
+      "intEventScore": null,
+      "intEventScoreTotal": null,
+      "strStatus": "FT",
+      "strProgress": "90",
+      "strEventTime": "01:30",
+      "dateEvent": "2026-03-10",
+      "updated": "2026-03-10 03:24:23"
+    },
+    {
+      "idLiveScore": "29580513",
+      "idEvent": "2414954",
+      "strSport": "Soccer",
+      "idLeague": "4497",
+      "strLeague": "Colombia Categor\u00eda Primera A",
+      "idHomeTeam": "137611",
+      "idAwayTeam": "137604",
+      "strHomeTeam": "Deportivo Pasto",
+      "strAwayTeam": "Am\u00e9rica de Cali",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/zlmyh31576159327.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/lwxcn71576156105.png",
+      "intHomeScore": "2",
+      "intAwayScore": "0",
+      "intEventScore": null,
+      "intEventScoreTotal": null,
+      "strStatus": "FT",
+      "strProgress": "90",
+      "strEventTime": "01:30",
+      "dateEvent": "2026-03-10",
+      "updated": "2026-03-10 03:27:23"
+    },
+    {
+      "idLiveScore": "29580904",
+      "idEvent": "2422431",
+      "strSport": "Soccer",
+      "idLeague": "4688",
+      "strLeague": "Peruvian Primera Division",
+      "idHomeTeam": "138311",
+      "idAwayTeam": "138323",
+      "strHomeTeam": "Alianza Lima",
+      "strAwayTeam": "Melgar",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/y5wov41580040189.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/0puqm41765861529.png",
+      "intHomeScore": "3",
+      "intAwayScore": "1",
+      "intEventScore": null,
+      "intEventScoreTotal": null,
+      "strStatus": "FT",
+      "strProgress": "90",
+      "strEventTime": "01:30",
+      "dateEvent": "2026-03-10",
+      "updated": "2026-03-10 03:30:23"
+    },
+    {
+      "idLiveScore": "29584000",
+      "idEvent": "2390575",
+      "strSport": "Soccer",
+      "idLeague": "4815",
+      "strLeague": "Costa-Rica Liga FPD",
+      "idHomeTeam": "147407",
+      "idAwayTeam": "139706",
+      "strHomeTeam": "Municipal Liberia",
+      "strAwayTeam": "Guadalupe",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/l26ju61687165399.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/vkt01e1606771982.png",
+      "intHomeScore": "1",
+      "intAwayScore": "0",
+      "intEventScore": null,
+      "intEventScoreTotal": null,
+      "strStatus": "FT",
+      "strProgress": "90",
+      "strEventTime": "02:00",
+      "dateEvent": "2026-03-10",
+      "updated": "2026-03-10 03:54:23"
+    },
+    {
+      "idLiveScore": "29637910",
+      "idEvent": "2427095",
+      "strSport": "Soccer",
+      "idLeague": "5179",
+      "strLeague": "Asian Cup Women",
+      "idHomeTeam": "136814",
+      "idAwayTeam": "144951",
+      "strHomeTeam": "Japan Women",
+      "strAwayTeam": "Vietnam Women",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/jlrg6s1760929323.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/81kjun1642445873.png",
+      "intHomeScore": "4",
+      "intAwayScore": "0",
+      "intEventScore": null,
+      "intEventScoreTotal": null,
+      "strStatus": "FT",
+      "strProgress": "90",
+      "strEventTime": "09:00",
+      "dateEvent": "2026-03-10",
+      "updated": "2026-03-10 10:52:23"
+    },
+    {
+      "idLiveScore": "29638966",
+      "idEvent": "2409781",
+      "strSport": "Soccer",
+      "idLeague": "5630",
+      "strLeague": "Myanmar National League",
+      "idHomeTeam": "151094",
+      "idAwayTeam": "139512",
+      "strHomeTeam": "Yadanarbon",
+      "strAwayTeam": "Yangon United",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/00bqi61739766200.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/4acusz1739764445.png",
+      "intHomeScore": "2",
+      "intAwayScore": "3",
+      "intEventScore": null,
+      "intEventScoreTotal": null,
+      "strStatus": "FT",
+      "strProgress": "90",
+      "strEventTime": "09:00",
+      "dateEvent": "2026-03-10",
+      "updated": "2026-03-10 11:00:24"
+    },
+    {
+      "idLiveScore": "29638967",
+      "idEvent": "2427096",
+      "strSport": "Soccer",
+      "idLeague": "5179",
+      "strLeague": "Asian Cup Women",
+      "idHomeTeam": "144946",
+      "idAwayTeam": "144948",
+      "strHomeTeam": "India Women",
+      "strAwayTeam": "Chinese Taipei Women",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/outmnn1760929034.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/zhisgs1760929236.png",
+      "intHomeScore": "1",
+      "intAwayScore": "3",
+      "intEventScore": null,
+      "intEventScoreTotal": null,
+      "strStatus": "FT",
+      "strProgress": "90",
+      "strEventTime": "09:00",
+      "dateEvent": "2026-03-10",
+      "updated": "2026-03-10 11:00:24"
+    },
+    {
+      "idLiveScore": "29645207",
+      "idEvent": "2285438",
+      "strSport": "Soccer",
+      "idLeague": "4676",
+      "strLeague": "Turkish 1 Lig",
+      "idHomeTeam": "138969",
+      "idAwayTeam": "138982",
+      "strHomeTeam": "Vanspor FK",
+      "strAwayTeam": "Adana Demirspor",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/imwcrs1679510336.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/hewt221626264325.png",
+      "intHomeScore": "1",
+      "intAwayScore": "0",
+      "intEventScore": null,
+      "intEventScoreTotal": null,
+      "strStatus": "2H",
+      "strProgress": "59",
+      "strEventTime": "10:30",
+      "dateEvent": "2026-03-10",
+      "updated": "2026-03-10 11:48:23"
+    },
+    {
+      "idLiveScore": "29645208",
+      "idEvent": "2435699",
+      "strSport": "Soccer",
+      "idLeague": "4719",
+      "strLeague": "AFC Champions League Elite",
+      "idHomeTeam": "139889",
+      "idAwayTeam": "138108",
+      "strHomeTeam": "Machida Zelvia",
+      "strAwayTeam": "Gangwon FC",
+      "strHomeTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/99zl6k1590070905.png",
+      "strAwayTeamBadge": "https://r2.thesportsdb.com/images/media/team/badge/c4igx71579729617.png",
+      "intHomeScore": "1",
+      "intAwayScore": "0",
+      "intEventScore": null,
+      "intEventScoreTotal": null,
+      "strStatus": "2H",
+      "strProgress": "89",
+      "strEventTime": "10:00",
+      "dateEvent": "2026-03-10",
+      "updated": "2026-03-10 11:48:23"
+    }
+  ]
+}
--- a/docs/api_samples/sportsdb/09_v2_event_lineup_real.json
+++ b/docs/api_samples/sportsdb/09_v2_event_lineup_real.json
@@ -0,0 +1,403 @@
+{
+  "lookup": [
+    {
+      "idLineup": "864558",
+      "idEvent": "2434724",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "strPosition": "Defender",
+      "strPositionShort": "D",
+      "strFormation": null,
+      "strHome": "Yes",
+      "strSubstitute": "No",
+      "intSquadNumber": "23",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/yv1fuq1766222423.png",
+      "idPlayer": "34145366",
+      "strPlayer": "Adedeji Oshilaja",
+      "idTeam": "134381",
+      "strTeam": "Mansfield",
+      "strCountry": "England",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idLineup": "864564",
+      "idEvent": "2434724",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "strPosition": "Midfielder",
+      "strPositionShort": "M",
+      "strFormation": null,
+      "strHome": "Yes",
+      "strSubstitute": "No",
+      "intSquadNumber": "3",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/wigvjk1766222238.png",
+      "idPlayer": "34148796",
+      "strPlayer": "Stephen McLaughlin",
+      "idTeam": "134381",
+      "strTeam": "Mansfield",
+      "strCountry": "Ireland",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idLineup": "864573",
+      "idEvent": "2434724",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "strPosition": "Left Wing",
+      "strPositionShort": "M",
+      "strFormation": null,
+      "strHome": "No",
+      "strSubstitute": "No",
+      "intSquadNumber": "19",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/07fzpg1769331977.png",
+      "idPlayer": "34153358",
+      "strPlayer": "Leandro Trossard",
+      "idTeam": "133604",
+      "strTeam": "Arsenal",
+      "strCountry": "Belgium",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idLineup": "864562",
+      "idEvent": "2434724",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "strPosition": "Midfielder",
+      "strPositionShort": "M",
+      "strFormation": null,
+      "strHome": "Yes",
+      "strSubstitute": "No",
+      "intSquadNumber": "25",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/ethhbe1766223156.png",
+      "idPlayer": "34159025",
+      "strPlayer": "Louis Reed",
+      "idTeam": "134381",
+      "strTeam": "Mansfield Town",
+      "strCountry": "England",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idLineup": "864567",
+      "idEvent": "2434724",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "strPosition": "Goalkeeper",
+      "strPositionShort": "G",
+      "strFormation": null,
+      "strHome": "No",
+      "strSubstitute": "No",
+      "intSquadNumber": "13",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/mad9wz1768229982.png",
+      "idPlayer": "34160650",
+      "strPlayer": "Kepa Arrizabalaga",
+      "idTeam": "133604",
+      "strTeam": "Arsenal",
+      "strCountry": "Spain",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idLineup": "864576",
+      "idEvent": "2434724",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "strPosition": "Centre-Forward",
+      "strPositionShort": "F",
+      "strFormation": null,
+      "strHome": "No",
+      "strSubstitute": "No",
+      "intSquadNumber": "9",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/rwsqi51769330458.png",
+      "idPlayer": "34160962",
+      "strPlayer": "Gabriel Jesus",
+      "idTeam": "133604",
+      "strTeam": "Arsenal",
+      "strCountry": "Brazil",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idLineup": "864560",
+      "idEvent": "2434724",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "strPosition": "Centre-Forward",
+      "strPositionShort": "M",
+      "strFormation": null,
+      "strHome": "Yes",
+      "strSubstitute": "No",
+      "intSquadNumber": "7",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/04lwea1766222596.png",
+      "idPlayer": "34161076",
+      "strPlayer": "Lucas Akins",
+      "idTeam": "134381",
+      "strTeam": "Mansfield Town",
+      "strCountry": "Grenada",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idLineup": "864566",
+      "idEvent": "2434724",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "strPosition": "Centre-Forward",
+      "strPositionShort": "F",
+      "strFormation": null,
+      "strHome": "Yes",
+      "strSubstitute": "No",
+      "intSquadNumber": "29",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/2qalar1766222815.png",
+      "idPlayer": "34161977",
+      "strPlayer": "Tyler Roberts",
+      "idTeam": "134381",
+      "strTeam": "Mansfield Town",
+      "strCountry": "Wales",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idLineup": "864557",
+      "idEvent": "2434724",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "strPosition": "Defender",
+      "strPositionShort": "D",
+      "strFormation": null,
+      "strHome": "Yes",
+      "strSubstitute": "No",
+      "intSquadNumber": "2",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/u6shyg1766222184.png",
+      "idPlayer": "34161986",
+      "strPlayer": "Kyle Knoyle",
+      "idTeam": "134381",
+      "strTeam": "Mansfield Town",
+      "strCountry": "England",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idLineup": "864556",
+      "idEvent": "2434724",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "strPosition": "Goalkeeper",
+      "strPositionShort": "G",
+      "strFormation": null,
+      "strHome": "Yes",
+      "strSubstitute": "No",
+      "intSquadNumber": "1",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/s39b3t1766222085.png",
+      "idPlayer": "34162006",
+      "strPlayer": "Liam Roberts",
+      "idTeam": "134381",
+      "strTeam": "Mansfield Town",
+      "strCountry": "England",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idLineup": "864565",
+      "idEvent": "2434724",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "strPosition": "Forward",
+      "strPositionShort": "F",
+      "strFormation": null,
+      "strHome": "Yes",
+      "strSubstitute": "No",
+      "intSquadNumber": "18",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/rgjbgn1766222737.png",
+      "idPlayer": "34163692",
+      "strPlayer": "Rhys Oates",
+      "idTeam": "134381",
+      "strTeam": "Mansfield Town",
+      "strCountry": "England",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idLineup": "864570",
+      "idEvent": "2434724",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "strPosition": "Defensive Midfield",
+      "strPositionShort": "M",
+      "strFormation": null,
+      "strHome": "No",
+      "strSubstitute": "No",
+      "intSquadNumber": "16",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/ia9o8w1769331494.png",
+      "idPlayer": "34164499",
+      "strPlayer": "Christian N\u00f8rgaard",
+      "idTeam": "133604",
+      "strTeam": "Arsenal",
+      "strCountry": "Denmark",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idLineup": "864575",
+      "idEvent": "2434724",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "strPosition": "Centre-Forward",
+      "strPositionShort": "F",
+      "strFormation": null,
+      "strHome": "No",
+      "strSubstitute": "No",
+      "intSquadNumber": "29",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/hem4r91694204364.png",
+      "idPlayer": "34169226",
+      "strPlayer": "Kai Havertz",
+      "idTeam": "133604",
+      "strTeam": "Arsenal",
+      "strCountry": "Germany",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idLineup": "864574",
+      "idEvent": "2434724",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "strPosition": "Left Wing",
+      "strPositionShort": "M",
+      "strFormation": null,
+      "strHome": "No",
+      "strSubstitute": "No",
+      "intSquadNumber": "11",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/pnwfls1769331152.png",
+      "idPlayer": "34169883",
+      "strPlayer": "Gabriel Martinelli",
+      "idTeam": "133604",
+      "strTeam": "Arsenal",
+      "strCountry": "Brazil",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idLineup": "864571",
+      "idEvent": "2434724",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "strPosition": "Right Winger",
+      "strPositionShort": "M",
+      "strFormation": null,
+      "strHome": "No",
+      "strSubstitute": "No",
+      "intSquadNumber": "20",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/0x05ou1769330933.png",
+      "idPlayer": "34170520",
+      "strPlayer": "Noni Madueke",
+      "idTeam": "133604",
+      "strTeam": "Arsenal",
+      "strCountry": "England",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idLineup": "864569",
+      "idEvent": "2434724",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "strPosition": "Centre-Back",
+      "strPositionShort": "D",
+      "strFormation": null,
+      "strHome": "No",
+      "strSubstitute": "No",
+      "intSquadNumber": "33",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/e6icgz1769330125.png",
+      "idPlayer": "34175834",
+      "strPlayer": "Riccardo Calafiori",
+      "idTeam": "133604",
+      "strTeam": "Arsenal",
+      "strCountry": "Italy",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idLineup": "864561",
+      "idEvent": "2434724",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "strPosition": "Midfielder",
+      "strPositionShort": "M",
+      "strFormation": null,
+      "strHome": "Yes",
+      "strSubstitute": "No",
+      "intSquadNumber": "13",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/f6h02p1759864169.png",
+      "idPlayer": "34177947",
+      "strPlayer": "Jonathan Russell",
+      "idTeam": "134381",
+      "strTeam": "Mansfield Town",
+      "strCountry": "England",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idLineup": "864568",
+      "idEvent": "2434724",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "strPosition": "Centre-Back",
+      "strPositionShort": "D",
+      "strFormation": null,
+      "strHome": "No",
+      "strSubstitute": "No",
+      "intSquadNumber": "3",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/mzik4g1769331540.png",
+      "idPlayer": "34194118",
+      "strPlayer": "Cristhian Mosquera",
+      "idTeam": "133604",
+      "strTeam": "Arsenal",
+      "strCountry": "Spain",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idLineup": "864563",
+      "idEvent": "2434724",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "strPosition": "Defensive Midfield",
+      "strPositionShort": "M",
+      "strFormation": null,
+      "strHome": "Yes",
+      "strSubstitute": "No",
+      "intSquadNumber": "40",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/f7bh071766405710.png",
+      "idPlayer": "34219277",
+      "strPlayer": "George Abbott",
+      "idTeam": "134382",
+      "strTeam": "Wycombe Wanderers",
+      "strCountry": "England",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idLineup": "864559",
+      "idEvent": "2434724",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "strPosition": "Defender",
+      "strPositionShort": "D",
+      "strFormation": null,
+      "strHome": "Yes",
+      "strSubstitute": "No",
+      "intSquadNumber": "20",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/m84oa11766222366.png",
+      "idPlayer": "34222234",
+      "strPlayer": "Frazer Blake-Tracy",
+      "idTeam": "134381",
+      "strTeam": "Mansfield Town",
+      "strCountry": "England",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idLineup": "864572",
+      "idEvent": "2434724",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "strPosition": "Midfielder",
+      "strPositionShort": "M",
+      "strFormation": null,
+      "strHome": "No",
+      "strSubstitute": "No",
+      "intSquadNumber": "56",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/jzgrge1766827300.png",
+      "idPlayer": "34432407",
+      "strPlayer": "Max Dowman",
+      "idTeam": "133604",
+      "strTeam": "Arsenal",
+      "strCountry": "England",
+      "strSeason": "2025-2026"
+    }
+  ]
+}
--- a/docs/api_samples/sportsdb/09_v2_event_stats_real.json
+++ b/docs/api_samples/sportsdb/09_v2_event_stats_real.json
@@ -0,0 +1,166 @@
+{
+  "lookup": [
+    {
+      "idStatistic": "526548",
+      "idEvent": "2434724",
+      "idApiFootball": "1523412",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "strStat": "Shots on Goal",
+      "intHome": "5",
+      "intAway": "8"
+    },
+    {
+      "idStatistic": "526549",
+      "idEvent": "2434724",
+      "idApiFootball": "1523412",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "strStat": "Shots off Goal",
+      "intHome": "9",
+      "intAway": "6"
+    },
+    {
+      "idStatistic": "526550",
+      "idEvent": "2434724",
+      "idApiFootball": "1523412",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "strStat": "Total Shots",
+      "intHome": "18",
+      "intAway": "19"
+    },
+    {
+      "idStatistic": "526551",
+      "idEvent": "2434724",
+      "idApiFootball": "1523412",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "strStat": "Blocked Shots",
+      "intHome": "4",
+      "intAway": "5"
+    },
+    {
+      "idStatistic": "526552",
+      "idEvent": "2434724",
+      "idApiFootball": "1523412",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "strStat": "Shots insidebox",
+      "intHome": "11",
+      "intAway": "17"
+    },
+    {
+      "idStatistic": "526553",
+      "idEvent": "2434724",
+      "idApiFootball": "1523412",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "strStat": "Shots outsidebox",
+      "intHome": "7",
+      "intAway": "2"
+    },
+    {
+      "idStatistic": "526554",
+      "idEvent": "2434724",
+      "idApiFootball": "1523412",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "strStat": "Fouls",
+      "intHome": "16",
+      "intAway": "6"
+    },
+    {
+      "idStatistic": "526555",
+      "idEvent": "2434724",
+      "idApiFootball": "1523412",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "strStat": "Corner Kicks",
+      "intHome": "4",
+      "intAway": "8"
+    },
+    {
+      "idStatistic": "526556",
+      "idEvent": "2434724",
+      "idApiFootball": "1523412",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "strStat": "Offsides",
+      "intHome": "1",
+      "intAway": "1"
+    },
+    {
+      "idStatistic": "526557",
+      "idEvent": "2434724",
+      "idApiFootball": "1523412",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "strStat": "Ball Possession",
+      "intHome": "33",
+      "intAway": "67"
+    },
+    {
+      "idStatistic": "526558",
+      "idEvent": "2434724",
+      "idApiFootball": "1523412",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "strStat": "Yellow Cards",
+      "intHome": "4",
+      "intAway": "2"
+    },
+    {
+      "idStatistic": "526559",
+      "idEvent": "2434724",
+      "idApiFootball": "1523412",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "strStat": "Red Cards",
+      "intHome": "0",
+      "intAway": "0"
+    },
+    {
+      "idStatistic": "526560",
+      "idEvent": "2434724",
+      "idApiFootball": "1523412",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "strStat": "Goalkeeper Saves",
+      "intHome": "5",
+      "intAway": "4"
+    },
+    {
+      "idStatistic": "526561",
+      "idEvent": "2434724",
+      "idApiFootball": "1523412",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "strStat": "Total passes",
+      "intHome": "260",
+      "intAway": "544"
+    },
+    {
+      "idStatistic": "526562",
+      "idEvent": "2434724",
+      "idApiFootball": "1523412",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "strStat": "Passes accurate",
+      "intHome": "191",
+      "intAway": "459"
+    },
+    {
+      "idStatistic": "526563",
+      "idEvent": "2434724",
+      "idApiFootball": "1523412",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "strStat": "Passes %",
+      "intHome": "73",
+      "intAway": "84"
+    },
+    {
+      "idStatistic": "526564",
+      "idEvent": "2434724",
+      "idApiFootball": "1523412",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "strStat": "expected_goals",
+      "intHome": "0",
+      "intAway": "0"
+    },
+    {
+      "idStatistic": "526565",
+      "idEvent": "2434724",
+      "idApiFootball": "1523412",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "strStat": "goals_prevented",
+      "intHome": "0",
+      "intAway": "0"
+    }
+  ]
+}
--- a/docs/api_samples/sportsdb/09_v2_event_timeline_real.json
+++ b/docs/api_samples/sportsdb/09_v2_event_timeline_real.json
@@ -0,0 +1,382 @@
+{
+  "lookup": [
+    {
+      "idTimeline": "1628218",
+      "idEvent": "2434724",
+      "strTimeline": "subst",
+      "strTimelineDetail": "Substitution 1",
+      "strHome": "No",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "idPlayer": "34153358",
+      "strPlayer": "Leandro Trossard",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/07fzpg1769331977.png",
+      "idAssist": "34182526",
+      "strAssist": "Piero Hincapi\u00e9",
+      "intTime": "38",
+      "strPeriod": null,
+      "idTeam": "133604",
+      "strTeam": "Arsenal",
+      "strComment": "NULL",
+      "dateEvent": "2026-03-07",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idTimeline": "1628219",
+      "idEvent": "2434724",
+      "strTimeline": "Goal",
+      "strTimelineDetail": "Normal Goal",
+      "strHome": "No",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "idPlayer": "34170520",
+      "strPlayer": "Noni Madueke",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/0x05ou1769330933.png",
+      "idAssist": "34169883",
+      "strAssist": "Gabriel Martinelli",
+      "intTime": "41",
+      "strPeriod": null,
+      "idTeam": "133604",
+      "strTeam": "Arsenal",
+      "strComment": "NULL",
+      "dateEvent": "2026-03-07",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idTimeline": "1628220",
+      "idEvent": "2434724",
+      "strTimeline": "subst",
+      "strTimelineDetail": "Substitution 1",
+      "strHome": "Yes",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "idPlayer": "34161977",
+      "strPlayer": "Tyler Roberts",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/2qalar1766222815.png",
+      "idAssist": "34217628",
+      "strAssist": "Will Evans",
+      "intTime": "46",
+      "strPeriod": null,
+      "idTeam": "134381",
+      "strTeam": "Mansfield Town",
+      "strComment": "NULL",
+      "dateEvent": "2026-03-07",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idTimeline": "1628221",
+      "idEvent": "2434724",
+      "strTimeline": "Goal",
+      "strTimelineDetail": "Normal Goal",
+      "strHome": "Yes",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "idPlayer": "34217628",
+      "strPlayer": "Will Evans",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/cf9nlh1766222631.png",
+      "idAssist": "0",
+      "strAssist": "",
+      "intTime": "50",
+      "strPeriod": null,
+      "idTeam": "134381",
+      "strTeam": "Mansfield Town",
+      "strComment": "NULL",
+      "dateEvent": "2026-03-07",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idTimeline": "1628222",
+      "idEvent": "2434724",
+      "strTimeline": "Card",
+      "strTimelineDetail": "Yellow Card",
+      "strHome": "Yes",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "idPlayer": "34159025",
+      "strPlayer": "Louis Reed",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/ethhbe1766223156.png",
+      "idAssist": "0",
+      "strAssist": "",
+      "intTime": "60",
+      "strPeriod": null,
+      "idTeam": "134381",
+      "strTeam": "Mansfield Town",
+      "strComment": "Persistent fouling",
+      "dateEvent": "2026-03-07",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idTimeline": "1628223",
+      "idEvent": "2434724",
+      "strTimeline": "subst",
+      "strTimelineDetail": "Substitution 2",
+      "strHome": "Yes",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "idPlayer": "34219277",
+      "strPlayer": "George Abbott",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/f7bh071766405710.png",
+      "idAssist": "34217722",
+      "strAssist": "Aaron Lewis",
+      "intTime": "62",
+      "strPeriod": null,
+      "idTeam": "134381",
+      "strTeam": "Mansfield Town",
+      "strComment": "NULL",
+      "dateEvent": "2026-03-07",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idTimeline": "1628224",
+      "idEvent": "2434724",
+      "strTimeline": "subst",
+      "strTimelineDetail": "Substitution 3",
+      "strHome": "No",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "idPlayer": "34169226",
+      "strPlayer": "Kai Havertz",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/hem4r91694204364.png",
+      "idAssist": "34172278",
+      "strAssist": "Eberechi Eze",
+      "intTime": "62",
+      "strPeriod": null,
+      "idTeam": "133604",
+      "strTeam": "Arsenal",
+      "strComment": "NULL",
+      "dateEvent": "2026-03-07",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idTimeline": "1628225",
+      "idEvent": "2434724",
+      "strTimeline": "Goal",
+      "strTimelineDetail": "Normal Goal",
+      "strHome": "No",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "idPlayer": "34172278",
+      "strPlayer": "Eberechi Eze",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/jcabmd1769330240.png",
+      "idAssist": "34164499",
+      "strAssist": "Christian N\u00f8rgaard",
+      "intTime": "66",
+      "strPeriod": null,
+      "idTeam": "133604",
+      "strTeam": "Arsenal",
+      "strComment": "NULL",
+      "dateEvent": "2026-03-07",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idTimeline": "1628226",
+      "idEvent": "2434724",
+      "strTimeline": "Card",
+      "strTimelineDetail": "Yellow Card",
+      "strHome": "No",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "idPlayer": "34175834",
+      "strPlayer": "Riccardo Calafiori",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/e6icgz1769330125.png",
+      "idAssist": "0",
+      "strAssist": "",
+      "intTime": "70",
+      "strPeriod": null,
+      "idTeam": "133604",
+      "strTeam": "Arsenal",
+      "strComment": "NULL",
+      "dateEvent": "2026-03-07",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idTimeline": "1628227",
+      "idEvent": "2434724",
+      "strTimeline": "Card",
+      "strTimelineDetail": "Yellow Card",
+      "strHome": "No",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "idPlayer": "34172278",
+      "strPlayer": "Eberechi Eze",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/jcabmd1769330240.png",
+      "idAssist": "0",
+      "strAssist": "",
+      "intTime": "74",
+      "strPeriod": null,
+      "idTeam": "133604",
+      "strTeam": "Arsenal",
+      "strComment": "Argument",
+      "dateEvent": "2026-03-07",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idTimeline": "1628228",
+      "idEvent": "2434724",
+      "strTimeline": "subst",
+      "strTimelineDetail": "Substitution 4",
+      "strHome": "No",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "idPlayer": "34175834",
+      "strPlayer": "Riccardo Calafiori",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/e6icgz1769330125.png",
+      "idAssist": "34252280",
+      "strAssist": "Jaden Dixon",
+      "intTime": "76",
+      "strPeriod": null,
+      "idTeam": "133604",
+      "strTeam": "Arsenal",
+      "strComment": "NULL",
+      "dateEvent": "2026-03-07",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idTimeline": "1628229",
+      "idEvent": "2434724",
+      "strTimeline": "Card",
+      "strTimelineDetail": "Yellow Card",
+      "strHome": "Yes",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "idPlayer": "34161076",
+      "strPlayer": "Lucas Akins",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/04lwea1766222596.png",
+      "idAssist": "0",
+      "strAssist": "",
+      "intTime": "77",
+      "strPeriod": null,
+      "idTeam": "134381",
+      "strTeam": "Mansfield Town",
+      "strComment": "Foul",
+      "dateEvent": "2026-03-07",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idTimeline": "1628230",
+      "idEvent": "2434724",
+      "strTimeline": "subst",
+      "strTimelineDetail": "Substitution 5",
+      "strHome": "No",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "idPlayer": "34432407",
+      "strPlayer": "Max Dowman",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/jzgrge1766827300.png",
+      "idAssist": "34169884",
+      "strAssist": "Bukayo Saka",
+      "intTime": "77",
+      "strPeriod": null,
+      "idTeam": "133604",
+      "strTeam": "Arsenal",
+      "strComment": "NULL",
+      "dateEvent": "2026-03-07",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idTimeline": "1628231",
+      "idEvent": "2434724",
+      "strTimeline": "Card",
+      "strTimelineDetail": "Yellow Card",
+      "strHome": "Yes",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "idPlayer": "34148796",
+      "strPlayer": "Stephen McLaughlin",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/wigvjk1766222238.png",
+      "idAssist": "0",
+      "strAssist": "",
+      "intTime": "80",
+      "strPeriod": null,
+      "idTeam": "134381",
+      "strTeam": "Mansfield Town",
+      "strComment": "Simulation",
+      "dateEvent": "2026-03-07",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idTimeline": "1628232",
+      "idEvent": "2434724",
+      "strTimeline": "subst",
+      "strTimelineDetail": "Substitution 3",
+      "strHome": "Yes",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "idPlayer": "34163692",
+      "strPlayer": "Rhys Oates",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/rgjbgn1766222737.png",
+      "idAssist": "34158800",
+      "strAssist": "Victor Adeboyejo",
+      "intTime": "81",
+      "strPeriod": null,
+      "idTeam": "134381",
+      "strTeam": "Mansfield Town",
+      "strComment": "NULL",
+      "dateEvent": "2026-03-07",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idTimeline": "1628233",
+      "idEvent": "2434724",
+      "strTimeline": "subst",
+      "strTimelineDetail": "Substitution 4",
+      "strHome": "Yes",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "idPlayer": "34148796",
+      "strPlayer": "Stephen McLaughlin",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/wigvjk1766222238.png",
+      "idAssist": "34301205",
+      "strAssist": "Oliver Irow",
+      "intTime": "81",
+      "strPeriod": null,
+      "idTeam": "134381",
+      "strTeam": "Mansfield Town",
+      "strComment": "NULL",
+      "dateEvent": "2026-03-07",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idTimeline": "1628234",
+      "idEvent": "2434724",
+      "strTimeline": "subst",
+      "strTimelineDetail": "Substitution 5",
+      "strHome": "Yes",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "idPlayer": "34161986",
+      "strPlayer": "Kyle Knoyle",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/u6shyg1766222184.png",
+      "idAssist": "34147620",
+      "strAssist": "Elliott Hewitt",
+      "intTime": "87",
+      "strPeriod": null,
+      "idTeam": "134381",
+      "strTeam": "Mansfield Town",
+      "strComment": "NULL",
+      "dateEvent": "2026-03-07",
+      "strSeason": "2025-2026"
+    },
+    {
+      "idTimeline": "1628235",
+      "idEvent": "2434724",
+      "strTimeline": "Card",
+      "strTimelineDetail": "Yellow Card",
+      "strHome": "Yes",
+      "strEvent": "Mansfield Town vs Arsenal",
+      "idAPIfootball": "1523412",
+      "idPlayer": "34217722",
+      "strPlayer": "Aaron Lewis",
+      "strCutout": "https://r2.thesportsdb.com/images/media/player/cutout/wwn1la1766222448.png",
+      "idAssist": "0",
+      "strAssist": "",
+      "intTime": "90",
+      "strPeriod": null,
+      "idTeam": "134381",
+      "strTeam": "Mansfield Town",
+      "strComment": "Foul",
+      "dateEvent": "2026-03-07",
+      "strSeason": "2025-2026"
+    }
+  ]
+}
--- a/docs/rapidapi-football-api-reference.md
+++ b/docs/rapidapi-football-api-reference.md
@@ -0,0 +1,260 @@
+# Free API Live Football Data — API Reference
+
+**Provider:** Sby Smart API (Creativesdev) on RapidAPI
+**Base URL:** `https://free-api-live-football-data.p.rapidapi.com`
+
+## Authentication
+
+All requests require two headers:
+
+```
+x-rapidapi-host: free-api-live-football-data.p.rapidapi.com
+x-rapidapi-key: YOUR_API_KEY
+```
+
+## Pricing
+
+| Plan | Price | Requests/Month |
+|------|-------|----------------|
+| Basic (Free) | $0 | 100 |
+| Pro | $9.99/mo | 20,000 |
+| Ultra | $19.99/mo | 200,000 |
+| Mega | $49.99/mo | 500,000 |
+
+All plans include the same features/endpoints — only volume differs.
+
+---
+
+## Key IDs
+
+- **leagueid** — League identifier (e.g., `42` for Premier League, `47` for another league). Use search or league list to find MLS ID.
+- **teamid** — Team identifier (e.g., `8650`). Use team search or team list to find.
+- **playerid** — Player identifier (e.g., `671529`). Use player search or squad list to find.
+- **eventid** — Match/event identifier (e.g., `4621624`). Use fixtures or livescores to find.
+
+---
+
+## Endpoints
+
+### Popular Leagues
+
+```
+GET /football-popular-leagues
+```
+
+### Countries
+
+```
+GET /football-get-all-countries
+```
+
+### Seasons
+
+```
+GET /football-league-all-seasons
+```
+
+---
+
+### Livescores
+
+```
+GET /football-current-live
+```
+
+Returns all currently live matches worldwide with scores, status, and timing info.
+
+---
+
+### Fixtures
+
+```
+GET /football-get-matches-by-date?date={YYYYMMDD}
+GET /football-get-matches-by-date-and-league?date={YYYYMMDD}
+GET /football-get-all-matches-by-league?leagueid={leagueid}
+```
+
+---
+
+### Leagues
+
+```
+GET /football-get-all-leagues
+GET /football-get-all-leagues-with-countries
+GET /football-get-league-detail?leagueid={leagueid}
+GET /football-get-league-logo?leagueid={leagueid}
+```
+
+---
+
+### Teams
+
+```
+GET /football-get-list-all-team?leagueid={leagueid}
+GET /football-get-list-home-team?leagueid={leagueid}
+GET /football-get-list-away-team?leagueid={leagueid}
+GET /football-league-team?teamid={teamid}
+GET /football-team-logo?teamid={teamid}
+```
+
+---
+
+### Players / Athletes / Squad
+
+```
+GET /football-get-list-player?teamid={teamid}
+GET /football-get-player-detail?playerid={playerid}
+GET /football-get-player-logo?playerid={playerid}
+```
+
+---
+
+### Events / Matches
+
+```
+GET /football-get-match-detail?eventid={eventid}
+GET /football-get-match-score?eventid={eventid}
+GET /football-get-match-status?eventid={eventid}
+GET /football-get-match-highlights?eventid={eventid}
+GET /football-get-match-location?eventid={eventid}
+GET /football-get-match-all-stats?eventid={eventid}
+GET /football-get-match-firstHalf-stats?eventid={eventid}
+GET /football-get-match-secondhalf-stats?eventid={eventid}
+GET /football-get-match-referee?eventid={eventid}
+```
+
+---
+
+### Odds
+
+```
+GET /football-event-odds?eventid={eventid}&countrycode={CC}
+GET /football-get-match-oddspoll?eventid={eventid}
+GET /football-get-match-odds-voteresult?eventid={eventid}
+```
+
+---
+
+### Statistics
+
+```
+GET /football-get-match-event-all-stats?eventid={eventid}
+GET /football-get-match-event-firstHalf-stats?eventid={eventid}
+GET /football-get-match-event-secondhalf-stats?eventid={eventid}
+```
+
+---
+
+### Lineups
+
+```
+GET /football-get-hometeam-lineup?eventid={eventid}
+GET /football-get-awayteam-lineup?eventid={eventid}
+```
+
+---
+
+### Head to Head
+
+```
+GET /football-get-head-to-head?eventid={eventid}
+```
+
+---
+
+### Standings
+
+```
+GET /football-get-standing-all?leagueid={leagueid}
+GET /football-get-standing-home?leagueid={leagueid}
+GET /football-get-standing-away?leagueid={leagueid}
+```
+
+---
+
+### Rounds
+
+```
+GET /football-get-all-rounds?leagueid={leagueid}
+GET /football-get-rounds-detail?roundid={roundid}
+GET /football-get-rounds-players?leagueid={leagueid}
+```
+
+---
+
+### Trophies
+
+```
+GET /football-get-trophies-all-seasons?leagueid={leagueid}
+GET /football-get-trophies-detail?leagueid={leagueid}&season={season}
+```
+
+Season format example: `2023/2024` (URL-encoded as `2023%2F2024`)
+
+---
+
+### Top Players
+
+```
+GET /football-get-top-players-by-assists?leagueid={leagueid}
+GET /football-get-top-players-by-goals?leagueid={leagueid}
+GET /football-get-top-players-by-rating?leagueid={leagueid}
+```
+
+---
+
+### Transfers
+
+```
+GET /football-get-all-transfers?page={page}
+GET /football-get-top-transfers?page={page}
+GET /football-get-market-value-transfers?page={page}
+GET /football-get-league-transfers?leagueid={leagueid}
+GET /football-get-team-contract-extension-transfers?teamid={teamid}
+GET /football-get-team-players-in-transfers?teamid={teamid}
+GET /football-get-team-players-out-transfers?teamid={teamid}
+```
+
+---
+
+### News
+
+```
+GET /football-get-trendingnews
+GET /football-get-league-news?leagueid={leagueid}&page={page}
+GET /football-get-team-news?teamid={teamid}&page={page}
+```
+
+---
+
+### Search
+
+```
+GET /football-all-search?search={query}
+GET /football-teams-search?search={query}
+GET /football-players-search?search={query}
+GET /football-leagues-search?search={query}
+GET /football-matches-search?search={query}
+```
+
+---
+
+## Typical Workflow for MLS
+
+1. **Find MLS league ID:** `GET /football-leagues-search?search=mls`
+2. **Get Toronto FC team ID:** `GET /football-teams-search?search=toronto`
+3. **Get upcoming fixtures:** `GET /football-get-all-matches-by-league?leagueid={MLS_ID}`
+4. **Get live scores:** `GET /football-current-live` (filter for MLS matches)
+5. **Get match details:** `GET /football-get-match-detail?eventid={eventid}`
+6. **Get lineups:** `GET /football-get-hometeam-lineup?eventid={eventid}`
+7. **Get match stats:** `GET /football-get-match-all-stats?eventid={eventid}`
+8. **Get standings:** `GET /football-get-standing-all?leagueid={MLS_ID}`
+
+---
+
+## Notes
+
+- Data appears to be sourced from FotMob based on field naming conventions and ID patterns.
+- No external documentation exists — this reference was compiled from the RapidAPI playground.
+- Date format for fixtures: `YYYYMMDD` (e.g., `20241107`)
+- The "Statistics" category endpoints overlap with the match stats endpoints under "Events/Matches" — they may return the same or differently structured data. Test both.
--- a/docs/sportsdb_api_v1_reference.md
+++ b/docs/sportsdb_api_v1_reference.md
@@ -0,0 +1,385 @@
+# TheSportsDB API V1 — Validated Reference
+
+**Validated on:** 2026-03-09 using free test key `3`
+**Base URL:** `https://www.thesportsdb.com/api/v1/json/{key}`
+**Auth:** Key embedded in URL path (free test key: `3`, premium: same Patreon key as V2)
+**Source samples:** `docs/api_samples/sportsdb/`
+
+> **This document covers ONLY what was tested and confirmed with real API calls.**
+> V2 endpoints are NOT covered — they require a premium key and have not been tested.
+
+---
+
+## Free Key Limitations
+
+The free key (`3`) returns **limited results** (typically 5 rows for standings, returns wrong/random events for some lookups). The response **structure and field names** are valid regardless — only row count and relevance are affected.
+
+---
+
+## Validated IDs
+
+| Entity | TheSportsDB ID | Notes |
+|--------|----------------|-------|
+| MLS | `4346` | Listed as "American Major League Soccer" |
+| English Premier League | `4328` | "English Premier League" |
+| Toronto FC | `134148` | Short: `TOR`, league: 4346 |
+| Arsenal | `133604` | Short: `ARS`, league: 4328 |
+| Federico Bernardeschi | `34148472` | Position: Winger |
+
+---
+
+## Endpoints
+
+### 1. Search Teams
+
+```
+GET /searchteams.php?t={team_name}
+```
+
+**Tested with:** `Toronto FC`, `Arsenal`
+**Response wrapper:** `{"teams": [...]}`
+**Returns:** Array of matching team objects (1 exact match each)
+
+#### Validated fields (all values are strings or null):
+
+| Field | Example (TFC) | Example (Arsenal) | Notes |
+|-------|---------------|-------------------|-------|
+| `idTeam` | `"134148"` | `"133604"` | String, not int |
+| `idESPN` | `null` | `"359"` | Nullable |
+| `idAPIfootball` | `"1601"` | `"42"` | Cross-ref to API-Football |
+| `intLoved` | `"2"` | `"9"` | String of int |
+| `strTeam` | `"Toronto FC"` | `"Arsenal"` | Full name |
+| `strTeamAlternate` | `""` | `"Arsenal Football Club, AFC, Arsenal FC"` | Comma-separated aliases |
+| `strTeamShort` | `"TOR"` | `"ARS"` | 3-letter code |
+| `intFormedYear` | `"2006"` | `"1892"` | String of int |
+| `strSport` | `"Soccer"` | `"Soccer"` | |
+| `strLeague` | `"American Major League Soccer"` | `"English Premier League"` | Primary league |
+| `idLeague` | `"4346"` | `"4328"` | String of int |
+| `strLeague2`..`strLeague7` | `"Leagues Cup"` | `"FA Cup"`, `"EFL Cup"`, etc. | Additional leagues/cups |
+| `idLeague2`..`idLeague7` | `"5281"` | `"4482"`, `"4570"`, etc. | IDs for above |
+| `strDivision` | `null` | `null` | |
+| `idVenue` | `"16782"` | `"15528"` | String of int |
+| `strStadium` | `"BMO Field"` | `"Emirates Stadium"` | |
+| `strKeywords` | `""` | `"Gunners, Gooners"` | Nicknames |
+| `strRSS` | `""` | `""` | |
+| `strLocation` | `"Toronto, Ontario"` | `"Holloway, London, England"` | |
+| `intStadiumCapacity` | `"30991"` | `"60338"` | String of int |
+| `strWebsite` | `"www.torontofc.ca"` | `"www.arsenal.com"` | No protocol |
+| `strFacebook` | `"www.facebook.com/torontofc"` | `"www.facebook.com/Arsenal"` | |
+| `strTwitter` | `"twitter.com/torontofc"` | `"twitter.com/arsenal"` | |
+| `strInstagram` | `"www.instagram.com/torontofc"` | `"instagram.com/arsenal"` | |
+| `strDescriptionEN` | Full paragraph | Full paragraph | English bio, `\r\n` separated |
+| `strDescriptionDE`..`strDescriptionPL` | `null` or text | `null` or text | 14 language variants |
+| `strColour1` | `"#B81137"` | `"#EF0107"` | Hex color |
+| `strColour2` | `"#455560"` | `"#023474"` | |
+| `strColour3` | `""` | `"#9C824A"` | May be empty |
+| `strGender` | `"Male"` | `"Male"` | |
+| `strCountry` | `"Canada"` | `"England"` | |
+| `strBadge` | URL | URL | PNG badge |
+| `strLogo` | URL | URL | PNG logo |
+| `strFanart1`..`strFanart4` | URL or null | URL or null | Fan art images |
+| `strBanner` | URL | URL | Banner image |
+| `strEquipment` | URL | URL | Kit/equipment image |
+| `strYoutube` | `"www.youtube.com/torontofc"` | `"www.youtube.com/ArsenalTour"` | |
+| `strLocked` | `"unlocked"` | `"unlocked"` | |
+
+**Key observations:**
+- ALL numeric values are returned as **strings** (e.g., `"134148"` not `134148`)
+- Team can belong to up to 7 leagues/cups
+- `idAPIfootball` provides cross-reference to API-Football IDs
+
+---
+
+### 2. Lookup Team by ID
+
+```
+GET /lookupteam.php?id={idTeam}
+```
+
+**Tested with:** `134148` (Toronto FC) — but free key returned Arsenal instead (known free-key bug)
+**Response wrapper:** `{"teams": [...]}`
+**Fields:** Identical to search response above.
+
+**⚠ Free key pitfall:** Lookup by ID returned the wrong team (Arsenal instead of TFC). This is a free-key limitation, not a field-structure issue. The response shape is the same as search.
+
+---
+
+### 3. Previous Team Events (Last Results)
+
+```
+GET /eventslast.php?id={idTeam}
+```
+
+**Tested with:** `134148` (Toronto FC)
+**Response wrapper:** `{"results": [...]}`  ← Note: key is `results`, NOT `events`
+**Returns:** Last 5 results for the team (free key returned 1)
+
+#### Validated event fields:
+
+| Field | Example | Notes |
+|-------|---------|-------|
+| `idEvent` | `"2425216"` | String |
+| `idAPIfootball` | `"1514800"` | Cross-ref, nullable |
+| `strEvent` | `"Toronto FC vs Polissya Zhytomyr"` | Match title |
+| `strEventAlternate` | `"Polissya Zhytomyr @ Toronto FC"` | Away @ Home format |
+| `strFilename` | `"Club Friendlies 2026-02-14 Toronto FC vs Polissya Zhytomyr"` | League + date + teams |
+| `strSport` | `"Soccer"` | |
+| `idLeague` | `"4569"` | String — league of this match |
+| `strLeague` | `"Club Friendlies"` | |
+| `strLeagueBadge` | URL | League badge |
+| `strSeason` | `"2026"` | or `"2025-2026"` for Euro leagues |
+| `strDescriptionEN` | `""` | Match description (usually empty) |
+| `strHomeTeam` | `"Toronto FC"` | |
+| `strAwayTeam` | `"Polissya Zhytomyr"` | |
+| `intHomeScore` | `"2"` | String of int, null if not played |
+| `intAwayScore` | `"1"` | String of int, null if not played |
+| `intRound` | `"0"` | String, `"0"` for friendlies |
+| `intSpectators` | `null` | Nullable |
+| `strOfficial` | `""` | Referee, often empty |
+| `strTimestamp` | `"2026-02-14T09:45:00"` | ISO-ish, no timezone |
+| `dateEvent` | `"2026-02-14"` | YYYY-MM-DD |
+| `dateEventLocal` | `"2026-02-14"` | Local date |
+| `strTime` | `"09:45:00"` | UTC time |
+| `strTimeLocal` | `"04:45:00"` | Local time |
+| `strGroup` | `""` | Group stage name, nullable |
+| `idHomeTeam` | `"134148"` | String |
+| `strHomeTeamBadge` | URL | Team badge |
+| `idAwayTeam` | `"140180"` | String |
+| `strAwayTeamBadge` | URL | Team badge |
+| `intScore` | `null` | Aggregate/extra score? Always null in sample |
+| `intScoreVotes` | `null` | Always null |
+| `strResult` | `""` | Text result summary, empty |
+| `idVenue` | `"16782"` | String |
+| `strVenue` | `"BMO Field"` | |
+| `strCountry` | `"Canada"` | |
+| `strCity` | `""` | Often empty |
+| `strPoster` | `""` | Image URLs, often empty |
+| `strSquare` | `""` | |
+| `strFanart` | `null` | |
+| `strThumb` | `""` | |
+| `strBanner` | `""` | |
+| `strMap` | `null` | |
+| `strTweet1` | `""` | |
+| `strVideo` | `""` | Highlight video URL |
+| `strStatus` | `"Match Finished"` | See status values below |
+| `strPostponed` | `"no"` | `"no"` or `"yes"` |
+| `strLocked` | `"unlocked"` | |
+
+**Known `strStatus` values:** `"Match Finished"`, `"Not Started"`, `null` (old events)
+
+---
+
+### 4. Next Team Events (Upcoming)
+
+```
+GET /eventsnext.php?id={idTeam}
+```
+
+**Tested with:** `134148` (Toronto FC)
+**Response wrapper:** `{"events": [...]}`  ← Note: key is `events` (different from `eventslast`)
+**Returns:** Next 5–15 upcoming events
+
+**Fields:** Identical to the event structure in section 3 above, except:
+- `intHomeScore` / `intAwayScore` = `null` (not yet played)
+- `strStatus` = `"Not Started"`
+- `dateEventLocal` / `strTimeLocal` may be `null`
+- `strThumb` may have a URL (match preview image)
+
+**⚠ Free key pitfall:** Free key returned Bolton Wanderers fixtures instead of Toronto FC fixtures. The event field structure is still valid.
+
+---
+
+### 5. Event Lookup by ID
+
+```
+GET /lookupevent.php?id={idEvent}
+```
+
+**Tested with:** `2425216`
+**Response wrapper:** `{"events": [...]}`
+**Returns:** Single event in array
+
+**Fields:** Same event structure as section 3. All fields present.
+
+**⚠ Free key pitfall:** Free key returned a completely different event (Liverpool vs Swansea 2014 instead of TFC vs Polissya 2026). The field structure is still valid — the values are just wrong.
+
+---
+
+### 6. Search Players
+
+```
+GET /searchplayers.php?p={player_name}
+```
+
+**Tested with:** `Bernardeschi`
+**Response wrapper:** `{"player": [...]}`  ← Note: key is `player`, singular
+**Returns:** Array of matching players
+
+#### Validated fields:
+
+| Field | Example | Notes |
+|-------|---------|-------|
+| `idPlayer` | `"34148472"` | String |
+| `idTeam` | `"134781"` | String |
+| `strPlayer` | `"Federico Bernardeschi"` | Full name |
+| `strTeam` | `"Bologna"` | Current team (may not match Toronto FC if transferred) |
+| `strSport` | `"Soccer"` | |
+| `strThumb` | URL | Player thumbnail |
+| `strCutout` | URL | Player cutout image |
+| `strNationality` | `"Italy"` | |
+| `dateBorn` | `"1994-02-16"` | YYYY-MM-DD |
+| `strStatus` | `"Active"` | `"Active"` or `"Retired"` |
+| `strGender` | `"Male"` | |
+| `strPosition` | `"Winger"` | |
+| `relevance` | `"28.93..."` | Float as string, search relevance score |
+
+**Note:** V1 player search returns a **minimal** field set (13 fields). V2 `lookup/player/{id}` is expected to return full bio, height, weight, description, etc. — **not yet tested**.
+
+---
+
+### 7. Standings / League Table
+
+```
+GET /lookuptable.php?l={idLeague}&s={season}
+```
+
+**Tested with:** `l=4328&s=2025-2026` (EPL), `l=4346&s=2026` (MLS)
+**Response wrapper:** `{"table": [...]}`
+**Returns:** Standings rows (free key: 5 rows; premium: full table)
+
+#### Validated fields:
+
+| Field | Example (EPL) | Example (MLS) | Notes |
+|-------|---------------|---------------|-------|
+| `idStanding` | `"8793837"` | `"8790287"` | String |
+| `intRank` | `"1"` | `"1"` | String of int |
+| `idTeam` | `"133604"` | `"150261"` | String |
+| `strTeam` | `"Arsenal"` | `"San Diego FC"` | |
+| `strBadge` | URL `/tiny` | URL `/tiny` | Tiny badge variant |
+| `idLeague` | `"4328"` | `"4346"` | String |
+| `strLeague` | `"English Premier League"` | `"American Major League Soccer"` | |
+| `strSeason` | `"2025-2026"` | `"2026"` | Euro vs US format |
+| `strForm` | `"WWWDD"` | `"WWW"` | Recent results W/D/L |
+| `strDescription` | `"Promotion - Champions League..."` | `"Promotion - MLS (Play Offs...)"` | Qualification zone |
+| `intPlayed` | `"30"` | `"3"` | String of int |
+| `intWin` | `"20"` | `"3"` | |
+| `intLoss` | `"3"` | `"0"` | |
+| `intDraw` | `"7"` | `"0"` | |
+| `intGoalsFor` | `"59"` | `"8"` | |
+| `intGoalsAgainst` | `"22"` | `"0"` | |
+| `intGoalDifference` | `"37"` | `"8"` | |
+| `intPoints` | `"67"` | `"9"` | |
+| `dateUpdated` | `"2026-03-09 06:01:21"` | `"2026-03-09 06:00:50"` | Last update timestamp |
+
+**Season format:**
+- European leagues: `"2025-2026"`
+- MLS / calendar-year leagues: `"2026"`
+
+**MLS standings note:** MLS has two conferences (East & West). The API returns **both mixed together** — ranks restart at `1` for each conference. There is no explicit conference field. You must use the rank patterns or `strDescription` to infer conference grouping.
+
+---
+
+### 8. Events by Date
+
+```
+GET /eventsday.php?d={YYYY-MM-DD}&s=Soccer       # all soccer events
+GET /eventsday.php?d={YYYY-MM-DD}&l={idLeague}    # filtered by league
+```
+
+**Tested with:** `d=2026-03-09&s=Soccer`, `d=2026-03-09&l=4346`
+**Response wrapper:** `{"events": [...]}` or `{"events": null}`
+
+**Fields:** Same event structure as section 3.
+
+**Results:**
+- Global soccer on 2026-03-09: Returned **1 event** (Melbourne Victory vs Western Sydney, from 2014) — free key returns stale/random data
+- MLS on 2026-03-09: Returned `{"events": null}` — no matches or free key limitation
+
+**⚠ Free key:** Events-by-date is unreliable on free key. The field structure matches section 3 but the actual events returned are wrong/old. Premium key should return correct current-day events.
+
+---
+
+## Response Patterns Summary
+
+| Endpoint | Wrapper Key | Null when empty |
+|----------|-------------|-----------------|
+| `searchteams.php` | `teams` | Unknown (always had results) |
+| `lookupteam.php` | `teams` | Unknown |
+| `eventslast.php` | `results` | Unknown |
+| `eventsnext.php` | `events` | Unknown |
+| `lookupevent.php` | `events` | Unknown |
+| `searchplayers.php` | `player` | Unknown |
+| `lookuptable.php` | `table` | Unknown |
+| `eventsday.php` | `events` | **Yes** — returns `{"events": null}` |
+
+---
+
+## Data Type Warning
+
+**All numeric fields are returned as strings.** Every `id*`, `int*`, and numeric value must be cast to `int` before use:
+
+```python
+team_id = int(team["idTeam"])      # "134148" → 134148
+capacity = int(team["intStadiumCapacity"])  # "30991" → 30991
+```
+
+---
+
+## V1 Endpoints NOT Tested
+
+These V1 endpoints exist in the API but were not called during discovery:
+
+| Endpoint | Purpose |
+|----------|---------|
+| `searchevents.php` | Search events by name |
+| `eventsnextleague.php` | Next events for a league |
+| `eventspastleague.php` | Previous events for a league |
+| `eventsseason.php` | All events in a season |
+| `lookup_all_players.php` | Full squad (V1 version) |
+| `lookupplayer.php` | Detailed player profile |
+| `all_sports.php` | All sports (used only for health check) |
+| `all_leagues.php` | All leagues |
+| `search_all_leagues.php` | Search leagues |
+
+---
+
+## V2 Endpoints — NOT TESTED (Premium Key Required)
+
+These are the V2 endpoints built into `nike/sportsdb.py` but **entirely untested**. All field names in the code are guessed from TheSportsDB OpenAPI docs and have NOT been validated against real responses.
+
+| Endpoint | Guessed wrapper key | What we don't know |
+|----------|--------------------|--------------------|
+| `GET /search/league/{name}` | `search` | Actual field names |
+| `GET /search/team/{name}` | `search` | May differ from V1 |
+| `GET /search/player/{name}` | `search` | May differ from V1 |
+| `GET /lookup/event/{id}` | `lookup` or `events` | May have extra fields vs V1 |
+| `GET /lookup/event_stats/{id}` | `lookup` | Field names like `strStat`, `intHome`, `intAway` are **guesses** |
+| `GET /lookup/event_timeline/{id}` | `lookup` | Field names like `intTime`, `strTimeline`, `strPlayer` are **guesses** |
+| `GET /lookup/event_lineup/{id}` | `lookup` | Fields like `intSquadNumber`, `strSubstitute`, `strHome` are **guesses** |
+| `GET /lookup/player/{id}` | `lookup` or `players` | May have `strHeight`, `strWeight`, `strDescriptionEN` |
+| `GET /lookup/player_contracts/{id}` | Unknown | Unknown |
+| `GET /lookup/player_honours/{id}` | Unknown | Unknown |
+| `GET /lookup/event_tv/{id}` | Unknown | Unknown |
+| `GET /lookup/venue/{id}` | Unknown | Unknown |
+| `GET /list/teams/{leagueId}` | `list` | Unknown |
+| `GET /list/seasons/{leagueId}` | `list` | Unknown |
+| `GET /list/players/{teamId}` | `list` | Field names for squad members unknown |
+| `GET /schedule/next/league/{id}` | Unknown | Unknown |
+| `GET /schedule/previous/league/{id}` | Unknown | Unknown |
+| `GET /schedule/next/team/{id}` | Unknown | Unknown |
+| `GET /schedule/previous/team/{id}` | Unknown | May match V1 `eventsnext` or differ |
+| `GET /schedule/full/team/{id}` | Unknown | Unknown |
+| `GET /schedule/league/{id}/{season}` | Unknown | Unknown |
+| `GET /livescore/soccer` | `livescore` | All field names **guessed** |
+
+---
+
+## Next Steps (After Getting Premium Key)
+
+1. Set `SPORTSDB_KEY=your_key` in `.env`
+2. Run `python scripts/discover_sportsdb.py` — it auto-detects premium and tests all V2 endpoints
+3. Review saved JSON files in `docs/api_samples/sportsdb/`
+4. Update this document with V2 validated fields
+5. Fix `sportsdb.py` client if any URL paths or wrapper keys are wrong
+6. Design `schema.sql` from real field names (current schema is drafted from guesses)
+7. Fix `server.py` tool formatters to use actual field names
--- a/docs/sportsdb_api_v2_reference.md
+++ b/docs/sportsdb_api_v2_reference.md
@@ -0,0 +1,308 @@
+# TheSportsDB API V2 — Validated Field Reference
+
+> **All fields below are validated against real API responses** from discovery
+> runs with a premium key ($9/mo Patreon). Last validated: 2026-03-10.
+
+## Authentication
+
+- **V2**: `X-API-KEY` header
+- **V1**: Key in URL path: `/api/v1/json/{key}/...`
+- Same premium key works for both
+
+## V2 Base URL
+
+```
+https://www.thesportsdb.com/api/v2/json
+```
+
+---
+
+## Endpoints & Response Schemas
+
+### Search Leagues — `/search/league/{name}`
+Wrapper key: `search`
+
+| Field | Type | Example |
+|-------|------|---------|
+| `idLeague` | string | `"5279"` |
+| `strLeague` | string | `"MLS Next Pro"` |
+| `strSport` | string | `"Soccer"` |
+| `strBadge` | string/null | URL |
+| `strCountry` | string | `"United States"` |
+| `strCurrentSeason` | string | `"2026"` |
+| `strGender` | string | `"Male"` |
+
+> ⚠️ V2 league search is unreliable — "MLS" returns "MLS Next Pro" (ID 5279),
+> not "American Major League Soccer" (ID 4346). Use V1 team search + `idLeague`
+> field as the authoritative source for league IDs.
+
+---
+
+### Schedule (Next/Previous) — `/schedule/{next|previous}/team/{teamId}`
+Wrapper key: `schedule`
+
+| Field | Type | Example |
+|-------|------|---------|
+| `idEvent` | string | `"2406751"` |
+| `strEvent` | string | `"FC Cincinnati vs Toronto FC"` |
+| `idLeague` | string | `"4346"` |
+| `strLeague` | string | `"American Major League Soccer"` |
+| `strSport` | string | `"Soccer"` |
+| `strHomeTeam` | string | `"FC Cincinnati"` |
+| `strAwayTeam` | string | `"Toronto FC"` |
+| `idHomeTeam` | string | `"136688"` |
+| `idAwayTeam` | string | `"134148"` |
+| `intRound` | string | `"3"` |
+| `intHomeScore` | string/null | `"0"` |
+| `intAwayScore` | string/null | `"1"` |
+| `strTimestamp` | string | `"2026-03-08T23:00:00"` |
+| `dateEvent` | string | `"2026-03-08"` |
+| `dateEventLocal` | string | `"2026-03-08"` |
+| `strTime` | string | `"23:00:00"` |
+| `strTimeLocal` | string | `"18:00:00"` |
+| `strHomeTeamBadge` | string | URL |
+| `strAwayTeamBadge` | string | URL |
+| `strVenue` | string | `"TQL Stadium"` |
+| `strCountry` | string | `"United States"` |
+| `strThumb` | string/null | URL |
+| `strPoster` | string/null | URL |
+| `strVideo` | string/null | YouTube URL |
+| `strPostponed` | string | `"no"` |
+| `strFilename` | string | descriptive filename |
+| `strStatus` | string | `"Match Finished"` / `"Not Started"` |
+
+---
+
+### Event Lookup — `/lookup/event/{eventId}`
+Wrapper key: `lookup`
+
+All schedule fields plus:
+
+| Field | Type | Example |
+|-------|------|---------|
+| `idAPIfootball` | string | `"1490149"` |
+| `strEventAlternate` | string | `"Toronto FC @ FC Cincinnati"` |
+| `strFilename` | string | descriptive |
+| `strLeagueBadge` | string | URL |
+| `strSeason` | string | `"2026"` |
+| `strDescriptionEN` | string | `""` |
+| `intSpectators` | null/string | `null` |
+| `strOfficial` | string | referee name |
+| `strGroup` | string | `""` |
+| `intScore` | null | |
+| `intScoreVotes` | null | |
+| `strResult` | string | `""` |
+| `idVenue` | string | `"20820"` |
+| `strCity` | string | `""` |
+| `strSquare` | string/null | URL |
+| `strFanart` | string/null | URL |
+| `strBanner` | string/null | URL |
+| `strMap` | string/null | |
+| `strTweet1` | string | `""` |
+| `strLocked` | string | `"unlocked"` |
+
+---
+
+### Event Stats — `/lookup/event_stats/{eventId}`
+Wrapper key: `lookup`
+
+| Field | Type | Example |
+|-------|------|---------|
+| `idStatistic` | string | `"526548"` |
+| `idEvent` | string | `"2434724"` |
+| `idApiFootball` | string | `"1523412"` |
+| `strEvent` | string | `"Mansfield Town vs Arsenal"` |
+| `strStat` | string | `"Shots on Goal"` |
+| `intHome` | string | `"5"` |
+| `intAway` | string | `"8"` |
+
+Known `strStat` values: `Shots on Goal`, `Shots off Goal`, `Total Shots`,
+`Blocked Shots`, `Shots insidebox`, `Shots outsidebox`, `Fouls`,
+`Corner Kicks`, `Offsides`, `Ball Possession`, `Yellow Cards`, `Red Cards`,
+`Goalkeeper Saves`, `Total passes`, `Passes accurate`, `Passes %`,
+`expected_goals`, `goals_prevented`.
+
+> ⚠️ Not all matches have stats. MLS and smaller leagues may return
+> `{"Message": "No data found"}`.
+
+---
+
+### Event Timeline — `/lookup/event_timeline/{eventId}`
+Wrapper key: `lookup`
+
+| Field | Type | Example |
+|-------|------|---------|
+| `idTimeline` | string | `"1628218"` |
+| `idEvent` | string | `"2434724"` |
+| `strTimeline` | string | `"subst"` / `"Goal"` / `"Yellow Card"` |
+| `strTimelineDetail` | string | `"Substitution 1"` / `"Normal Goal"` |
+| `strHome` | string | `"Yes"` / `"No"` |
+| `strEvent` | string | `"Mansfield Town vs Arsenal"` |
+| `idAPIfootball` | string | `"1523412"` |
+| `idPlayer` | string | `"34153358"` |
+| `strPlayer` | string | `"Leandro Trossard"` |
+| `strCutout` | string/null | URL |
+| `idAssist` | string/null | `"34182526"` |
+| `strAssist` | string/null | `"Piero Hincapié"` |
+| `intTime` | string | `"38"` |
+| `strPeriod` | string/null | |
+| `idTeam` | string | `"133604"` |
+| `strTeam` | string | `"Arsenal"` |
+| `strComment` | string | `"NULL"` (literal string, not null) |
+| `dateEvent` | string | `"2026-03-07"` |
+| `strSeason` | string | `"2025-2026"` |
+
+> ⚠️ `strComment` can be the literal string `"NULL"` — treat it as null.
+
+---
+
+### Event Lineup — `/lookup/event_lineup/{eventId}`
+Wrapper key: `lookup`
+
+| Field | Type | Example |
+|-------|------|---------|
+| `idLineup` | string | `"864558"` |
+| `idEvent` | string | `"2434724"` |
+| `strEvent` | string | `"Mansfield Town vs Arsenal"` |
+| `idAPIfootball` | string | `"1523412"` |
+| `strPosition` | string | `"Defender"` |
+| `strPositionShort` | string | `"D"` / `"G"` / `"M"` / `"F"` |
+| `strFormation` | string/null | |
+| `strHome` | string | `"Yes"` / `"No"` |
+| `strSubstitute` | string | `"Yes"` / `"No"` |
+| `intSquadNumber` | string | `"23"` |
+| `strCutout` | string/null | URL |
+| `idPlayer` | string | `"34145366"` |
+| `strPlayer` | string | `"Adedeji Oshilaja"` |
+| `idTeam` | string | `"134381"` |
+| `strTeam` | string | `"Mansfield"` |
+| `strCountry` | string | `"England"` |
+| `strSeason` | string | `"2025-2026"` |
+
+---
+
+### Squad (Roster) — `/list/players/{teamId}`
+Wrapper key: `list`
+
+| Field | Type | Example |
+|-------|------|---------|
+| `idPlayer` | string | `"34146036"` |
+| `strPlayer` | string | `"Kevin Long"` |
+| `idTeam` | string | `"134148"` |
+| `strTeam` | string | `"Toronto FC"` |
+| `strThumb` | string/null | URL |
+| `strCutout` | string/null | URL |
+| `strRender` | string/null | URL |
+| `dateBorn` | string | `"1990-08-18"` |
+| `strPosition` | string | `"Centre-Back"` |
+
+> ⚠️ Squad list does NOT include `strNumber`, `strNationality`, `strHeight`,
+> `strWeight`. Use `/lookup/player/{id}` for the full profile.
+
+---
+
+### Player Detail — `/lookup/player/{playerId}`
+Wrapper key: `lookup`
+
+| Field | Type | Example |
+|-------|------|---------|
+| `idPlayer` | string | `"34146036"` |
+| `idTeam` | string | `"134148"` |
+| `idTeam2` | string | `"0"` |
+| `idTeamNational` | string/null | |
+| `idAPIfootball` | string | `"18915"` |
+| `idPlayerManager` | string/null | |
+| `idWikidata` | string | `"Q6396794"` |
+| `idTransferMkt` | string | `"111114"` |
+| `idESPN` | string | `"140531"` |
+| `strNationality` | string | `"Ireland"` |
+| `strPlayer` | string | `"Kevin Long"` |
+| `strPlayerAlternate` | string | `""` |
+| `strTeam` | string | `"Toronto FC"` |
+| `strTeam2` | string | `""` |
+| `strSport` | string | `"Soccer"` |
+| `dateBorn` | string | `"1990-08-18"` |
+| `dateDied` | null/string | |
+| `strNumber` | string | `"5"` |
+| `dateSigned` | string | `"2010-07-01"` |
+| `strSigning` | string | |
+| `strWage` | string | |
+| `strBirthLocation` | string | `"Cork, Ireland"` |
+| `strStatus` | string | `"Active"` |
+| `strDescriptionEN` | string | biography |
+| `strGender` | string | `"Male"` |
+| `strSide` | string | `""` |
+| `strPosition` | string | `"Centre-Back"` |
+| `strHeight` | string | `"188 cm"` |
+| `strWeight` | string | `"183 lbs"` |
+| `intLoved` | string | `"0"` |
+| `strThumb` | string/null | URL |
+| `strCutout` | string/null | URL |
+| `strRender` | string/null | URL |
+| `strBanner` | string/null | URL |
+| `strLastName` | string | `"Long"` |
+
+---
+
+### Livescores — `/livescore/soccer`
+Wrapper key: `livescore`
+
+| Field | Type | Example |
+|-------|------|---------|
+| `idLiveScore` | string | `"29571878"` |
+| `idEvent` | string | `"2438107"` |
+| `strSport` | string | `"Soccer"` |
+| `idLeague` | string | `"4432"` |
+| `strLeague` | string | `"Uruguayan Primera Division"` |
+| `idHomeTeam` | string | `"136051"` |
+| `idAwayTeam` | string | `"136052"` |
+| `strHomeTeam` | string | `"Boston River"` |
+| `strAwayTeam` | string | `"Liverpool Montevideo"` |
+| `strHomeTeamBadge` | string | URL |
+| `strAwayTeamBadge` | string | URL |
+| `intHomeScore` | string | `"0"` |
+| `intAwayScore` | string | `"1"` |
+| `intEventScore` | null | |
+| `intEventScoreTotal` | null | |
+| `strStatus` | string | `"FT"` / `"1H"` / `"2H"` / `"HT"` |
+| `strProgress` | string | `"90"` |
+| `strEventTime` | string | `"00:30"` |
+| `dateEvent` | string | `"2026-03-10"` |
+| `updated` | string | `"2026-03-10 02:22:23"` |
+
+---
+
+## V1 Endpoints (Supplementary)
+
+See [sportsdb_api_v1_reference.md](sportsdb_api_v1_reference.md) for full V1
+validated fields. Key V1-only endpoints:
+
+| Endpoint | Wrapper Key | Purpose |
+|----------|-------------|---------|
+| `/lookuptable.php?l=&s=` | `table` | League standings |
+| `/eventsday.php?d=&s=` | `events` | Events by date |
+| `/eventslast.php?id=` | `results` | Team's last 5 results |
+| `/eventsnext.php?id=` | `events` | Team's next 5 fixtures |
+| `/searchteams.php?t=` | `teams` | Team search |
+| `/searchplayers.php?p=` | `player` | Player search |
+
+---
+
+## Important Notes
+
+1. **All numeric values are strings** — always cast with `int()` or handle `None`
+2. **All IDs are strings** — e.g. `"134148"` not `134148`
+3. **`strComment` can be literal `"NULL"`** — not JSON null
+4. **`strHome`/`strSubstitute` are `"Yes"`/`"No"`** — not booleans
+5. **Wrapper keys differ by endpoint** — `search`, `lookup`, `list`, `schedule`, `livescore`, `table`
+6. **Not all matches have stats/lineup/timeline** — smaller leagues return `{"Message": "No data found"}`
+7. **League search is unreliable on V2** — use V1 team search to discover league IDs
+
+## Verified IDs
+
+| Entity | Name | TheSportsDB ID |
+|--------|------|----------------|
+| League | American Major League Soccer | 4346 |
+| League | English Premier League | 4328 |
+| Team | Toronto FC | 134148 |
+| Team | Arsenal | 133604 |