{"id":16317038,"url":"https://github.com/simatwa/livescore-api","last_synced_at":"2025-03-27T02:25:01.001Z","repository":{"id":174668781,"uuid":"652586223","full_name":"Simatwa/livescore-api","owner":"Simatwa","description":"Access and manipulate soccer data from livescore.com","archived":false,"fork":false,"pushed_at":"2024-06-04T20:59:58.000Z","size":79,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-03T18:03:06.660Z","etag":null,"topics":["football-api","football-data","livescore","livescore-api","livescore-cli","soccer"],"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/Simatwa.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}},"created_at":"2023-06-12T11:28:24.000Z","updated_at":"2024-06-04T21:05:33.000Z","dependencies_parsed_at":null,"dependency_job_id":"29d16864-78fb-420b-b6f2-64d052aa7aac","html_url":"https://github.com/Simatwa/livescore-api","commit_stats":{"total_commits":37,"total_committers":1,"mean_commits":37.0,"dds":0.0,"last_synced_commit":"caae6e3be7698611e8001d2654d6a618983cb538"},"previous_names":["simatwa/livescore-api"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Simatwa%2Flivescore-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Simatwa%2Flivescore-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Simatwa%2Flivescore-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Simatwa%2Flivescore-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Simatwa","download_url":"https://codeload.github.com/Simatwa/livescore-api/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245768151,"owners_count":20668971,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["football-api","football-data","livescore","livescore-api","livescore-cli","soccer"],"created_at":"2024-10-10T22:06:25.940Z","updated_at":"2025-03-27T02:25:00.981Z","avatar_url":"https://github.com/Simatwa.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Livescore-api\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://github.com/Simatwa/livescore-api/actions/workflows/python-test.yml\"\u003e\u003cimg src=\"https://github.com/Simatwa/livescore-api/actions/workflows/python-test.yml/badge.svg\" alt=\"Python Test\"/\u003e\u003c/a\u003e\n\u003ca href=\"LICENSE\"\u003e\u003cimg alt=\"License\" src=\"https://img.shields.io/static/v1?logo=GPL\u0026color=Blue\u0026message=MIT\u0026label=License\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://pypi.org/project/livescore-api\"\u003e\u003cimg alt=\"PyPi\" src=\"https://img.shields.io/static/v1?logo=pypi\u0026label=Pypi\u0026message=v0.0.4\u0026color=green\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/psf/black\"\u003e\u003cimg alt=\"Black\" src=\"https://img.shields.io/static/v1?logo=Black\u0026label=Code-style\u0026message=Black\"/\u003e\u003c/a\u003e\n\u003ca href=\"#\"\u003e\u003cimg alt=\"Passing\" src=\"https://img.shields.io/static/v1?logo=Docs\u0026label=Docs\u0026message=Passing\u0026color=green\"/\u003e\u003c/a\u003e\n\u003ca href=\"#\"\u003e\u003cimg alt=\"coverage\" src=\"https://img.shields.io/static/v1?logo=Coverage\u0026label=Coverage\u0026message=60%\u0026color=yellowgreen\"/\u003e\u003c/a\u003e\n\u003ca href=\"#\" alt=\"progress\"\u003e\u003cimg alt=\"Progress\" src=\"https://img.shields.io/static/v1?logo=Progress\u0026label=Progress\u0026message=95%\u0026color=green\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://pepy.tech/project/livescore-api\"\u003e\u003cimg src=\"https://static.pepy.tech/personalized-badge/livescore-api?period=total\u0026units=international_system\u0026left_color=grey\u0026right_color=orange\u0026left_text=Downloads\" alt=\"Downloads\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n**Access and manipulate football data from [Livescore](https://livescore.com).**\n\n## Installation\n\n1. From pip\n\n```sh\npip install livescore-api\n```\n\n2. From source\n\n- Clone repo and install\n\n```sh\ngit clone https://github.com/Simatwa/livescore-api.git\ncd livescore-api\npip install .\n```\n\n## Usage\n\n- `$ livescore-api`\n\n\u003cdetails\u003e\n\u003csummary\u003e\n\n### Developer docs\n\n\u003c/summary\u003e\n\n1. Retrieving data offline\n\n```py\nfrom livescore_api import json_formatter\nraw_matches = open(\"matches.json\").read()\nsorted_matches = json_formatter(raw_matches)\nprint(sorted_matches(max=1))\n\n\"\"\"\nOutput\n[\n{\n    \"Serial Id\": \"12413\",\n    \"League\": \"Primera Division\",\n    \"Country\": \"Argentina\",\n    \"Match Id\": \"866073\",\n    \"H Scores\": \"1\",\n    \"A Scores\": \"4\",\n    \"Kickoff\": 20230613011500,\n    \"Status\": \"FT\",\n    \"Home\": \"Banfield\",\n    \"H id\": \"5252\",\n    \"Away\": \"River Plate\",\n    \"A id\": \"4802\"\n}\n]\n\"\"\"\n```\n\n2. Retrieving data online\n\n```py\nfrom livescore_api import livescore\n\nmatches = livescore()\nprint(matches(max=1))\n\n\"\"\"\nOutput\n\n[\n{\n    \"Serial Id\": \"12413\",\n    \"League\": \"Primera Division\",\n    \"Country\": \"Argentina\",\n    \"Match Id\": \"866073\",\n    \"H Scores\": \"1\",\n    \"A Scores\": \"4\",\n    \"Kickoff\": 20230613011500,\n    \"Status\": \"FT\",\n    \"Home\": \"Banfield\",\n    \"H id\": \"5252\",\n    \"Away\": \"River Plate\",\n    \"A id\": \"4802\"\n}\n]\n\"\"\"\n```\n\n3. Making predictions\n\n```py\nfrom livescore_api import Make\nmatches = [{\"Home\":\"Arsenal\", \"Away\":\"Liverpool\"}]\nbet = Make(matches)\nprint(bet())\n\n\"\"\"\nOutput\n\n[{'Home': 'Arsenal', 'Away': 'Liverpool', 'g': 10.0, 'gg': 55.0, 'ov15': 60.0, 'ov25': 45.0, 'ov35': 25.0, 'choice': 62.5, 'result': '2', 'pick': '2'}]\n\"\"\"\n\n```\n\u003c/details\u003e\n\n\u003c/summary\u003e\n\n\u003cdetails\u003e\n\n\u003csummary\u003e\n\nFor more info run `$ livescore-api -h`\n\n\u003c/summary\u003e\n\n```\nusage: livescore-api [-h] [-v] [-m MONTH] [-y YEAR] [-c COUNTRY]\n                     [-l LEAGUE] [-n NAME] [-s STATUS] [-M MAX]\n                     [-H HEADERS] [-o PATH]\n                     [-f html|csv|xlsx|markdown|xml|json] [-i PATH]\n                     [-t html|pretty|grid|fancy_grid|orgtbl|secure_html]\n                     [-D CODE] [-E TIMEOUT] [-I INDENT] [-C PATH]\n                     [--update] [--raw] [--predict] [-U USERNAME]\n                     [-P PASSWORD] [-S SERVER] [-T LIMIT] [--offline]\n                     [--REST] [--include-position]\n                     [date]\n\nAccess and manipulate matches from Livescore.com\n\npositional arguments:\n  date                  Date of the matches - 13\n\noptions:\n  -h, --help            show this help message and exit\n  -v, --version         show program's version number and exit\n  -m MONTH, --month MONTH\n                        Month of the matches - 6\n  -y YEAR, --year YEAR  Year of the matches - 2023\n  -c COUNTRY, --country COUNTRY\n                        Return matches from the specified countries only\n                        - None\n  -l LEAGUE, --league LEAGUE\n                        Return matches of the specified league(s) only -\n                        None\n  -n NAME, --name NAME  Return matches with the specified team-name only\n                        - None\n  -s STATUS, --status STATUS\n                        Return matches of the specified status - None\n  -M MAX, --max MAX     Maximum matches to be returned - 1000\n  -H HEADERS, --headers HEADERS\n                        Path to .json file containing http headers - None\n  -o PATH, --output PATH\n                        Path to save the content - None\n  -f html|csv|xlsx|markdown|xml|json, --format html|csv|xlsx|markdown|xml|json\n                        Contents output format - json\n  -i PATH, --input PATH\n                        Use .json formatted file in path - None\n  -t html|pretty|grid|fancy_grid|orgtbl|secure_html, --tabulate html|pretty|grid|fancy_grid|orgtbl|secure_html\n                        Tabulate the contents using style specified -\n                        None\n  -D CODE, --code CODE  Country code for making http request - KE\n  -E TIMEOUT, --timeout TIMEOUT\n                        Http request timeout - 20s\n  -I INDENT, --indent INDENT\n                        Indentation level for formatting .json output - 4\n  -C PATH, --config PATH\n                        Use mapper-keys in path - None\n  --update              Update mapper-keys from repo - False\n  --raw                 Return contents with zero manipulation - False\n  --predict             Proceed to make predictions - False\n  -U USERNAME, --username USERNAME\n                        Username for the REST api - API\n  -P PASSWORD, --password PASSWORD\n                        Passkey for the REST api - developer\n  -S SERVER, --server SERVER\n                        Url pointing to REST api - http://localhost:8000\n  -T LIMIT, --limit LIMIT\n                        Limit number of matches for prediction - 1000\n  --offline             Make predictions based on data available offline\n                        - False\n  --REST                Specifies to make predictions using REST api -\n                        False\n  --include-position    Include team-league rank in making predictions -\n                        False\n\nThis script has no official relation with Livescore.com\n```\n\u003c/details\u003e\n\n## Disclaimer\n\nThis script utilizes the Livescore API to provide live scores and other information about sporting events. The Livescore-API is a third-party service and is not affiliated with any specific sporting event or organization. The accuracy of the information provided by the Livescore API is not guaranteed and may vary depending on a number of factors, including the availability of data and the quality of the data. The user of this script assumes all responsibility for any  legal action, errors or omissions in the information provided by the Livescore API.\n\n\u003cdetails\u003e\n\n\u003csummary\u003e\n\nAuthor\n\n\u003c/summary\u003e\n\nThe author of this script makes no representations or warranties, express or implied, about the accuracy, completeness, or suitability of the information provided by the Livescore API. The author of this script accepts no liability for any legal action,  errors or omissions in the information provided by the Livescore API.\n\n**Note** : This is just for information purposes do not sue me.\n\u003c/details\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimatwa%2Flivescore-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimatwa%2Flivescore-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimatwa%2Flivescore-api/lists"}