artists
GET /api/artists
Retrieve a collection of artists.
Request
- Base URLhttps://api.artsy.net
- Authnone declared
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
artwork_idstring
Return artists for a given artwork.
sale_idstring
Return artists appearing in a given sale
similar_to_artist_idstring
Return artists similar to a given artist.
similarity_type'default' | 'contemporary'
Similarity type.
gene_idstring
Return a set of artists that represent a given gene.
artworksboolean
Only return artists with artworks.
published_artworksboolean
Only return artists with published artworks.
partner_idstring
Return artists with artworks that belong to the partner.
sort'_slugs' | '-_slugs' | 'created_at' | '-created_at' | 'sortable_id' | '-sortable_id' | '-trending'
Sort order.
offsetinteger
Offset from which to retrieve.
sizeinteger
Maximum number of items to retrieve.
cursorstring
Cursor for pagination.
samplestring
If present and collection supports sampling, will redirect to a random single object.
termstring
Term to match.
pageinteger
Page to retrieve.
exactboolean
Find an exact match.
Response
Retrieve a collection of artists.
Changes
No recorded changes to this operation across all 1 revision of this API.