orcidtr (version 0.1.0)

orcid_researcher_urls: Retrieve researcher URLs from ORCID

Description

Fetches professional and personal URLs associated with an ORCID record, such as personal websites, institutional profiles, social media, etc.

Usage

orcid_researcher_urls(orcid_id, token = NULL)

Value

A data.table with the following columns:

orcid

ORCID identifier

put_code

Unique identifier for this URL

url_name

Name/label for the URL

url_value

The actual URL

Returns an empty data.table with the same structure if no URLs 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}/researcher-urls

References

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

See Also

orcid_person, orcid_external_identifiers

Examples

if (FALSE) {
# Fetch researcher URLs
urls <- orcid_researcher_urls("0000-0002-1825-0097")
print(urls)
}