Package {eurlex}

Type:	Package
Title:	Retrieve Data on European Union Law
Version:	0.5.1
Description:	Access to data on European Union laws and court decisions made easy with pre-defined 'SPARQL' queries and 'GET' requests. See Ovadek (2021) <doi:10.1080/2474736X.2020.1870150> .
License:	GPL-3
Encoding:	UTF-8
Language:	en-US
Depends:	R (≥ 3.6.0)
Imports:	xml2, httr, curl, rvest, pdftools, antiword
Suggests:	dplyr, ggplot2, knitr, purrr, rmarkdown, testthat (≥ 3.0.0), tidytext
URL:	https://michalovadek.github.io/eurlex/, https://github.com/michalovadek/eurlex
BugReports:	https://github.com/michalovadek/eurlex/issues
RoxygenNote:	7.3.3
VignetteBuilder:	knitr
Config/testthat/edition:	3
NeedsCompilation:	no
Packaged:	2026-10-22 17:56:26 UTC; uctqova
Author:	Michal Ovadek [aut, cre, cph]
Maintainer:	Michal Ovadek <michal.ovadek@gmail.com>
Repository:	CRAN
Date/Publication:	2026-10-22 23:00:08 UTC

Download XML notice associated with a URL

Description

Downloads an XML notice of a given type associated with a Cellar resource.

Usage

elx_download_xml(
  url,
  file = paste(basename(url), ".xml", sep = ""),
  notice = c("tree", "branch", "object"),
  language_1 = "en",
  language_2 = "fr",
  language_3 = "de",
  mode = "wb"
)

Arguments

Details

To retrieve all identifiers associated with a url, use elx_fetch_data(type = "ids").

Value

Path of downloaded file (invisibly) if server validates request (http status code has to be 200). For more information about notices, see Cellar documentation.

Examples

temploc <- file.path(tempdir(), "elxnotice.xml")
elx_download_xml(url = "http://publications.europa.eu/resource/celex/32022D0154",
 file = temploc, notice = "object")
unlink(temploc)

Retrieve additional data on EU documents

Description

Get titles, texts, identifiers and XML notices for EU resources.

Usage

elx_fetch_data(
  url,
  type = c("title", "text", "ids", "notice"),
  notice = c("tree", "branch", "object"),
  language_1 = "en",
  language_2 = "fr",
  language_3 = "de",
  include_breaks = TRUE,
  html_text = c("text2", "text")
)

Arguments

Value

A character vector of length one containing the result. When type = "text", named character vector where the name contains the source of the text.

Examples

elx_fetch_data(url = "http://publications.europa.eu/resource/celex/32014R0001", type = "title")

Label EuroVoc concepts

Description

Create a look-up table with labels for EuroVoc concept URIs. Only unique identifiers are returned.

Usage

elx_label_eurovoc(uri_eurovoc = "", alt_labels = FALSE, language = "en")

Arguments

Value

A data frame containing EuroVoc unique concept identifiers and labels.

Examples

elx_label_eurovoc(uri_eurovoc = "http://eurovoc.europa.eu/5760", language = "fr")

Create SPARQL queries

Description

Generates pre-defined or manual SPARQL queries to retrieve document ids from Cellar. List of available resource types: http://publications.europa.eu/resource/authority/resource-type . Note that not all resource types are compatible with default parameter values.

Usage

elx_make_query(
  resource_type = c("any", "directive", "regulation", "decision", "recommendation",
    "intagr", "caselaw", "manual", "proposal", "national_impl"),
  manual_type = "",
  directory = NULL,
  sector = NULL,
  include_corrigenda = FALSE,
  include_celex = TRUE,
  include_lbs = FALSE,
  include_date = FALSE,
  date_from = NULL,
  date_to = NULL,
  include_date_force = FALSE,
  include_date_endvalid = FALSE,
  include_date_transpos = FALSE,
  include_date_lodged = FALSE,
  include_force = FALSE,
  include_eurovoc = FALSE,
  include_citations = FALSE,
  include_citations_detailed = FALSE,
  include_author = FALSE,
  include_title = FALSE,
  include_directory = FALSE,
  include_directory_code = FALSE,
  include_sector = FALSE,
  include_ecli = FALSE,
  include_court_procedure = FALSE,
  include_judge_rapporteur = FALSE,
  include_advocate_general = FALSE,
  include_court_formation = FALSE,
  include_court_scholarship = FALSE,
  include_court_origin = FALSE,
  include_original_language = FALSE,
  include_proposal = FALSE,
  order = FALSE,
  limit = NULL
)

Arguments

Details

When date_from or date_to are specified, the underlying SPARQL query requires ?date to be a well-formed xsd:date. Any document whose date does not resolve to a valid xsd:date would be silently excluded from the filtered results, without a warning or error.

When include_author is TRUE, the query uses GROUP_CONCAT to combine multiple authors for the same document into a single pipe-separated (|) string in the author column, rather than returning one row per author. This avoids duplicate rows for documents with multiple authors, but means the query switches from ⁠SELECT DISTINCT⁠ to ⁠SELECT ... GROUP BY⁠ internally when include_author is used.

Value

A character string containing the SPARQL query

Examples

elx_make_query(resource_type = "directive", include_date = TRUE, include_force = TRUE)
elx_make_query(resource_type = "directive", include_title = TRUE)
elx_make_query(resource_type = "directive", date_from = "2015-01-01", date_to = "2015-12-31")
elx_make_query(resource_type = "regulation", include_corrigenda = TRUE, order = TRUE)
elx_make_query(resource_type = "any", sector = 2)
elx_make_query(resource_type = "manual", manual_type = "SWD")

Execute SPARQL queries

Description

Executes cURL request to a pre-defined endpoint of the EU Publications Office. Relies on elx_make_query to generate valid SPARQL queries. Results are capped at 1 million rows.

Usage

elx_run_query(
  query = "",
  endpoint = "http://publications.europa.eu/webapi/rdf/sparql"
)

Arguments

Value

A data frame containing the results of the SPARQL query. Column work contains the Cellar URI of the resource.

Examples

elx_run_query(elx_make_query("directive", include_force = TRUE, limit = 10))