Use Cases & Examples

import requests

def get_forge_home_wins_2024():
    """Find all Forge FC home wins in the 2024 season."""
    url = "https://canadasoccerapi.com/api/matches"
    params = {"season": 2024, "team": "Forge", "limit": 500}

    response = requests.get(url, params=params)
    data = response.json()

    # Filter for home wins
    home_wins = [
        match for match in data["matches"]
        if match["home_team"] == "Forge FC"
        and match["home_goals"] > match["away_goals"]
    ]

    print(f"Forge FC Home Wins in 2024: {len(home_wins)}")
    for match in home_wins:
        print(f"  {match['date']}: Forge FC {match['home_goals']} - "
              f"{match['away_goals']} {match['away_team']}")

    return home_wins

# Execute
wins = get_forge_home_wins_2024()

import requests

def head_to_head(team1: str, team2: str):
    """Calculate head-to-head record between two teams."""
    url = "https://canadasoccerapi.com/api/matches"
    response = requests.get(url, params={"team": team1, "limit": 500})
    matches = response.json()["matches"]

    # Filter to matches between the two teams
    h2h_matches = [
        m for m in matches
        if (team1.lower() in m["home_team"].lower() or team1.lower() in m["away_team"].lower())
        and (team2.lower() in m["home_team"].lower() or team2.lower() in m["away_team"].lower())
    ]

    team1_wins, team2_wins, draws = 0, 0, 0

    for match in h2h_matches:
        is_team1_home = team1.lower() in match["home_team"].lower()
        team1_goals = match["home_goals"] if is_team1_home else match["away_goals"]
        team2_goals = match["away_goals"] if is_team1_home else match["home_goals"]

        if team1_goals > team2_goals:
            team1_wins += 1
        elif team2_goals > team1_goals:
            team2_wins += 1
        else:
            draws += 1

    print(f"\n=== {team1} vs {team2} Head-to-Head ===")
    print(f"Total matches: {len(h2h_matches)}")
    print(f"{team1} wins: {team1_wins}")
    print(f"{team2} wins: {team2_wins}")
    print(f"Draws: {draws}")

    return {"team1_wins": team1_wins, "team2_wins": team2_wins, "draws": draws}

# Execute
head_to_head("Forge", "Cavalry")

import requests

def goal_difference_trends(team_name: str):
    """Track a team's goal difference across all seasons."""
    url = "https://canadasoccerapi.com/api/standings"
    response = requests.get(url)
    data = response.json()

    print(f"\n=== {team_name} Goal Difference Trend ===\n")
    print(f"{'Season':<8} {'GF':<5} {'GA':<5} {'GD':<6} {'Position'}")
    print("-" * 35)

    for season in sorted(data["seasons"]):
        standings = data["standings"][str(season)]
        team_data = next(
            (t for t in standings if team_name.lower() in t["team"].lower()),
            None
        )
        if team_data:
            gd = team_data['goal_difference']
            gd_str = f"+{gd}" if gd > 0 else str(gd)
            print(f"{season:<8} {team_data['goals_for']:<5} "
                  f"{team_data['goals_against']:<5} "
                  f"{gd_str:<6} #{team_data['position']}")

# Execute
goal_difference_trends("Forge")

import requests
import json

def map_team_locations():
    """Generate GeoJSON for mapping CPL team locations."""
    url = "https://canadasoccerapi.com/api/teams?active_only=true"
    response = requests.get(url)
    data = response.json()

    # Generate GeoJSON
    geojson = {
        "type": "FeatureCollection",
        "features": []
    }

    for team in data["teams"]:
        if team.get("latitude") and team.get("longitude"):
            feature = {
                "type": "Feature",
                "geometry": {
                    "type": "Point",
                    "coordinates": [team["longitude"], team["latitude"]]
                },
                "properties": {
                    "name": team["name"],
                    "city": team["city"],
                    "stadium": team["stadium"],
                    "surface": team["surface"]
                }
            }
            geojson["features"].append(feature)

    print(f"Generated GeoJSON with {len(geojson['features'])} team locations")

    # Save to file for use with Leaflet/Mapbox
    with open("cpl_teams.geojson", "w") as f:
        json.dump(geojson, f, indent=2)

    return geojson

map_team_locations()