Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/wikimedia/wikidataqueryservicer
An R package for the Wikidata Query Service API
https://github.com/wikimedia/wikidataqueryservicer
api-wrapper r r-package rstats sparql wdqs wikidata
Last synced: about 1 month ago
JSON representation
An R package for the Wikidata Query Service API
- Host: GitHub
- URL: https://github.com/wikimedia/wikidataqueryservicer
- Owner: wikimedia
- License: other
- Created: 2017-01-03T19:15:12.000Z (almost 8 years ago)
- Default Branch: main
- Last Pushed: 2020-07-27T13:57:53.000Z (over 4 years ago)
- Last Synced: 2024-10-07T12:27:32.983Z (about 1 month ago)
- Topics: api-wrapper, r, r-package, rstats, sparql, wdqs, wikidata
- Language: R
- Homepage: https://cran.r-project.org/package=WikidataQueryServiceR
- Size: 51.8 KB
- Stars: 28
- Watchers: 6
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.Rmd
- License: LICENSE
Awesome Lists containing this project
README
---
title: "WikidataQueryServiceR"
output:
github_document:
toc: true
toc_depth: 3
---
```{r setup, include=FALSE}
knitr::opts_chunk$set(echo = TRUE)
# install.packages("printr", type = "source", repos = c("https://yihui.name/xran", CRAN = "https://cran.rstudio.com"))
library(printr)
```
[](http://www.repostatus.org/#active)
[](https://cran.r-project.org/package=WikidataQueryServiceR)
[](https://cran.r-project.org/package=WikidataQueryServiceR)
[](https://opensource.org/licenses/MIT)
This is an R wrapper for the [Wikidata Query Service (WDQS)](https://www.mediawiki.org/wiki/Wikidata_query_service) which provides a way for tools to query [Wikidata](https://www.wikidata.org/wiki/Wikidata:Main_Page) via [SPARQL](https://en.wikipedia.org/wiki/SPARQL) (see the beta at https://query.wikidata.org/). It is written in and for R, and was inspired by Os Keyes' [WikipediR](https://github.com/Ironholds/WikipediR) and [WikidataR](https://github.com/Ironholds/WikidataR) packages.
__Author:__ Mikhail Popov (Wikimedia Foundation)
__License:__ [MIT](http://opensource.org/licenses/MIT)
__Status:__ Active
## Installation
```R
install.packages("WikidataQueryServiceR")
```
To install the development version:
```R
# install.packages("remotes")
remotes::install_github("wikimedia/WikidataQueryServiceR@main")
```
## Usage
```{r load}
library(WikidataQueryServiceR)
```
You submit SPARQL queries using the `query_wikidata()` function.
### Example: fetching genres of a particular movie
In this example, we find an "instance of" ([P31](https://www.wikidata.org/wiki/Property:P31)) "film" ([Q11424](https://www.wikidata.org/wiki/Q11424)) that has the label "The Cabin in the Woods" ([Q45394](https://www.wikidata.org/wiki/Q45394)), get its genres ([P136](https://www.wikidata.org/wiki/Property:P136)), and then use [WDQS label service](https://www.mediawiki.org/wiki/Wikidata_query_service/User_Manual#Label_service) to return the genre labels.
```{r wdqs_example, cache=TRUE}
query_wikidata('SELECT DISTINCT
?genre ?genreLabel
WHERE {
?film wdt:P31 wd:Q11424.
?film rdfs:label "The Cabin in the Woods"@en.
?film wdt:P136 ?genre.
SERVICE wikibase:label { bd:serviceParam wikibase:language "en". }
}')
```
For more example SPARQL queries, see [this page](https://www.wikidata.org/wiki/Wikidata:SPARQL_query_service/queries/examples) on [Wikidata](https://www.wikidata.org/wiki/Wikidata:Main_Page).
`query_wikidata()` can accept multiple queries, returning a (potentially named) list of data frames. If the vector of SPARQL queries is named, the results will inherit those names.
### Fetching queries from Wikidata's examples page
The package provides a [WikipediR](https://github.com/Ironholds/WikipediR/)-based function for getting SPARQL queries from the [WDQS examples page](https://www.wikidata.org/wiki/Wikidata:SPARQL_query_service/queries/examples).
```{r get_examples, cache=TRUE}
sparql_query <- get_example(c("Cats", "How many states this US state borders"))
```
```{r, eval=FALSE}
sparql_query[["How many states this US state borders"]]
```
```{r, echo=FALSE, results='asis'}
cat("```SPARQL\n", sparql_query[["How many states this US state borders"]], "\n```")
```
Now we can run all extracted SPARQL queries:
```{r run_examples, cache=TRUE, dependson='get_examples'}
results <- query_wikidata(sparql_query)
lapply(results, dim)
head(results$`How many states this US state borders`)
```
## Links for learning SPARQL
- [A beginner-friendly course for SPARQL](https://www.wikidata.org/wiki/Wikidata:A_beginner-friendly_course_for_SPARQL)
- Building a SPARQL query: [Museums on Instagram](https://www.wikidata.org/wiki/Help:SPARQL/Building_a_query/Museums_on_Instagram)
- [SPARQL Query Examples](https://www.wikidata.org/wiki/Wikidata:SPARQL_query_service/queries/examples) for WDQS
- [Using SPARQL to access Linked Open Data](http://programminghistorian.org/lessons/graph-databases-and-SPARQL) by Matthew Lincoln
- Interesting or illustrative [SPARQL queries](https://www.wikidata.org/wiki/Wikidata:SPARQL_query_service/queries) for Wikidata
- Wikidata [2016 SPARQL Workshop](https://www.wikidata.org/wiki/Wikidata:SPARQL_query_service/2016_SPARQL_Workshop)
- [Wikidata SPARQL Query video tutorial](https://www.youtube.com/watch?v=1jHoUkj_mKw) by Navino Evans
- _[Learning SPARQL](http://www.learningsparql.com/)_ by Bob DuCharme
- [WDQS User Manual](https://www.mediawiki.org/wiki/Wikidata_query_service/User_Manual)
## Additional Information
Please note that this project is released with a [Contributor Code of Conduct](https://github.com/bearloga/WikidataQueryServiceR/blob/master/CONDUCT.md). By participating in this project you agree to abide by its terms.