Overwatch JSON API
Switch branches/tags
Nothing to show
Clone or download



Donate to keep OWAPI alive

This server is a simple way to get read-only information about player statistics in the game Overwatch by Blizzard. A live version runs on https://owapi.net.

Game data

This API does not aim to expose data about the heroes, maps, etc in the game. For that, use https://github.com/jamesmcfadden/overwatch-api.

API Docs

OWAPI has a very simple RESTful API to get information.
As the API is read-only, the only method required is GET.

See the doc for more information.

Running an instance

OWAPI has a few requirements:

  • A Python version >3.5
  • Probably a Linux-based server; I don't know about the viability of running it on Windows.

Installation steps:

  1. Clone the repository.

    git clone https://github.com/SunDwarf/OWAPI.git

  2. Setup a Redis server.

    Redis should be running on the default port - 6379. You can override this in config.yml; however. Redis is used for caching lots of data so that there's not a 10 second delay on EVERY request as the data is fetched and scraped; it is essential.

    For Debian/Ubuntu, you can install one with: sudo apt install redis-server

    You can enable it with: sudo systemctl enable redis-server && sudo systemctl start redis-server.

  3. Install the requirements.

    For debian-based systems, run this first: sudo apt install libxslt-dev python3-dev build-essential zlib1g-dev pkg-config

    Install pipenv pip package: pip install pipenv

    To set up the virtualenv: pipenv install

  4. Copy and tweak the example config file.

    cp config.example.yml config.yml

  5. Start the OWAPI server.

    PYTHONPATH=. pipenv run asphalt run config.yml

    The server is now running on http://localhost:4444/

    Note: If you want the full speedups from Kyoukai you must run with uvloop enabled: PYTHONPATH=. pipenv run asphalt run -l uvloop config.yml