Banque de France’s API - api

Données - BDF

Auteur

François Geerolf

🇬🇧 English version

Info

Web

List of APIs

source dataset Title Updated
bdf api Banque de France's API - api 2026-09-09
bea api Bureau of Economic Analysis' API - api 2026-09-09
bis api Bank of International Settlements' API - api 2026-09-09
bls api Bureau of Labor Statistics' API - api 2026-09-08
dbnomics api DBnomics' API - api 2026-09-08
ecb api European Central Bank's API - api 2026-09-09
eurostat api Eurostat's API - api 2026-09-09
imf api International Monetary Fund's API - api 2026-09-08
insee api Institut National de la Statistique et des Etudes Economiques' API - api 2026-09-08
oecd api OECD's API - api 2026-08-02
wdi api World Development Indicators' API - api 2026-09-08

LAST_COMPILE

LAST_COMPILE
2026-09-09

Info

https://developer.webstat.banque-france.fr/product/7553/api/4304#/WEBSTATBanquedeFranceFRV1_100_4701/operation/%2Fv1%2Fdata%2F{datasetName}%2F{seriesKey}/get

https://api.webstat.banque-france.fr/webstat-fr/v1/data/REPLACE_DATASETNAME?format=json&detail=dataonly&startPeriod=REPLACE_THIS_VALUE&endPeriod=REPLACE_THIS_VALUE&lastNObservations=REPLACE_THIS_VALUE&firstNObservations=REPLACE_THIS_VALUE

https://api.webstat.banque-france.fr/webstat-fr/v1/data/REPLACE_DATASETNAME/REPLACE_SERIESKEY?format=json&detail=dataonly&startPeriod=REPLACE_THIS_VALUE&endPeriod=REPLACE_THIS_VALUE&lastNObservations=REPLACE_THIS_VALUE&firstNObservations=REPLACE_THIS_VALUE

Exemple: RPP

Datastructure

Code 
RPP_datastructure <- httr::GET(paste0(catalog_url, "/webstat-datasets/exports/json"),
                         query = list(where = 'dataset_id="RPP"'),
                         httr::add_headers(Authorization = paste("Apikey", api_key)),
                         httr::config(http_version = 1.1)) |>
  httr::content("text", encoding = "UTF-8") |>
  jsonlite::fromJSON(flatten = TRUE)

tibble(dimension = names(jsonlite::fromJSON(RPP_datastructure$dimensions_and_codelists[1])),
       codelist = unlist(jsonlite::fromJSON(RPP_datastructure$dimensions_and_codelists[1]))) |>
  print_table_conditional()
dimension codelist
FREQ CL_FREQ
REF_AREA CL_AREA_EE
ADJUSTMENT CL_ADJUSTMENT
RPP_DWELLING CL_RPP_DWELLING
RPP_GEO_COV CL_RPP_GEO_COV
RPP_SOURCE CL_RPP_SOURCE
RPP_SUFFIX CL_RPP_SUFFIX

Catalogue

Code 
RPP_catalogue <- httr::GET(catalog_url,
                     query = list(where = 'webstat_dataset_id="RPP"', limit = 100),
                     httr::add_headers(Authorization = paste("Apikey", api_key)),
                     httr::config(http_version = 1.1)) |>
  httr::content("text", encoding = "UTF-8") |>
  jsonlite::fromJSON(flatten = FALSE)

RPP_catalogue$results$metas$custom |>
  select(series_key, series_title_fr, series_freq, series_last_time_period_date) |>
  print_table_conditional()
series_key series_title_fr series_freq series_last_time_period_date
RPP.Q.FR.N.ED.00.1.00 Indice des prix des logements anciens - France métropolitaine - Ensemble - Base 100 en moyenne annuelle 2015 - Série brute Q 2026-03-31T00:00:00+00:00
RPP.Q.FR.N.NF.00.1.00 Prix au mètre carré des appartements neufs, France entière Q 2026-06-30T00:00:00+00:00
RPP.Q.FR.N.NF.CR.1.00 Prix au mètre carré des appartements neufs, Ile de France Q 2026-06-30T00:00:00+00:00
RPP.Q.FR.N.NH.00.1.00 Prix de vente moyen d'une maison neuve, France entière Q 2026-06-30T00:00:00+00:00
RPP.Q.FR.N.EF.CS.1.00 Indice des prix des logements anciens - Île-de-France : Petite couronne - Appartements - Base 100 en moyenne annuelle 2015 - Série brute Q 2026-03-31T00:00:00+00:00
RPP.Q.FR.N.EF.CC.1.00 Indice des prix des logements anciens - Paris - Appartements - Base 100 en moyenne annuelle 2015 - Série brute Q 2026-03-31T00:00:00+00:00
RPP.Q.FR.N.NH.CR.1.00 Prix de vente moyen d'une maison neuve, Ile de France Q 2026-06-30T00:00:00+00:00

Data

Code 
get_observations <- function(series_keys) {
  where_clause <- paste0("series_key='", series_keys, "'", collapse = " or ")
  httr::GET(export_url,
      query = list(select = "series_key,time_period_end,obs_value", where = where_clause),
      httr::add_headers(Authorization = paste("Apikey", api_key)),
      httr::config(http_version = 1.1)) |>
    httr::content("text", encoding = "UTF-8") |>
    jsonlite::fromJSON(flatten = TRUE) |>
    as_tibble() |>
    transmute(variable = series_key, date = as.Date(time_period_end), value = obs_value)
}

RPP_data2 <- get_observations("RPP.Q.FR.N.ED.00.1.00")

RPP_data2 |>
  print_table_conditional()
Code 
RPP_data3 <- get_observations(c("RPP.Q.FR.N.ED.00.1.00", "RPP.Q.FR.N.EF.CC.1.00")) |>
  left_join(RPP_catalogue$results$metas$custom |>
              select(variable = series_key, title = series_title_fr),
            by = "variable")

RPP_data3 |>
  print_table_conditional()

Example 1

All

Code 
RPP_data3 |>
  group_by(title) |>
  mutate(value = 100*value/value[date == min(date[date >= as.Date("2008-01-01")])]) |>
  ggplot() + geom_line(aes(x = date, y = value, color = title)) +
  theme_minimal()  + xlab("") + ylab("Indice des prix des logements anciens") +
  scale_x_date(breaks = as.Date(paste0(seq(1960, 2030, 2), "-01-01")),
               labels = date_format("%Y")) +
  theme(legend.position = c(0.4, 0.93),
        legend.title = element_blank()) +
  scale_y_log10(breaks = seq(0, 7000, 10))

2008-

Code 
RPP_data3 |>
  filter(date >= as.Date("2008-01-01")) |>
  group_by(title) |>
  mutate(value = 100*value/value[date == min(date[date >= as.Date("2008-01-01")])]) |>
  ggplot() + geom_line(aes(x = date, y = value, color = title)) +
  theme_minimal()  + xlab("") + ylab("Indice des prix des logements anciens") +
  scale_x_date(breaks = as.Date(paste0(seq(1960, 2030, 2), "-01-01")),
               labels = date_format("%Y")) +
  theme(legend.position = c(0.4, 0.93),
        legend.title = element_blank()) +
  scale_y_log10(breaks = seq(0, 7000, 10))

Datastructure

Information

  • Package rwebstat not maintained. html
  • Archived on 2023-04-07 for policy violation.

https://developer.webstat.banque-france.fr/node/295

Example

BSI1.M.FR.Y.R.A220Z.A.4.U6.2254FR.Z01.E

Catalogue

FM

Code 
httr::GET(catalog_url,
    query = list(where = 'webstat_dataset_id="FM"', limit = 100),
    httr::add_headers(Authorization = paste("Apikey", api_key)),
    httr::config(http_version = 1.1)) |>
  httr::content("text", encoding = "UTF-8") |>
  jsonlite::fromJSON(flatten = FALSE) |>
  pluck("results", "metas", "custom") |>
  select(series_key, series_title_fr, series_freq, series_last_time_period_date) |>
  print_table_conditional()

RPP

Code 
RPP_catalogue$results$metas$custom |>
  select(series_key, series_title_fr, series_freq, series_last_time_period_date) |>
  print_table_conditional()
series_key series_title_fr series_freq series_last_time_period_date
RPP.Q.FR.N.ED.00.1.00 Indice des prix des logements anciens - France métropolitaine - Ensemble - Base 100 en moyenne annuelle 2015 - Série brute Q 2026-03-31T00:00:00+00:00
RPP.Q.FR.N.NF.00.1.00 Prix au mètre carré des appartements neufs, France entière Q 2026-06-30T00:00:00+00:00
RPP.Q.FR.N.NF.CR.1.00 Prix au mètre carré des appartements neufs, Ile de France Q 2026-06-30T00:00:00+00:00
RPP.Q.FR.N.NH.00.1.00 Prix de vente moyen d'une maison neuve, France entière Q 2026-06-30T00:00:00+00:00
RPP.Q.FR.N.EF.CS.1.00 Indice des prix des logements anciens - Île-de-France : Petite couronne - Appartements - Base 100 en moyenne annuelle 2015 - Série brute Q 2026-03-31T00:00:00+00:00
RPP.Q.FR.N.EF.CC.1.00 Indice des prix des logements anciens - Paris - Appartements - Base 100 en moyenne annuelle 2015 - Série brute Q 2026-03-31T00:00:00+00:00
RPP.Q.FR.N.NH.CR.1.00 Prix de vente moyen d'une maison neuve, Ile de France Q 2026-06-30T00:00:00+00:00

New

Code 
get_observations("BSI1.M.FR.Y.R.A220Z.A.4.U6.2254FR.Z01.E") |>
  print_table_conditional()

BSI1

Datastructure

Code 
BSI1_datastructure <- httr::GET(paste0(catalog_url, "/webstat-datasets/exports/json"),
                          query = list(where = 'dataset_id="BSI1"'),
                          httr::add_headers(Authorization = paste("Apikey", api_key)),
                          httr::config(http_version = 1.1)) |>
  httr::content("text", encoding = "UTF-8") |>
  jsonlite::fromJSON(flatten = TRUE)

tibble(dimension = names(jsonlite::fromJSON(BSI1_datastructure$dimensions_and_codelists[1])),
       codelist = unlist(jsonlite::fromJSON(BSI1_datastructure$dimensions_and_codelists[1]))) |>
  print_table_conditional()
dimension codelist
FREQ CL_FREQ
REF_AREA CL_AREA_EE
ADJUSTMENT CL_ADJUSTMENT
BS_REP_SECTOR CL_BS_REP_SECTOR
BS_ITEM CL_BS_ITEM
MATURITY_ORIG CL_MATURITY_ORIG
DATA_TYPE CL_DATA_TYPE
COUNT_AREA CL_AREA_EE_BIS
BS_COUNT_SECTOR CL_BS_COUNT_SECTOR
CURRENCY_TRANS CL_CURRENCY
BS_SUFFIX CL_BS_SUFFIX