onefootball-wrapper - A OneFootball API Wrapper

A Python wrapper for the OneFootball API, providing easy access to football (soccer) data including players, clubs, competitions, transfers, and more.

Features

• Player Data: Transfers, injuries, profiles
• Club Data: Squads, stadiums, transfers
• Competition Data: Tables, participating clubs
• Search Functionality: Players, clubs, leagues

Installation

pip install onefootball-wrapper

Example usage

import asyncio
from onefootball import OneFootball

import json

async def main():
    async with OneFootball() as of:
        # Search for players
        results = await of.search("saka")
        print(json.dumps(results, indent = 4))
        
        # Get team information
        team = await of.get_team(2)  # Arsenal
        print(json.dumps(team, indent = 4))
        
        # Get today's matches
        matches = await of.get_today_matches()
        print(json.dumps(matches, indent = 4))

asyncio.run(main())

Complete API Reference

Search Endpoints

Team Endpoints

Competition Endpoints

Match Endpoints

Player Endpoints

Rate Limiting

Be mindful of rate limits when making multiple requests. Consider adding delays between requests if you're making many calls in succession.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License.

Tips and Tricks

• If a function requires a slug, You have to splice it from the returned URL, for example the player URL as the API does not directly provide that.