Convert an input string to the most likely item QID
Arguments
- search_term
a term to search for.
- language
the language to conduct the search 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.
- response_language
the language to return the labels and descriptions in; this should consist of an ISO language code. Set to "en" 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
# if input string is a valid QID
as_qid("Q42")
#> # A tibble: 1 × 1
#> x
#> <chr>
#> 1 Q42
# if input string matches multiple item labels
as_qid("Douglas Adams")
#> Multiple exact matches for "Douglas Adams"
#> match 1 = (Q28421831) American environmental engineer
#> match 2 = (Q42) English science fiction writer and humorist (1952–2001)
#> match 3 = (Q21454969) British painter (1853-1920)
#> match 4 = (Q75824389) Peerage person ID=348982
#> match 5 = (Q5301194) Wikimedia disambiguation page
#> match 6 = (Q117249850) Global Co-Head of Equity Capital Markets, Citi
#> # A tibble: 1 × 1
#> x
#> <chr>
#> 1 Q28421831
# if input string matches a single unique label
as_qid("Douglas Adams and the question of arterial blood pressure in mammals")
#> # A tibble: 1 × 1
#> x
#> <chr>
#> 1 Q89525960