Title:	'Kaggle' Dataset Downloader 'API'
Version:	0.1.1
Description:	Easily download datasets from Kaggle https://www.kaggle.com/ directly into your R environment using 'RKaggle'. Streamline your data analysis workflows by importing datasets effortlessly and focusing on insights rather than manual data handling. Perfect for data enthusiasts and professionals looking to integrate Kaggle datasets into their R projects with minimal hassle.
License:	MIT + file LICENSE
URL:	https://github.com/benyamindsmith/RKaggle
BugReports:	https://github.com/benyamindsmith/RKaggle/issues
Encoding:	UTF-8
Imports:	httr, readr, withr, jsonlite, arrow, readODS, readxl, sf
Depends:	R (≥ 4.1.0)
Suggests:	tibble, conflicted
RoxygenNote:	7.3.2
NeedsCompilation:	no
Packaged:	2025-05-09 03:42:44 UTC; ben29
Author:	Benjamin Smith [aut, cre]
Maintainer:	Benjamin Smith <benyamin.smith@mail.utoronto.ca>
Repository:	CRAN
Date/Publication:	2025-05-09 04:00:02 UTC

Download and Read a Dataset from Kaggle

Description

This function retrieves a dataset from Kaggle by downloading its metadata and associated ZIP file and then reads all supported files contained in its archive. Each supported file is loaded into appropriate function (see details for more information about this). The function returns a single data frame if there is only one file detected and an unnamed list of data frames otherwise. This function is only capable of pulling data from Kaggle Datasets and not competitions.

Usage

get_dataset(dataset)

Arguments

Details

The function constructs the metadata URL based on the provided dataset identifier, then sends a GET request using the httr package. If the request is successful, the returned JSON metadata is parsed. The function searches the metadata for a file with an encoding format of "application/zip", then downloads that ZIP file using a temporary file (managed by the withr package). After unzipping the file into a temporary directory, the function locates all files with extensions corresponding to popular dataset formats (csv, tsv, xlsx, json, rds, parquet, ods, shp, geojson and feather). Each file is then read using the appropriate function:

• readr::read_csv for CSV files.

• readr::read_tsv for TSV files.

• readxl::read_excel for xlsx files.

• jsonlite::fromJSON for JSON files.

• readRDS for RDS files.

• arrow::read_parquet for Parquet files.

• readODS::read_ods for ODS files

• sf::read_sf for SHP and GEOJSON files.

• arrow::read_feather for Feather files.

The function stops with an error if any of the following occur:

• The HTTP request fails.

• No ZIP file URL is found in the metadata.

• No supported data files are found in the unzipped contents.

Value

An unnamed list of dataframes corresponding to the files that were able to be read by get_data(). If only one file is able to be read, a individual dataframe is returned.

Examples

  # Download and read the "canadian-prime-ministers" dataset from Kaggle
  canadian_prime_ministers <- get_dataset("benjaminsmith/canadian-prime-ministers")
  canadian_prime_ministers
  
  # csv 
  canadian_prime_ministers <- get_dataset("benjaminsmith/canadian-prime-ministers")
  # tsv 
  arabic_twitter <- get_dataset("mksaad/arabic-sentiment-twitter-corpus")
  # xlsx
  hr_data <- get_dataset("kmldas/hr-employee-data-descriptive-analytics")
  # json
  iris_json <- get_dataset("rtatman/iris-dataset-json-version")
  # rds
  br_pop_2019<-get_dataset("ianfukushima/br-pop-2019")
  # parquet
  iris_datasets<-get_dataset("gpreda/iris-dataset")
  #ods
  new_houses <- get_dataset("nm8883/new-houses-built-each-year-in-england")
  #shp
  india_states <- get_dataset("dhruvanurag20/final-shp")
  #geojson
  montreal <- get_dataset("rinichristy/montreal-geojson")
  #feather
  ncaa <- get_dataset("corochann/ncaa-march-madness-2020-womens")