Package API

rorcid is an R programmatic interface to the Orcid public API. rorcid is not a product developed or distributed by ORCID®.

Orcid API docs: http://members.orcid.org/api

The package now works with the v3.0 ORCID API. It's too complicated to allow users to work with different versions of the API, so it's hard-coded to v3.0.

Package API

orcid_search
orcid_external_identifiers
orcid_auth
orcid
orcid_qualifications
identifiers
orcid_activities
orcid_employments
orcid_bio
works
orcid_fundings
orcid_doi
orcid_citations
orcid_research_resources
orcid_researcher_urls
orcid_id
orcid_email
orcid_keywords
orcid_invited_positions
orcid_distinctions
orcid_peer_reviews
orcid_ping
orcid_services
orcid_memberships
browse
orcid_person
as.orcid
check_dois
orcid_address
orcid_educations
orcid_other_names
orcid_works

Installation

Install from CRAN

install.packages("rorcid")

Or install the development version from GitHub

devtools::install_github("ropensci/rorcid")

Load rorcid

library("rorcid")

as.orcid

There's a function as.orcid() in this package to help coerce an Orcid ID to an object that holds details for that Orcid ID, prints a nice summary, and you can browse easily to that profile. E.g.

as.orcid(x = "0000-0002-1642-628X")
#> <ORCID> 0000-0002-1642-628X
#>   Name: Boettiger, Carl
#>   URL (first): http://www.carlboettiger.info
#>   Country: US
#>   Keywords: Ecology, Evolution, Regime Shifts, Stochastic Dynamics

Or you can pass in many IDs

as.orcid(c("0000-0003-1620-1408", "0000-0002-9341-7985"))
#> [[1]]
#> <ORCID> 0000-0003-1620-1408
#>   Name: Johnson, Thomas
#>   URL (first): 
#>   Country: US
#>   Keywords: 
#> 
#> [[2]]
#> <ORCID> 0000-0002-9341-7985
#>   Name: Binfield, Peter
#>   URL (first): 
#>   Country: US
#>   Keywords:

The browse() function lets you browser to a profile easily with a single function call

browse(as.orcid("0000-0002-1642-628X"))

profile

Get works

The works() function helps get works data from an orcid data object. The output of works() uses a print method to just print citations for each work.

(out <- works(orcid_id("0000-0002-0233-1757")))
#> # A tibble: 6 x 32
#>   `put-code` url   type  `journal-title` visibility path  `display-index`
#> *      <int> <lgl> <chr> <lgl>           <chr>      <chr> <chr>          
#> 1    5296064 NA    jour… NA              public     /000… 0              
#> 2    5296065 NA    jour… NA              public     /000… 0              
#> 3    5296066 NA    jour… NA              public     /000… 0              
#> 4    9012984 NA    jour… NA              public     /000… 0              
#> 5    9012985 NA    jour… NA              public     /000… 0              
#> 6    9012986 NA    jour… NA              public     /000… 0              
#> # … with 25 more variables: `created-date.value` <dbl>,
#> #   `last-modified-date.value` <dbl>, `source.source-client-id` <lgl>,
#> #   `source.assertion-origin-orcid` <lgl>,
#> #   `source.assertion-origin-client-id` <lgl>,
#> #   `source.assertion-origin-name` <lgl>, `source.source-orcid.uri` <chr>,
#> #   `source.source-orcid.path` <chr>, `source.source-orcid.host` <chr>,
#> #   `source.source-name.value` <chr>, title.subtitle <lgl>,
#> #   `title.translated-title` <lgl>, title.title.value <chr>,
#> #   `external-ids.external-id` <list>,
#> #   `publication-date.year.value` <chr>,
#> #   `publication-date.month.value` <chr>,
#> #   `publication-date.day.value` <chr>, `publication-date.day` <lgl>,
#> #   `external-ids` <lgl>, `publication-date` <lgl>,
#> #   `source.source-client-id.uri` <chr>,
#> #   `source.source-client-id.path` <chr>,
#> #   `source.source-client-id.host` <chr>, url.value <chr>,
#> #   `source.source-orcid` <lgl>

Search Orcid

Get a list of names and Orcid IDs matching a name query

orcid(query = "carl boettiger")
#> # A tibble: 100 x 3
#>    `orcid-identifier.uri`         `orcid-identifier.p… `orcid-identifier.h…
#>  * <chr>                          <chr>                <chr>               
#>  1 https://orcid.org/0000-0002-1… 0000-0002-1642-628X  orcid.org           
#>  2 https://orcid.org/0000-0002-3… 0000-0002-3554-5196  orcid.org           
#>  3 https://orcid.org/0000-0002-5… 0000-0002-5951-4503  orcid.org           
#>  4 https://orcid.org/0000-0002-7… 0000-0002-7462-1956  orcid.org           
#>  5 https://orcid.org/0000-0003-1… 0000-0003-1021-5374  orcid.org           
#>  6 https://orcid.org/0000-0002-8… 0000-0002-8885-5438  orcid.org           
#>  7 https://orcid.org/0000-0002-4… 0000-0002-4791-6222  orcid.org           
#>  8 https://orcid.org/0000-0002-7… 0000-0002-7790-5102  orcid.org           
#>  9 https://orcid.org/0000-0002-0… 0000-0002-0704-2460  orcid.org           
#> 10 https://orcid.org/0000-0003-2… 0000-0003-2511-367X  orcid.org           
#> # … with 90 more rows

You can string together many search terms

orcid(query = "johnson cardiology houston")
#> # A tibble: 100 x 3
#>    `orcid-identifier.uri`         `orcid-identifier.p… `orcid-identifier.h…
#>  * <chr>                          <chr>                <chr>               
#>  1 https://orcid.org/0000-0002-0… 0000-0002-0897-2301  orcid.org           
#>  2 https://orcid.org/0000-0002-5… 0000-0002-5281-4466  orcid.org           
#>  3 https://orcid.org/0000-0001-6… 0000-0001-6172-5804  orcid.org           
#>  4 https://orcid.org/0000-0001-8… 0000-0001-8188-0078  orcid.org           
#>  5 https://orcid.org/0000-0002-4… 0000-0002-4968-6272  orcid.org           
#>  6 https://orcid.org/0000-0002-1… 0000-0002-1918-5792  orcid.org           
#>  7 https://orcid.org/0000-0001-9… 0000-0001-9667-1615  orcid.org           
#>  8 https://orcid.org/0000-0002-4… 0000-0002-4334-4001  orcid.org           
#>  9 https://orcid.org/0000-0003-0… 0000-0003-0945-6138  orcid.org           
#> 10 https://orcid.org/0000-0002-9… 0000-0002-9503-6836  orcid.org           
#> # … with 90 more rows

And you can use start and rows arguments to do pagination

orcid("johnson cardiology houston", start = 2, rows = 3)
#> # A tibble: 3 x 3
#>   `orcid-identifier.uri`         `orcid-identifier.pa… `orcid-identifier.h…
#> * <chr>                          <chr>                 <chr>               
#> 1 https://orcid.org/0000-0001-6… 0000-0001-6172-5804   orcid.org           
#> 2 https://orcid.org/0000-0001-8… 0000-0001-8188-0078   orcid.org           
#> 3 https://orcid.org/0000-0002-4… 0000-0002-4968-6272   orcid.org

Search by Orcid ID

out <- orcid_id(orcid = "0000-0002-9341-7985")
out$`0000-0002-9341-7985`$addresses
#> $`last-modified-date`
#> $`last-modified-date`$value
#> [1] 1.465227e+12
#> 
#> 
#> $address
#>   visibility                               path put-code display-index
#> 1     public /0000-0002-9341-7985/address/89515    89515             0
#>   created-date.value last-modified-date.value source.source-client-id
#> 1       1.453659e+12             1.465227e+12                      NA
#>   source.assertion-origin-orcid source.assertion-origin-client-id
#> 1                            NA                                NA
#>   source.assertion-origin-name               source.source-orcid.uri
#> 1                           NA https://orcid.org/0000-0002-9341-7985
#>   source.source-orcid.path source.source-orcid.host
#> 1      0000-0002-9341-7985                orcid.org
#>   source.source-name.value country.value
#> 1           Peter Binfield            US
#> 
#> $path
#> [1] "/0000-0002-9341-7985/address"

Search by DOIs

There is a helper function check_dois() that uses a regex checker to see if your DOIs are likely good or likely bad:

All good DOIs

dois <- c("10.1371/journal.pone.0025995","10.1371/journal.pone.0053712",
       "10.1371/journal.pone.0054608","10.1371/journal.pone.0055937")
check_dois(dois)
#> $good
#> [1] "10.1371/journal.pone.0025995" "10.1371/journal.pone.0053712"
#> [3] "10.1371/journal.pone.0054608" "10.1371/journal.pone.0055937"
#> 
#> $bad
#> NULL

Some good, some bad

dois <- c("10.1016/j.medpal.2008.12.005","10.1080/00933104.2000.10505926","10.1037/a0024480",
        "10.1002/anie.196603172","2344","asdf","232","asdf","23dd")
check_dois(dois)
#> $good
#> [1] "10.1016/j.medpal.2008.12.005"   "10.1080/00933104.2000.10505926"
#> [3] "10.1037/a0024480"               "10.1002/anie.196603172"        
#> 
#> $bad
#> [1] "2344" "asdf" "232"  "asdf" "23dd"

Basic search

orcid_doi(dois = "10.1087/20120404")
#> [[1]]
#> # A tibble: 11 x 3
#>    `orcid-identifier.uri`         `orcid-identifier.p… `orcid-identifier.h…
#>  * <chr>                          <chr>                <chr>               
#>  1 https://orcid.org/0000-0002-6… 0000-0002-6914-8682  orcid.org           
#>  2 https://orcid.org/0000-0003-4… 0000-0003-4293-0137  orcid.org           
#>  3 https://orcid.org/0000-0001-7… 0000-0001-7343-9784  orcid.org           
#>  4 https://orcid.org/0000-0001-5… 0000-0001-5727-2427  orcid.org           
#>  5 https://orcid.org/0000-0003-0… 0000-0003-0187-9064  orcid.org           
#>  6 https://orcid.org/0000-0002-2… 0000-0002-2123-6317  orcid.org           
#>  7 https://orcid.org/0000-0003-1… 0000-0003-1603-8743  orcid.org           
#>  8 https://orcid.org/0000-0003-3… 0000-0003-3188-6273  orcid.org           
#>  9 https://orcid.org/0000-0002-5… 0000-0002-5993-8592  orcid.org           
#> 10 https://orcid.org/0000-0001-5… 0000-0001-5109-3700  orcid.org           
#> 11 https://orcid.org/0000-0003-1… 0000-0003-1419-2405  orcid.org           
#> 
#> attr(,"class")
#> [1] "orcid_doi"

This DOI is not a real one, but a partial DOI, then we can fuzzy search

orcid_doi(dois = "10.1087/2", fuzzy = TRUE, rows = 5)
#> [[1]]
#> # A tibble: 5 x 3
#>   `orcid-identifier.uri`         `orcid-identifier.pa… `orcid-identifier.h…
#> * <chr>                          <chr>                 <chr>               
#> 1 https://orcid.org/0000-0001-6… 0000-0001-6971-1351   orcid.org           
#> 2 https://orcid.org/0000-0001-6… 0000-0001-6081-0708   orcid.org           
#> 3 https://orcid.org/0000-0001-5… 0000-0001-5919-8670   orcid.org           
#> 4 https://orcid.org/0000-0001-6… 0000-0001-6555-0837   orcid.org           
#> 5 https://orcid.org/0000-0002-6… 0000-0002-6914-8682   orcid.org           
#> 
#> attr(,"class")
#> [1] "orcid_doi"

Function is vectorized, search for many DOIs

dois <- c("10.1371/journal.pone.0025995","10.1371/journal.pone.0053712",
       "10.1371/journal.pone.0054608","10.1371/journal.pone.0055937")
res <- orcid_doi(dois = dois, fuzzy = TRUE)
res[[1]]
#> # A tibble: 100 x 3
#>    `orcid-identifier.uri`         `orcid-identifier.p… `orcid-identifier.h…
#>  * <chr>                          <chr>                <chr>               
#>  1 https://orcid.org/0000-0002-0… 0000-0002-0051-973X  orcid.org           
#>  2 https://orcid.org/0000-0001-6… 0000-0001-6577-5526  orcid.org           
#>  3 https://orcid.org/0000-0001-8… 0000-0001-8887-5095  orcid.org           
#>  4 https://orcid.org/0000-0002-2… 0000-0002-2355-6760  orcid.org           
#>  5 https://orcid.org/0000-0001-7… 0000-0001-7669-0325  orcid.org           
#>  6 https://orcid.org/0000-0003-2… 0000-0003-2574-4201  orcid.org           
#>  7 https://orcid.org/0000-0003-4… 0000-0003-4683-9648  orcid.org           
#>  8 https://orcid.org/0000-0002-9… 0000-0002-9358-3983  orcid.org           
#>  9 https://orcid.org/0000-0002-5… 0000-0002-5634-6145  orcid.org           
#> 10 https://orcid.org/0000-0001-7… 0000-0001-7563-4495  orcid.org           
#> # … with 90 more rows

Get formatted citations for an ORCID ID

One workflow is to get publications associated with an ORCID profile. The following will extract all the works with a DOI, then use the rcrossref package to get nicely formatted references for each, and then export them to a bibtex file

my_dois <- rorcid::identifiers(rorcid::works("0000-0002-0337-5997"))
pubs <- rcrossref::cr_cn(dois = my_dois, format = "bibtex")
invisible(lapply(pubs, write, "pubs.bib", append=TRUE))