https://github.com/mikesmitheu/apisports

Python library for querying API-Sports.io
https://github.com/mikesmitheu/apisports

api-client sports sports-data sports-stats

Last synced: 3 months ago
JSON representation

Python library for querying API-Sports.io

• Host: GitHub
• URL: https://github.com/mikesmitheu/apisports
• Owner: MikeSmithEU
• License: mit
• Created: 2021-06-06T17:10:14.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2021-06-14T18:29:51.000Z (over 4 years ago)
• Last Synced: 2025-07-22T13:42:16.993Z (3 months ago)
• Topics: api-client, sports, sports-data, sports-stats
• Language: Python
• Homepage: https://apisports.readthedocs.io/
• Size: 148 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

          
ApiSports

---------

.. image:: https://img.shields.io/github/license/MikeSmithEU/apisports.svg

    :alt: License (MIT)

    :target: https://github.com/MikeSmithEU/apisports/blob/main/LICENSE

.. image:: https://img.shields.io/github/workflow/status/MikeSmithEU/apisports/Python%20package

    :alt: GitHub Workflow Status (branch)

    :target: https://github.com/MikeSmithEU/apisports/actions

.. image:: https://coveralls.io/repos/github/MikeSmithEU/apisports/badge.svg

    :alt: Code Coverage

    :target: https://coveralls.io/github/MikeSmithEU/apisports

.. image:: https://readthedocs.org/projects/apisports/badge/?version=latest

    :alt: Documentation Status

    :target: https://apisports.readthedocs.io/

A simple python library for easy querying of APISports data.

Example usage

=============

.. code-block:: python3

    from apisports import Football

    api = Football(api_key='XXXXXXXX')

    # get all players for Chelsea FC (id=49) for the 2020 season

    # and sort by age

    players = api.players(season=2020, team=49)

    if not players.ok:

        print("something went wrong: " + players.error_description)

    else:

        sorted_by_age = sorted(players, key=lambda player : player['player']['age'])

        def format_player(player):

            return "{firstname} {lastname}: {age}".format(

                firstname = player['player']['firstname'],

                lastname = player['player']['lastname'],

                age = player['player']['age']

            )

        for player in sorted_by_age:

            print(format_player(player))

outputs::

    Harvey Vale: 18

    Dynel Simeu: 19

    Myles Peart-Harris: 19

    Ian Maatsen: 19

    Valentino Livramento: 19

    Lewis Bate: 19

    Karlo Žiger: 20

    Henry Lawrence: 20

    Billy Gilmour: 20

    Faustino Anjorin: 20

    Armando Broja: 20

    Marc Guehi: 21

    Conor Gallagher: 21

    Tariq Lamptey: 21

    Juan Familia-Castillo: 21

    Ethan Ampadu: 21

    Callum Hudson-Odoi: 21

    Jamie Cumming: 22

    Luke McCormick: 22

    Kai Havertz: 22

    Mason Mount: 22

    Reece James: 22

    Christian Pulisic: 23

    Nathan Baxter: 23

    Isaiah Brown: 24

    Fikayo Tomori: 24

    Jake Clarke-Salter: 24

    Tammy Bakumo-Abraham: 24

    Ruben Loftus-Cheek: 25

    Robert Kenedy Nunes do Nascimento: 25

    Ben Chilwell: 25

    Timo Werner: 25

    Andreas Bødtker Christensen: 25

    Lewis Baker: 26

    Kepa Arrizabalaga Revuelta: 27

    Emerson Palmieri dos Santos: 27

    Mateo Kovačić: 27

    Kurt Happy Zouma: 27

    Ross Barkley: 28

    Hakim Ziyech: 28

    Antonio Rüdiger: 28

    Michy Batshuayi Tunga: 28

    Davide Zappacosta: 29

    Edouard Mendy: 29

    Jorge Luiz Frello Filho: 30

    N'Golo Kanté: 30

    Victor Moses: 31

    Marcos Alonso Mendoza: 31

    César Azpilicueta Tanco: 32

    Willian Borges da Silva: 33

    Pedro Eliezer Rodríguez Ledesma: 34

    Olivier Giroud: 35

    Thiago Emiliano da Silva: 37

    Wilfredo Daniel Caballero: 40