rdb_by_api_link: Download DBnomics data using API link.

Description

rdb_by_api_link downloads data series from DBnomics.

Usage

rdb_by_api_link(api_link,
  use_readLines = getOption("rdbnomics.use_readLines"))

Arguments

api_link

Character string. DBnomics API link of the search.

use_readLines

Logical (default FALSE). If TRUE, then the data are requested and read with the base function readLines. This can be used to get round the error Could not resolve host: api.db.nomics.world.

Value

A data.frame.

Details

This function gives you access to hundreds of millions data series from DBnomics API (documentation about the API can be found here). The API link is given on the DBnomics website.

Examples

Run this code

# NOT RUN {
# Fetch two series from different datasets of different providers:
df1 <- rdb_by_api_link(
  paste0(
    'https://api.db.nomics.world/',
    'series?series_ids=AMECO/ZUTN/EA19.1.0.0.0.ZUTN,IMF/CPI/A.AT.PCPIT_IX'
  )
)

# Fetch one series from dataset 'Doing Business' of WB provider:
df2 <- rdb_by_api_link(
  paste0(
    'https://api.db.nomics.world/v21/',
    'series?dimensions=%7B%22country%22%3A%5B%22FR%22%2C%22IT%22%2C%22ES%22%5D%2C%22',
    'indicator%22%3A%5B%22IC.REG.PROC.FE.NO%22%5D%7D&provider_code=WB&dataset_code=DB&format=json'
  )
)

# Use readLines before fromJSON to avoid a proxy failure
# Fetch one series from dataset 'Unemployment rate' (ZUTN) of AMECO provider:
options(rdbnomics.use_readLines = TRUE)
df2 <- rdb_by_api_link(
  paste0(
    'https://api.db.nomics.world/v21/',
    'series?dimensions=%7B%22country%22%3A%5B%22FR%22%2C%22IT%22%2C%22ES%22%5D%2C%22',
    'indicator%22%3A%5B%22IC.REG.PROC.FE.NO%22%5D%7D&provider_code=WB&dataset_code=DB&format=json'
  )
)
# or
df2 <- rdb_by_api_link(
  paste0(
    'https://api.db.nomics.world/v21/',
    'series?dimensions=%7B%22country%22%3A%5B%22FR%22%2C%22IT%22%2C%22ES%22%5D%2C%22',
    'indicator%22%3A%5B%22IC.REG.PROC.FE.NO%22%5D%7D&provider_code=WB&dataset_code=DB&format=json'
  ),
  use_readLines = TRUE
)
# }