pull_cited_refs: Pull cited references

In jessicabeyer/wosr: Clients to the 'Web of Science' and 'InCites' APIs

Description

Pull cited references

Usage

pull_cited_refs(uts, sid = auth(Sys.getenv("WOS_USERNAME"),
  Sys.getenv("WOS_PASSWORD")), ...)

Arguments

uts	Vector of UTs (i.e., publications) whose cited references you want.
sid	Session identifier (SID). The default setting is to get a fresh SID each time you query WoS via a call to auth. However, you should try to reuse SIDs across queries so that you don't run into the throttling limits placed on new sessions.
...	Arguments passed along to POST.

Value

A data frame with the following columns:

ut

The publication that is doing the citing. These are the UTs that you submitted to pull_cited_refs. If one of your publications doesn't have any cited refs, it will not appear in this column.

doc_id

The cited ref's document identifier (similar to a UT).

title

Roughly equivalent to the cited ref's title.

journal

Roughly equivalent to the cited ref's journal.

author

The cited ref's first author.

tot_cites

The total number of citations the cited ref has received.

year

The cited ref's publication year.

page

The cited ref's page number.

volume

The cited ref's journal volume.

Examples

## Not run: 

sid <- auth("your_username", password = "your_password")
uts <- c("WOS:000362312600021", "WOS:000439855300030", "WOS:000294946900020")
pull_cited_refs(uts, sid)

## End(Not run)

jessicabeyer/wosr documentation built on May 31, 2019, 10:03 a.m.