Skip to contents

oa_fetch but for a random query

Usage

oa_random(
  entity = oa_entities(),
  output = c("tibble", "dataframe", "list"),
  endpoint = "https://api.openalex.org"
)

Arguments

entity

Character. Scholarly entity of the search. The argument can be one of c("works", "authors", "institutions", "concepts", "funders", "sources", "publishers", "topics"). If not provided, `entity` is guessed from `identifier`.

output

Character. Type of output, either a list or a tibble/data.frame.

endpoint

Character. URL of the OpenAlex Endpoint API server. Defaults to endpoint = "https://api.openalex.org".

Value

A data.frame or a list. One row or one element. Result of the random query. If you would like to select more than one random entity, say, 10, use `options = list(sample = 10)` argument in `oa_fetch`.

Examples

oa_random()
#> # A tibble: 1 × 36
#>   id    title display_name author publication_date so    so_id host_organization
#>   <chr> <chr> <chr>        <list> <chr>            <chr> <chr> <chr>            
#> 1 http… Pier… Pierccd She… <df>   1986-12-31       De G… http… De Gruyter       
#> # ℹ 28 more variables: url <chr>, pdf_url <lgl>, license <lgl>, version <lgl>,
#> #   first_page <chr>, last_page <chr>, volume <lgl>, issue <lgl>, is_oa <lgl>,
#> #   is_oa_anywhere <lgl>, oa_status <chr>, oa_url <lgl>,
#> #   any_repository_has_fulltext <lgl>, language <chr>, grants <lgl>,
#> #   cited_by_count <int>, counts_by_year <lgl>, publication_year <int>,
#> #   cited_by_api_url <chr>, ids <list>, doi <chr>, type <chr>,
#> #   referenced_works <lgl>, related_works <list>, is_paratext <lgl>, …