retrievalByAuthorID: Get Author Content on SCOPUS by ID

In massimoaria/bibliometrix: Comprehensive Science Mapping Analysis

Get Author Content on SCOPUS by ID

Description

Uses SCOPUS API search to get information about documents on a set of authors using SCOPUS ID.

Usage

retrievalByAuthorID(id, api_key, remove.duplicated = TRUE, country = TRUE)

Arguments

id	is a vector of characters containing the author's SCOPUS IDs. SCOPUS IDs con be obtained using the function idByAuthor.
api_key	is a character. It contains the Elsvier API key. Information about how to obtain an API Key Elsevier API website
remove.duplicated	is logical. If TRUE duplicated documents will be deleted from the bibliographic collection.
country	is logical. If TRUE authors' country information will be downloaded from SCOPUS.

Value

a list containing two objects: (i) M which is a data frame with cases corresponding to articles and variables to main Field Tags named using the standard ISI WoS Field Tag codify. M includes the entire bibliographic collection downloaded from SCOPUS. The main field tags are:

AU		Authors
TI		Document Title
SO		Publication Name (or Source)
DT		Document Type
DE		Authors' Keywords
ID		Keywords associated by SCOPUS or ISI database
AB		Abstract
C1		Author Address
RP		Reprint Address
TC		Times Cited
PY		Year
UT		Unique Article Identifier
DB		Database

(ii) authorDocuments which is a list containing a bibliographic data frame for each author.

LIMITATIONS: Currently, SCOPUS API does not allow to download document references. As consequence, it is not possible to perform co-citation analysis (the field CR is empty).

See Also

idByAuthor for downloading author information and SCOPUS ID.

Examples

## Request a personal API Key to Elsevier web page https://dev.elsevier.com/sc_apis.html

## api_key="your api key"

## create a data frame with the list of authors to get information and IDs
# i.e. df[1,1:3] <- c("aria","massimo","naples")
#      df[2,1:3] <- c("cuccurullo","corrado", "naples")

## run idByAuthor function
#
# authorsID <- idByAuthor(df, api_key)
#

## extract the IDs
# 
# id <- authorsID[,3]
#

## create the bibliographic collection
# 
# res <- retrievalByAuthorID(id, api_key)
#
# M <- res$M  # the entire bibliographic data frame
# M <- res$authorDocuments # the list containing a bibliographic data frame for each author

massimoaria/bibliometrix documentation built on Dec. 12, 2024, 12:47 p.m.