Retrieves the most recently uploaded artworks for an artist. Use this to populate "Recent Works" grids on profile pages or homepage features.
Returns lightweight artwork metadata (no stats or analytics). For full
artwork data including performance metrics, use get_appdata() or query
individual artwork functions.
Arguments
- artist
Character. Artist UUID (format:
"746bxxxx-xxxx-xxxx-xxxxxxxxxxxx"). Validated withartcore::validate_uuid()where applicable.- limit
Integer. Maximum number of artworks to return. Default 6 is optimized for a 2x3 grid layout. Use 9 for 3x3 grids.
- 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
data.table with columns:
- art_uuid
Artwork identifier
- art_name
URL-friendly name
- art_title
Display title
- collection_uuid
Parent collection
- created_utc
Upload timestamp
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_stats(),
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{
recent <- get_artist_recent_works(artist, limit = 9)
# Build thumbnail URLs
recent[, thumb := path_artwork_thumb(artist, art_uuid)]
} # }