List DIP Aktivitäten — dip_bundestag_aktivitaet_list • bunddev

List DIP Aktivitäten

Usage

dip_bundestag_aktivitaet_list(
  params = list(),
  safe = TRUE,
  refresh = FALSE,
  flatten = FALSE,
  flatten_mode = "json"
)

Arguments

params

Named list of query parameters. Common keys:

format: Response format ("json" recommended; default set by adapter).
apikey: Optional API key as query parameter (prefer auth header).
fuzzy: Free-text search string (character).
sort: Sort field/order definition (character).
cursor: Cursor for pagination (character).
limit: Page size/maximum number of documents (integer).

safe

Logical; if TRUE (default), apply rate-limiting and cache GET responses to tools::R_user_dir("bunddev", "cache").

refresh

Logical; if TRUE, ignore cached responses and re-fetch from the API (default FALSE).

flatten

Logical; if TRUE, simplify nested list columns according to flatten_mode. Default FALSE keeps list columns as-is.

flatten_mode

How to handle list columns when flatten = TRUE:

"drop": Remove list columns entirely. Use when nested data is not needed.
"json": Convert each list element to a JSON string. Preserves all data in a text-queryable format. This is the default.
"unnest": Expand list columns into multiple rows via tidyr::unnest_longer(). Warning: this can significantly increase the number of rows.

Value

A tibble with one row per Aktivitaet and columns:

id: Character. Unique Aktivitaet identifier.
aktivitaetsart: Character. Activity type.
typ: Character. Entity type, always "Aktivitaet".
dokumentart: Character. Document type.
wahlperiode: Integer. Legislative period.
datum: Character. Date of associated document.
aktualisiert: Character. Last update timestamp.
titel: Character. Title text.
vorgangsbezug_anzahl: Integer. Total related Vorgaenge.
abstract: Character. Summary text.
fundstelle: List. Document reference details.
vorgangsbezug: List. Related Vorgaenge.
deskriptor: List. Thesaurus descriptor entries.

Wrapped in a one-row tibble with num_found (integer), cursor (character), and documents (list-column) when not yet unpacked.

See also

bunddev_parameters() to inspect available query parameters.

Other DIP Bundestag: dip_bundestag_aktivitaet(), dip_bundestag_drucksache(), dip_bundestag_drucksache_list(), dip_bundestag_drucksache_text(), dip_bundestag_drucksache_text_list(), dip_bundestag_person(), dip_bundestag_person_list(), dip_bundestag_plenarprotokoll(), dip_bundestag_plenarprotokoll_list(), dip_bundestag_plenarprotokoll_text(), dip_bundestag_plenarprotokoll_text_list(), dip_bundestag_vorgang(), dip_bundestag_vorgang_list(), dip_bundestag_vorgangsposition(), dip_bundestag_vorgangsposition_list()

Examples

if (FALSE) { # \dontrun{
dip_bundestag_aktivitaet_list()
} # }