README

PHP library to extract COVID-19 statistical data from multiple sources

This library aims to be a quick way to extract statistical data for COVID-19 (Coronavirus disease 2019) from multiple sources on the Internet and provide this data in multiple formats (PHP Array, JSON, CSV etc.)

Disclaimer

This software is provided for educational and demonstration purposes only.

By using this software, you might access resources for which you need prior permission from their respective owners (e.g. Worldometers Coronavirus).

It is the sole responsibility of the user of this software to ensure proper permission is granted before using this software to access such resources.

License

This project is licensed under the terms of the MIT license.

Check the LICENSE.md file for license rights and limitations.

Installation

composer require ovidigital/covid-19-data-scraper

Usage

use OviDigital\Covid19DataScraper\StatisticsService;

$statisticsService = new StatisticsService();

// Scrape Worldometers aggregated statistics for all countries
$dataObject = $statisticsService->getWorldometersAggregated();

// Scrape Worldometers aggregated statistics for specific countries using alpha-2 country codes
$dataObject = $statisticsService->getWorldometersAggregated(['US', 'RO']);

// Scrape Worldometers country statistics for specific country (e.g. Romania)
$dataObject = $statisticsService->getWorldometersCountry('RO');

// Get data as PHP array
$dataAsArray = $dataObject->toArray();

// Get data in JSON format
$dataAsJson = $dataObject->toJson();

Returned Data

Depending on the source used to scrape the statistics, the data and schema might slightly differ.
The examples below display partial, dummy data.

Example Worldometers Aggregated Data

{
    "meta": {
        "timestamp": 1587914124
    },
    "countries": {
        "US": {
            "meta": {
                "country_code": "US",
                "country_name": "United States of America",
                "country_slug": "us"
            },
            "data": {
                "total_cases": 123456,
                "new_cases_today": 1337,
                "total_deaths": 45678,
                "new_deaths_today": 101,
                "total_recovered": 80000,
                "total_active_cases": 765432,
                "total_serious_critical": 13337,
                "total_tests": 4194304,
                "cases_per_million": 2121,
                "deaths_per_million": 196,
                "tests_per_million": 16384
            }
        },
        "RO": {
            "meta": {
                "country_code": "RO",
                "country_name": "Romania",
                "country_slug": "romania"
            },
            "data": {
                "total_cases": 10123,
                "new_cases_today": 321,
                "total_deaths": 500,
                "new_deaths_today": -5,
                "total_recovered": 2350,
                "total_active_cases": 7123,
                "total_serious_critical": 210,
                "total_tests": 112112,
                "cases_per_million": 543,
                "deaths_per_million": 25.15,
                "tests_per_million": 12345
            }
        }
    }
}

Example Worldometers Country Data

{
    "meta": {
        "timestamp": 1587901089,
        "country_code": "RO",
        "country_name": "Romania"
    },
    "data": {
        "totals": {
            "cases": 1500,
            "deaths": 60,
            "recovered": 120
        },
        "daily": {
            "new_cases": {
                "2020-02-15": "null",
                "2020-02-16": "null",
                "2020-02-17": 100,
                "2020-02-18": 200,
                "2020-02-19": 300,
                "2020-02-20": 400,
                "2020-02-21": 500
            },
            "new_deaths": {
                "2020-02-15": 0,
                "2020-02-16": 0,
                "2020-02-17": 0,
                "2020-02-18": 0,
                "2020-02-19": 10,
                "2020-02-20": 20,
                "2020-02-21": 30
            },
            "new_recovered": {
                "2020-02-15": 0,
                "2020-02-16": 0,
                "2020-02-17": 0,
                "2020-02-18": 0,
                "2020-02-19": 20,
                "2020-02-20": 40,
                "2020-02-21": 60
            },
            "total_active_cases": {
                "2020-02-15": "null",
                "2020-02-16": "null",
                "2020-02-17": 100,
                "2020-02-18": 300,
                "2020-02-19": 570,
                "2020-02-20": 910,
                "2020-02-21": 1320
            },
            "total_deaths": {
                "2020-02-15": 0,
                "2020-02-16": 0,
                "2020-02-17": 0,
                "2020-02-18": 0,
                "2020-02-19": 10,
                "2020-02-20": 30,
                "2020-02-21": 60
            }
        }
    }
}

Contributing

Feel free to submit a pull request or create an issue.

ovidigital / covid-19-data-scraper

Maintainers

Details