Lists the referendum data from sudd.ch in various ways its list.php endpoint allows. The output of this
function can be directly fed to sudd_rfrnds().
Arguments
- mode
The listing mode. One of
"by_date": Lists all referendums in the sudd.ch database bydate, together with theirid_sudd,country_code,territory_name_deandtitle_de. Specifying the sorting order of the results via theorderparameter is supported."by_mod_date": Lists all referendums in the sudd.ch database bydate_last_edited, together with theirid_sudd,country_code,territory_name_de,dateandtitle_de."filter": Allows to provide additional arguments (via thefilterparameter) that limit the results accordingly. Specifying the sorting order of the results via theorderparameter is supported."random": Lists theid_suddof five randomly selected referendums, together with theircountry_code.
- order
The sorting order of the results. Only relevant if
modeis either"by_date"or"filter".- filter
A list with valid filtering arguments. Only relevant if
mode = "filter". The supported filtering arguments includeterritory_name_de: A string that must be (partially) matched by the referendums'territory_name_de. Matching is case-insensitive and no fuzzy matching is supported.title_de: A string that must be (partially) matched by the referendums'title_de. Matching is case-insensitive and no fuzzy matching is supported.year_min: The lower year limit of the referendums'date. A positive integer.year_max: The upper year limit of the referendums'date. A positive integer.
- use_cache
Whether or not to return cached results if possible. If
FALSE, results are always newly fetched regardless ofmax_cache_age.- max_cache_age
Duration after which cached results are refreshed (i.e. newly fetched). A valid lubridate duration. Use
Infto disable cache expiry. Only relevant ifuse_cache = TRUE.- quiet
Whether or not to suppress printing status output from internal processing.
Value
A tibble containing at least an id_sudd column.
About sudd.ch
sudd stands for Suchmaschine für direkte Demokratie (German) and is operated by Beat Müller. Its database content is licensed under Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0).
See also
Other sudd.ch scraping functions:
list_sudd_territories(),
list_sudd_titles(),
sudd_rfrnds()
Examples
# list all referendums by modification date (takes a while)
if (FALSE) { # \dontrun{
rdb::list_sudd_rfrnds(mode = "by_mod_date")} # }
# list all referendums whose title matches "AHV"
rdb::list_sudd_rfrnds(mode = "filter",
filter = list(title_de = "AHV"),
quiet = TRUE)
#> # A tibble: 18 × 11
#> id_sudd country_code country_name is_former_country subnational_entity_code territory_name_de date year month day title_de
#> <chr> <chr> <chr> <lgl> <chr> <chr> <date> <int> <int> <int> <chr>
#> 1 ch021978 CH Switzerland FALSE NA Schweiz 1978-02-26 1978 2 26 Alters- und Hinterlassenenversic…
#> 2 ch031978 CH Switzerland FALSE NA Schweiz 1978-02-26 1978 2 26 Herabsetzung des AHV-Alters
#> 3 ch021988 CH Switzerland FALSE NA Schweiz 1988-06-12 1988 6 12 Herabsetzung des AHV-Rentenalter…
#> 4 ch051995 CH Switzerland FALSE NA Schweiz 1995-06-25 1995 6 25 Alters- und Hinterlassenenversic…
#> 5 ch061995 CH Switzerland FALSE NA Schweiz 1995-06-25 1995 6 25 Ausbau von AHV und IV
#> 6 ch061998 CH Switzerland FALSE NA Schweiz 1998-09-27 1998 9 27 10. AHV-Revision ohne Erhöhung d…
#> 7 ch082001 CH Switzerland FALSE NA Schweiz 2001-12-02 2001 12 2 Sicherung der AHV durch Besteuer…
#> 8 ch052002 CH Switzerland FALSE NA Schweiz 2002-09-22 2002 9 22 Überschüssige Goldreserven in de…
#> 9 ch042004 CH Switzerland FALSE NA Schweiz 2004-05-16 2004 5 16 Alters- und Hinterlassenenversic…
#> 10 ch052004 CH Switzerland FALSE NA Schweiz 2004-05-16 2004 5 16 Finanzierung der AHV/IV durch An…
#> 11 ch022006 CH Switzerland FALSE NA Schweiz 2006-09-24 2006 9 24 Nationalbankgewinne für die AHV
#> 12 ch072008 CH Switzerland FALSE NA Schweiz 2008-11-30 2008 11 30 Flexibles AHV-Alter
#> 13 ch112016 CH Switzerland FALSE NA Schweiz 2016-09-25 2016 9 25 Höhere AHV-Renten (AHV plus)
#> 14 ch062017 CH Switzerland FALSE NA Schweiz 2017-09-24 2017 9 24 Zusatzfinanzierung der AHV durch…
#> 15 ch022019 CH Switzerland FALSE NA Schweiz 2019-05-19 2019 5 19 Steuerreform und AHV-Finanzierung
#> 16 ch092022 CH Switzerland FALSE NA Schweiz 2022-09-25 2022 9 25 Zusatzfinanzierung der AHV durch…
#> 17 ch102022 CH Switzerland FALSE NA Schweiz 2022-09-25 2022 9 25 AHV-Gesetz (AHV 21)
#> 18 ch012024 CH Switzerland FALSE NA Schweiz 2024-03-03 2024 3 3 Besseres Leben im Alter (13. AHV…
# get sudd.ch referendum data from all referendums from 2020 onwards
rdb::list_sudd_rfrnds(mode = "filter",
filter = list(year_min = 2020),
quiet = TRUE) |>
rdb::sudd_rfrnds(quiet = TRUE)
#> # A tibble: 58 × 37
#> id_sudd country_code country_name is_former_country subnational_entity_code territory_name_de territory_type_de date year month day title_de
#> <chr> <chr> <chr> <lgl> <chr> <chr> <chr> <date> <int> <int> <int> <chr>
#> 1 ch012020 CH Switzerland FALSE NA Schweiz unabhängiger Staat 2020-02-09 2020 2 9 Mehr be…
#> 2 ch022020 CH Switzerland FALSE NA Schweiz unabhängiger Staat 2020-02-09 2020 2 9 Strafge…
#> 3 fr012020 FR France FALSE NA Frankreich unabhängiger Staat 2020-03-15 2020 3 15 Rückzug…
#> 4 gn012020 GN Guinea FALSE NA Guinea unabhängiger Staat 2020-03-22 2020 3 22 Verfass…
#> 5 pw012020 PW Palau FALSE NA Palau unabhängiger Staat 2020-05-01 2020 5 1 Festleg…
#> 6 ru012020 RU Russian Federation FALSE NA Russland unabhängiger Staat 2020-07-01 2020 7 1 Verfass…
#> 7 ru022020 RU Russian Federation FALSE NA Russland unabhängiger Staat 2020-07-01 2020 7 1 Staatsb…
#> 8 ru032020 RU Russian Federation FALSE NA Russland unabhängiger Staat 2020-07-01 2020 7 1 Bodensc…
#> 9 ru042020 RU Russian Federation FALSE NA Russland unabhängiger Staat 2020-07-01 2020 7 1 Tiefere…
#> 10 ru052020 RU Russian Federation FALSE NA Russland unabhängiger Staat 2020-07-01 2020 7 1 Indexie…
#> # ℹ 48 more rows
#> # ℹ 25 more variables: question_type_de <chr>, result_de <chr>, result_status_de <chr>, adoption_requirements_de <list>, electorate_total <int>,
#> # electorate_abroad <int>, polling_cards <int>, votes_total <int>, votes_empty <int>, votes_void <int>, votes_invalid <int>, votes_valid <int>,
#> # votes_yes <int>, votes_no <int>, votes_option_1 <int>, votes_option_2 <int>, votes_option_3 <int>, subterritories <dbl>, subterritories_yes <dbl>,
#> # subterritories_no <dbl>, files <list>, remarks <list>, sources <list>, ids_sudd_simultaneous <list>, date_last_edited <date>
# get sudd.ch referendum data from five randomly picked referendums
rdb::list_sudd_rfrnds(mode = "random",
quiet = TRUE) |>
rdb::sudd_rfrnds(quiet = TRUE)
#> # A tibble: 5 × 35
#> id_sudd country_code country_name is_former_country subnational_entity_code territory_name_de territory_type_de date year month day title_de
#> <chr> <chr> <chr> <lgl> <chr> <chr> <chr> <date> <int> <int> <int> <chr>
#> 1 ch031971 CH Switzerland FALSE NA Schweiz unabhängiger Sta… 1971-06-06 1971 6 6 Weiterf…
#> 2 ch011975 CH Switzerland FALSE NA Schweiz unabhängiger Sta… 1975-03-02 1975 3 2 Konjunk…
#> 3 fm041978 FM Micronesia FALSE NA Yap (Mikronesischer Staa… Treuhand-/Mandat… 1978-07-12 1978 7 12 Verfass…
#> 4 ch091990 CH Switzerland FALSE NA Schweiz unabhängiger Sta… 1990-09-23 1990 9 23 Energie…
#> 5 az112016 AZ Azerbaijan FALSE NA Aserbaidschan unabhängiger Sta… 2016-09-26 2016 9 26 Klagere…
#> # ℹ 23 more variables: question_type_de <chr>, result_de <chr>, result_status_de <chr>, adoption_requirements_de <list>, electorate_total <int>,
#> # electorate_abroad <int>, votes_total <int>, votes_empty <int>, votes_void <int>, votes_invalid <int>, votes_valid <int>, votes_yes <int>, votes_no <int>,
#> # votes_option_1 <int>, votes_option_2 <int>, subterritories <dbl>, subterritories_yes <dbl>, subterritories_no <dbl>, files <list>, remarks <list>,
#> # sources <list>, ids_sudd_simultaneous <list>, date_last_edited <date>