{"id":34035713,"url":"https://github.com/n-eq/kooora-unofficial-api","last_synced_at":"2026-04-08T15:32:28.064Z","repository":{"id":46111573,"uuid":"87637876","full_name":"n-eq/kooora-unofficial-api","owner":"n-eq","description":"⚽️ kooora.com unofficial API","archived":false,"fork":false,"pushed_at":"2023-10-25T13:50:20.000Z","size":37,"stargazers_count":22,"open_issues_count":3,"forks_count":9,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-09-25T12:42:05.157Z","etag":null,"topics":["api","football-api","kooora","kooora-api","league","sports-api"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/n-eq.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-04-08T14:01:05.000Z","updated_at":"2025-09-02T16:04:06.000Z","dependencies_parsed_at":"2023-10-25T15:06:15.008Z","dependency_job_id":null,"html_url":"https://github.com/n-eq/kooora-unofficial-api","commit_stats":{"total_commits":27,"total_committers":3,"mean_commits":9.0,"dds":"0.14814814814814814","last_synced_commit":"b6669da56daec499b35989e7d7ecc8378d7ee2d6"},"previous_names":["marrakchino/kooora-unofficial-api"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/n-eq/kooora-unofficial-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/n-eq%2Fkooora-unofficial-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/n-eq%2Fkooora-unofficial-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/n-eq%2Fkooora-unofficial-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/n-eq%2Fkooora-unofficial-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/n-eq","download_url":"https://codeload.github.com/n-eq/kooora-unofficial-api/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/n-eq%2Fkooora-unofficial-api/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31562688,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T14:31:17.711Z","status":"ssl_error","status_checked_at":"2026-04-08T14:31:17.202Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","football-api","kooora","kooora-api","league","sports-api"],"created_at":"2025-12-13T20:03:28.878Z","updated_at":"2026-04-08T15:32:28.055Z","avatar_url":"https://github.com/n-eq.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# kooora-unofficial-api\n[![PyPi Version](https://img.shields.io/pypi/v/kooora.svg?style=flat-square)](https://pypi.org/project/kooora)\n[![PyPI pyversions](https://img.shields.io/pypi/pyversions/kooora.svg?style=flat-square)](https://pypi.org/project/kooora/)\n[![Downloads](https://pepy.tech/badge/kooora/month?style=flat-square)](https://pepy.tech/project/kooora)\n![Upload Python Package](https://github.com/marrakchino/kooora-unofficial-api/workflows/Upload%20Python%20Package/badge.svg)\n\n[Kooora](kooora.com) unofficial Python API.\n\n## Installation\n`pip3 install kooora`\n\n## Current features\n* Search by keyword (leagues, teams, players)\n* Fetch matches by\n    * Date\n    * League\n    * Team\n* Fetch match info\n    * General information\n    * Stats (played matches)\n* Fetch team info\n* Fetch league info   \n    * League table\n    * Scorers\n\n## Examples\n\nBelow are some basic examples to use the library:\n\n### Initialize Kooora class\n```python\nfrom kooora.kooora import *\napi = Kooora()\n```\n\n### Get the names of the leagues being played today\n```python\ntoday_matches = api.get_today_matches()\n# today_matches is a dict which keys are league ID numbers, let's extract the IDs\n*today_matches_ids, = today_matches\nfor id in today_matches_ids[]:\n    print(League.from_id(id).get_title())\n```\n\n### Get matches being played today in a given league (example with spanish liga)\n```python\nfor match in today_matches[22393]:\n    print(match)\n```\n\n### Fetch stats for a given match\n```python\nyesterday = api.get_yesterday_matches()[22495].get_stats()\n```\n\n### Initialize a League variable by ID and fetch its ranking and top scorers\n```python\nliga = League.from_id(22393) # you can also use api.search\nliga_table = liga.get_table()\ntop_scorers = liga.get_top_scorers()\n```\n\n### Find a team by its name and fetch its next match\n```python\neibar = None\nfor t in liga.get_teams():\n    if t.get_name() == \"إيبار\":\n        eibar = t\n        break\n```\n\n## Contributing\nThe project is still at a very early stage.\nSee https://github.com/marrakchino/kooora-unofficial-api/projects/1 for a list \nof ideas or kindly open an issue to raise a bug or submit a feature request.\n\n## Idea \nI've been fiddling with Kooora's website for years trying to understand\nthe multiple aspects of the data they provide and had the idea of creating a public\nAPI of it knocking around my head since at least 2017. The initial version of this\nunofficial API was made possible by reverse-engineering Kooora's official Android\napplication both by reversing the code and by sniffing the network requests.\n\n## License: MIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fn-eq%2Fkooora-unofficial-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fn-eq%2Fkooora-unofficial-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fn-eq%2Fkooora-unofficial-api/lists"}