{"id":21113679,"url":"https://github.com/stefanieschneider/viafr","last_synced_at":"2025-07-08T18:32:02.223Z","repository":{"id":56936394,"uuid":"193145700","full_name":"stefanieschneider/viafr","owner":"stefanieschneider","description":"R Interface to the VIAF (Virtual International Authority File) API","archived":false,"fork":false,"pushed_at":"2025-01-28T07:06:09.000Z","size":2925,"stargazers_count":9,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-06T15:55:21.904Z","etag":null,"topics":["api","interface","r","viaf"],"latest_commit_sha":null,"homepage":null,"language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stefanieschneider.png","metadata":{"files":{"readme":"README.Rmd","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-06-21T18:48:08.000Z","updated_at":"2025-03-24T11:40:44.000Z","dependencies_parsed_at":"2022-08-21T06:20:46.368Z","dependency_job_id":null,"html_url":"https://github.com/stefanieschneider/viafr","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/stefanieschneider/viafr","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefanieschneider%2Fviafr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefanieschneider%2Fviafr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefanieschneider%2Fviafr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefanieschneider%2Fviafr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stefanieschneider","download_url":"https://codeload.github.com/stefanieschneider/viafr/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefanieschneider%2Fviafr/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264323957,"owners_count":23590773,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","interface","r","viaf"],"created_at":"2024-11-20T01:58:00.415Z","updated_at":"2025-07-08T18:32:02.217Z","avatar_url":"https://github.com/stefanieschneider.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"---\noutput: github_document\n---\n\n\u003c!-- README.md is generated from README.Rmd. Please edit that file --\u003e\n\n```{r, include = FALSE}\nknitr::opts_chunk$set(\n\tcollapse = TRUE,\n\tcomment = \"#\u003e\",\n\tfig.path = \"man/figures/README-\",\n\tout.width = \"100%\"\n)\n\noptions(width = \"100\")\n\nrequire(magrittr)\nrequire(viafr)\n```\n\n# viafr \u003cimg src=\"man/figures/logo.png\" align=\"right\" width=\"120\" /\u003e\n\n[![Lifecycle badge](https://img.shields.io/badge/lifecycle-maturing-blue.svg)](https://lifecycle.r-lib.org/articles/stages.html#maturing)\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.3265046.svg)](https://doi.org/10.5281/zenodo.3265046)\n[![CRAN badge](http://www.r-pkg.org/badges/version/viafr)](https://cran.r-project.org/package=viafr)\n[![AppVeyor build status](https://ci.appveyor.com/api/projects/status/github/stefanieschneider/viafr?branch=master\u0026svg=true)](https://ci.appveyor.com/project/stefanieschneider/viafr)\n[![Coverage status](https://codecov.io/github/stefanieschneider/viafr/coverage.svg?branch=master)](https://app.codecov.io/github/stefanieschneider/viafr?branch=master)\n\n## Overview\n\nThis R package uses the VIAF (Virtual International Authority File) API. VIAF is an OCLC service that combines multiple LAM (Library, Archive, and Museum) name authority files into a single name authority service. It thus provides direct access to linked names for the same entity across the world's major name authority files, including national and regional variations in language, character set, and spelling. For more information go to https://viaf.org/.\n\n## Installation\n\nYou can install the released version of viafr from [CRAN](https://CRAN.R-project.org) with:\n\n```r\ninstall.packages(\"viafr\")\n```\n\nTo install the development version from [GitHub](https://github.com/stefanieschneider/viafr) use:\n\n```r\n# install.packages(\"devtools\")\ndevtools::install_github(\"stefanieschneider/viafr\")\n```\n\n## Usage\n\nThe viafr package functions use the VIAF (Virtual International Authority File) API. Optional VIAF API query parameters can be passed into each function. For information on supported query parameters, please see https://www.oclc.org/developer/api/oclc-apis/viaf.en.html.\n\n`viaf_get()` returns a tibble, where each row contains information about the respective VIAF identifier, whereas `viaf_search()` and `viaf_suggest()` each produce a named list of tibbles, with each tibble containing information about the respective search query. The MARC 21 field definitions are used, see, e.g., https://www.loc.gov/marc/bibliographic/.\n\n### Search VIAF records\n\n```{r example_search, message=FALSE, warning=FALSE}\n(result_search \u003c- viaf_search(\"Menzel\", maximumRecords = 5))\n\n# Retrieve a tibble of all source identifiers\n(source_ids \u003c- dplyr::pull(result_search$`Menzel`, source_ids))\n\n# Retrieve a tibble of data for the second search result\n(text \u003c- dplyr::pull(result_search$`Menzel`, text) %\u003e% purrr::pluck(2))\n```\n\n### Suggest VIAF records\n\n```{r example_suggest, message=FALSE, warning=FALSE}\n(result_suggest \u003c- viaf_suggest(\"austen\"))\n\n# Retrieve source identifiers for the most relevant search result\ndplyr::filter(result_suggest$`austen`, score \u003e 10000) %\u003e%\n  dplyr::pull(source_ids) %\u003e% purrr::pluck(1)\n```\n\n## Contributing\n\nPlease report issues, feature requests, and questions to the [GitHub issue tracker](https://github.com/stefanieschneider/viafr/issues). We have a [Contributor Code of Conduct](https://github.com/stefanieschneider/viafr/blob/master/CODE_OF_CONDUCT.md). By participating in viafr you agree to abide by its terms.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstefanieschneider%2Fviafr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstefanieschneider%2Fviafr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstefanieschneider%2Fviafr/lists"}