TheScore API Wrapper

A comprehensive asynchronous Python wrapper for TheScore sports API, providing easy access to sports data including players, teams, matches, competitions, and more.

Features

• Full API Coverage: Access to all TheScore API endpoints

• Async/Await Support: Built on aiohttp for high performance

• Type Annotations: Full type hint support for better development experience

• Error Handling: Robust error handling and connection management

• Flexible Search: Advanced search capabilities with competition ID inclusion

Installation

pip install thescore-wrapper

Example usage

import asyncio
from thescore import TheScore

async def main():
    async with TheScore() as ts:
        # Search for players
        players = await ts.search_players("LeBron", include_competition_id=True)
        print(f"Found {len(players)} players")
        
        # Get team information
        team = await ts.get_team("nba", 13)  # Miami Heat
        print(team.get("full_name"))
        
        # Get today's games
        from datetime import date
        games = await ts.get_games_by_date(date.today())
        print(f"Games today: {len(games)}")

asyncio.run(main())

Complete API Reference

Search Endpoints

Club Endpoints

Player Endpoints

Competition Endpoints

Match Endpoints

Sport-Specific Endpoints