searcher: Convert an input to a item QID

Description Usage Arguments Value Examples

View source: R/gets.R

Description

Convert an input string to the most likely item QID

Usage

1
searcher(search_term, language, limit, type, ...)

Arguments

search_term

a term to search for.

language

the language to return the labels and descriptions in; this should consist of an ISO language code. Set to "en" by default.

limit

the number of results to return; set to 10 by default.

type

type of wikidata object to return (default = "item")

\dots

Additional parameters to supply to [httr::POST]

Value

If the inputted string matches an item label, return its QID. If the inputted string matches multiple labels of multiple items, return the QID of the first hit. If the inputted string is already a QID, return the string.

Examples

1
2
3
4
5
6
# if input string is a valid QID
as_qid("Q42")
# if input string matches multiple item labels
as_qid("Douglas Adams")
# if input string matches a single unique label
as_qid("Douglas Adams and the question of arterial blood pressure in mammals")

WikidataR documentation built on Nov. 16, 2021, 5:07 p.m.