Player data

    Player stats APIseason lines, match lines, xG.

    Query any player's season aggregates or individual match stat lines, with expected goals, ratings, transfer history and national-team records — for football and 30+ other sports on a single API key.

    Built for models, not just scoreboards

    Discover the player, discover which seasons have data, then pull the stat line. Three calls, plain JSON, ready to join into a dataframe.

    • Season aggregates per competition
    • Per-match stat lines and ratings
    • Expected goals and expected assists
    • Transfer history and national-team records
    # 1. Find the player
    curl "https://api.sportsapipro.com/v2/football/api/search?q=haaland" \
      -H "x-api-key: $SPORTS_API_KEY"
    
    # 2. Discover which seasons have stats
    curl "https://api.sportsapipro.com/v2/football/api/players/839956/statistics/seasons" \
      -H "x-api-key: $SPORTS_API_KEY"
    
    # 3. Pull the season stat line
    curl "https://api.sportsapipro.com/v2/football/api/players/839956/tournament/17/season/61627/statistics" \
      -H "x-api-key: $SPORTS_API_KEY"

    Endpoints by data group

    Profile & attributes

    Name, position, nationality, height, preferred foot, market value, contract, and attribute overviews.

    • /v2/football/api/players/{playerId}
    • /v2/football/api/players/{playerId}/characteristics

    Season & career stats

    Per-competition season aggregates plus career totals: goals, assists, xG, xA, shots, key passes, duels, tackles, minutes and ratings.

    • /v2/football/api/players/{playerId}/statistics
    • /v2/football/api/players/{playerId}/tournament/{tid}/season/{sid}/statistics

    Match-by-match lines

    Individual match stat lines and game-by-game ratings, ideal for form models and player-level time series.

    • /v2/football/api/match/{matchId}/player/{playerId}/statistics
    • /v2/football/api/players/{playerId}/events/last/{page}

    Transfers & national team

    Full transfer history with fees where published, plus international appearances and national-team statistics.

    • /v2/football/api/players/{playerId}/transfer-history
    • /v2/football/api/players/{playerId}/national-team-statistics

    Player stats API FAQ

    Which player statistics are available?

    Goals, assists, expected goals and expected assists, shots and shots on target, key passes, pass accuracy, duels won, tackles, interceptions, saves for keepers, minutes played, cards, and per-match ratings — as season aggregates and as individual match lines.

    Does the player stats API cover other sports?

    Yes. The same key works across 30+ sports, including basketball, hockey, baseball, tennis and cricket, each with sport-appropriate stat sets. Football has the deepest coverage.

    How do I find a player ID?

    Never hardcode IDs. Use the search endpoint, or read them from match lineups and team squads. Then call the statistics/seasons endpoint to see which seasons actually have data for that player.

    Can I pull an entire league's player stats in bulk?

    Yes, by iterating team squads or the season top-players endpoint. Bulk backfills need quota headroom — the Mega plan or a temporary quota increase from support is the usual route.

    Get player data flowing today

    Start on the free key, upgrade when your quota needs it.