Retrieve policy information from the SHERPA/RoMEO API using the ISSN from the paper edition of the journal or the ISSN of the electronic version (e-ISSN or ESSN)

rr_journal_issn(issn, key = NULL)

Arguments

issn

[character(1+)]
one or a vector of journal(s) ISSN(s) or ESSN(s)

key

[character(1)]
a character string containing the API key or NULL (see Details section on how to specify it)

Value

Returns a data.frame with the following columns:

  • title [character(1)]
    the name of the journal

  • provided_issn [character(1)]
    the ISSN you provided in your query (might differ from the ISSN returned by the API)

  • issn [character(1)]
    the ISSN of the journal

  • romeocolour [character(1)]
    the SHERPA/RoMEO colour of the journal

  • preprint [character(1)]
    is the preprint (not reviewed) archivable?

  • postprint [character(1)]
    is the postprint (reviewed but not formatted) archivable?

  • pdf [character(1)]
    is the publisher's version (reviewed and formatted)

  • pre_embargo [character(1)]
    if applicable the embargo period before the author(s) can archive the preprint

  • post_embargo [character(1)]
    if applicable the embargo period before the author(s) can archive the postprint, if value is "after media", it means that the post-print can be archived after media embargo has passed

  • pdf_embargo [character(1)]
    if applicable the embargo period before the author(s) can archive the publisher's version, if value is "after media", it means that the publisher's version can be archived after media embargo has passed

Details

There are several ways to provide your API key. The best way to know about them is to refer to the vignette about "Setting Up Your API key" accessible with the following command: vignette("setting_up_api_key", package = "rromeo"). You can also use rr_auth that will use the provided key to store it as an environmental variable.

Examples

# \donttest{ # Query single ISSN rr_journal_issn(issn = "1947-6264")
#> Error: The API endpoint could not be reached. Please try again later.
# Query multiple ISSN rr_journal_issn(issn = c("1947-6264", "0030-1299"))
#> Error: The API endpoint could not be reached. Please try again later.
# Query by ESSN rr_journal_issn("1463-9084")
#> Error: The API endpoint could not be reached. Please try again later.
# }