ilostat R package

The ILO’s main online database, ILOSTAT, maintained by the Department of Statistics, is the world’s largest repository of labour market statistics. It covers all countries and regions and a wide range of labour-related topics, including employment, unemployment, wages, working time and labour productivity, to name a few. It includes time series going back as far as 1938; annual, quarterly and monthly labour statistics; country-level, regional and global estimates; and even projections of the main labour market indicators.

ILOSTAT’s website provides immediate access to all its data and related metadata through different ways. Basic users can simply view the desired data online or download it in Excel or csv formats. More advanced users can take advantage of ILOSTAT’s well-structured bulk download facility.

The ilostat R package ('Rilostat') was designed to give data users the ability to access the ILOSTAT database, search for data, rearrange the information as needed, download it in the desired format, and make various data visualizations, all in a programmatic and replicable manner, with the possibility of quickly re-running the queries as required.

Main features of the ilostat R package

Provides access to all annual, quarterly, and monthly data available via the ILOSTAT bulk download facility
Allows to search for and download data and related metadata in English, French and Spanish
Gives the ability to return POSIXct dates for easy integration into plotting and time-series analysis techniques
Returns data in long format for direct integration with packages like ggplot2 and dplyr
Gives immediate access to the most recent updates
Allows for grep-style searching for data descriptions and names

Acknowledgements

The developer of this package drew extensive inspiration from the eurostat R package and its related documentation:\

Retrieval and Analysis of Eurostat Open Data with the eurostat Package - Leo Lahti, Przemyslaw Biecek, Markus Kainu and Janne Huovari. R Journal 9(1), 385-392, 2017.

Installation

Download and install R from CRAN, install RStudio’s IDE, a powerful user interface for R. Then use command:

install.packages("Rilostat")

To install the development version, use the following command:

if(!require(devtools)){install.packages('devtools')}
# install_github("ilostat/Rilostat")
install.packages("Rilostat", repos = c('https://ilostat.r-universe.dev', 'https://cloud.r-project.org'))

We do not expect to update the ilostat R package too often, but based on questions and remarks from ILOSTAT data users, we will progressively create more examples, tutorials, demos and apps. We will publicly share all of this via Rilostat webpage

Contribute

Contributions are very welcome:

Use issue tracker for feedback and bug reports.
Star us on the github page

Software license

Rilostat is distributed under the BSD 2-Clause License.

ILOSTAT data licensing

ILOSTAT databases and datasets, together with their accompanying referential metadata, published by the International Labour Organization (ILO) as of 3 May 2023 are licensed under the Creative Commons Attribution 4.0 International License (CC BY 4.0), unless otherwise indicated.

Users may reuse, share and adapt this material in accordance with the terms of the licence and must give appropriate credit to the International Labour Organization (ILO) as the source.

The licensing of ILOSTAT data and metadata is separate from the BSD 2-Clause License applying to the Rilostat R package.

For full information on ILO copyright, data licensing, third-party material and other rights and permissions, see the ILO Rights and permissions page.