Skip to contents

oa_fetch but for a random query

Source: R/oa_fetch.R
oa_random.Rd

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", "keywords", "funders", "sources", "publishers", "topics"). If not provided, `entity` is guessed from `identifier`.

output

Character. Type of output, one of `"tibble"`, `"dataframe"`, `"list"`, or `"raw"`.

  • "tibble": a tibble tidy data

  • "dataframe": a base data.frame tidy data

  • "list": a list of parsed JSON contents

  • "raw": a list of raw JSON strings (length depends on query)

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()
#> Warning: Note: `oa_fetch` and `oa2df` now return new names for some columns in openalexR v2.0.0.
#>     See NEWS.md for the list of changes.
#>     Call `get_coverage()` to view the all updated columns and their original names in OpenAlex.
#> This warning is displayed once every 8 hours.
#> # A tibble: 1 × 33
#>   id      title display_name authorships doi   publication_date publication_year
#>   <chr>   <chr> <chr>        <list>      <lgl> <date>                      <int>
#> 1 https:… Pres… Presentatio… <tibble>    NA    1988-06-01                   1988
#> # ℹ 26 more variables: fwci <dbl>, cited_by_count <int>, counts_by_year <lgl>,
#> #   cited_by_api_url <chr>, ids <list>, type <chr>, is_oa <lgl>,
#> #   is_oa_anywhere <lgl>, oa_status <chr>, oa_url <lgl>,
#> #   any_repository_has_fulltext <lgl>, landing_page_url <chr>,
#> #   referenced_works <lgl>, referenced_works_count <int>, related_works <list>,
#> #   concepts <list>, topics <list>, keywords <list>, is_paratext <lgl>,
#> #   is_retracted <lgl>, language <chr>, grants <lgl>, first_page <lgl>, …