orcidtr (version 0.1.0)

orcid_external_identifiers: Retrieve external identifiers from ORCID

Description

Fetches external identifier mappings for an ORCID record, such as Scopus Author ID, ResearcherID, Loop profile, and other researcher identification systems.

Usage

orcid_external_identifiers(orcid_id, token = NULL)

Value

A data.table with the following columns:

orcid

ORCID identifier

put_code

Unique identifier for this external ID

external_id_type

Type of external identifier (e.g., "Scopus Author ID")

external_id_value

The identifier value

external_id_url

URL to the external profile (if available)

Returns an empty data.table with the same structure if no external identifiers are found.

Arguments

orcid_id

Character string. A valid ORCID identifier in the format XXXX-XXXX-XXXX-XXXX. Can also handle URLs like https://orcid.org/XXXX-XXXX-XXXX-XXXX.

token

Character string or NULL. Optional API token for authenticated requests. If NULL (default), checks the ORCID_TOKEN environment variable.

Details

This function queries the ORCID public API endpoint: https://pub.orcid.org/v3.0/{orcid-id}/external-identifiers

References

ORCID API Documentation: https://info.orcid.org/documentation/api-tutorials/

See Also

orcid_person

Examples

if (FALSE) {
# Fetch external identifiers
ext_ids <- orcid_external_identifiers("0000-0002-1825-0097")
print(ext_ids)
}