Get portfolio counts for profile headers and badges

Retrieves aggregate counts for an artist's portfolio. Use this for profile headers and stat badges where you need artwork/collection totals without loading the full artwork list.

This is more efficient than counting results from get_artist_recent_works() or get_artist_collections_summary() when you only need the counts.

For detailed per-artwork statistics, use get_appdata() instead.

Usage

get_artist_stats(artist, cn = NULL)

Arguments

artist

Character. Artist UUID (format: "746bxxxx-xxxx-xxxx-xxxxxxxxxxxx"). Validated with artcore::validate_uuid() where applicable.

cn

Database connection. If NULL, creates a connection via artcore::dbc() and closes it on exit. Pass an existing connection to batch multiple queries efficiently.

Value

Named list with:

artworks

Total artwork count

collections

Total collection count

member_since

Artist registration date (POSIXct)

See also

Other data-access: art_has_nft(), db-frame-analytics, get_art_opensea_url(), get_art_print_url(), get_art_purchase_urls(), get_artist_by_slug(), get_artist_collections_summary(), get_artist_index(), get_artist_opensea(), get_artist_recent_works(), get_artist_style_map(), get_artist_tags(), get_artwork_index(), get_artwork_meta(), get_artwork_opensea(), get_artwork_profile(), get_artwork_profile_full(), get_artwork_stats(), get_color_codes(), get_verification_info()

Examples

if (FALSE) { # \dontrun{
stats <- get_artist_stats(artist)
cat(stats$artworks, "artworks in", stats$collections, "collections\n")
cat("Member since", format(stats$member_since, "%B %Y"), "\n")
} # }