Elite Schedule is an open source football API providing historical results & odds to help football enthusiasts analyse many years of data quickly and efficiently to gain an edge over the bookmaker. Whilst other football results and odds databases do exist, Elite Schedule is unique in making available computer-ready data by accessing data in JSON format for quantitative analysis. Elite Schedule collects data from Football-Data organizes it and data is available through accesing it's end points.

Alternatively, if you are just looking for the latest results, tables and team stats, try Football-Data's livescore service, with minute-by-minute scores as the goals go in.

Currently Elite Schedule API supports matches from England,Spain,Germany and Italy but there is accommodation to enhance the API to have matches from other countries.

• Getting Started
• Dependencies
• Tests
• API Endpoints
• Responses
• Error handling
• Versions
• Request & Response Examples
• Contributing
• Swagger/Redoc Documentation

1. User authentication with JWT.
2. API will seed data to DB from csv files when you run python manage.py import_matches_from_csv
3. Redoc and Swagger documentation for easier integration

1. git clone https://github.com/pmutua/elite_schedule.git
2. cd elite_schedule
3. virtualenv -p python env
4. source env/bin/activate
5. cd src
6. pip install -r requirements/base.txt
7. .manage.py runserver

python manage.py runserver --settings=core.settings.base

The above will get you a copy of the project up and running on your local machine for development and testing purposes.

1. Python 3 +
2. Pip
3. Virtualenv
4. PostgreSQL

View all the other dependencies

All endpoints except signup/ require a token for authentication. The API call should have the token in Authorization header.

http https://elite-schedule.herokuapp.com/api/elite_schedule/matches/ \
Authorization: "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJleHAiOjE0Njc2MTkxNDV9.R6VLZD4qtsdVHXZwU8bEo6S16cbNQfo7lICsNdAq00I"

The API responds with JSON data by default.

The API responds with an error message and http status code whenenever it encounters an error.

{
  "error": "Not Found",
  "status": "404"
}

Request GET /elite_schedule/team/search/?q=Juventus

curl -H "Authorization: JWT <your_token>" -H "Content-Type: application/json" https://elite-schedule.herokuapp.com/api/elite_schedule/team/search/?q=swansea

Returns json data about a single team,this will list all games a team has played both home or way.

1. The API only responds with JSON

1. Fork it! 🍴
2. Create your feature branch: git checkout -b my-new-feature
3. Commit your changes: git add -A && git commit -m 'Add some feature'
4. Push to the branch: git push origin my-new-feature 🚀
5. Submit a pull request 😎

This project is licensed under the MIT License - see the LICENSE.md file for details