Documentation > Resources > Artists

Artists API

An artist creates artworks.

An artist is generally one person, but can also be two people collaborating, a collective of people, or even a mysterious entity such as "Banksy".

Retrieving Artists

Retrieve artists by following the artists link from root.

curl -v "https://api.artsy.net/api/artists" -H "X-XAPP-Token:..."

This endpoint accepts the following parameters.

Name Value
artwork_id Retrieve artists for a given artwork.
similar_to_artist_id Return artists similar to a given artist.
similarity_type Similarity type, either default or contemporary. See below.
gene_id Return a set of artists that represent a given gene.
artworks Only return artists with artworks.
published_artworks Only return artists with published artworks.
partner_id Return artists with artworks that belong to the partner.

The response is a paginated result with embedded artists.

Retrieving an Artist

Users can retrieve a specific artist by ID by rendering the "artist" link template from root.

curl -v "https://api.artsy.net/api/artists/{id}" -H "X-XAPP-Token:..."

Retrieving an Artwork's Artists

Follow the "artists" link from an artwork, which calls this endpoint with the artwork_id parameter.

Retrieving Similar Artists

Artsy continuously computes a K-nearest-neighbor graph for artists using data from the Art Genome Project. Retrieve artists similar to another artist by following the "similar_artists" or the "similar_contemporary_artists" links in an artist resource, which calls this endpoint with the similar_to_artist_id parameter and an optional similarity_type value. The response is a non-paginated set of similar artists or similar contemporary artists, respectively.

Artist JSON Format

Key Description
id Unique id.
slug Unique slug.
created_at Timestamp of when the record was created.
updated_at Timestamp of when the record was last updated.
name The name the artist most commonly uses.
sortable_name A combination of last, middle first or otherwise a sortable name.
gender Gender, typically "male" or "female".
birthday Date or time period when the artist was born.
hometown The city in which the artist was born.
location The city in which the artist is currently working.
nationality The country that best defines this artist.
image_versions Available image versions.

Links

Key Target
self The artist resource.
thumbnail Default image thumbnail.
image Curied image location.
permalink An external location on the artsy.net website.
artworks All artist's artworks.
similar_artists Artists similar to this artist.
similar_contemporary_artists Contemporary artists similar to this artist.

Example

{
  "id": "4d8b92b34eb68a1b2c0003f4",
  "slug": "andy-warhol",
  "created_at": "2010-08-23T14:15:30+00:00",
  "updated_at": "2017-08-17T17:30:45+00:00",
  "name": "Andy Warhol",
  "sortable_name": "Warhol Andy",
  "gender": "male",
  "birthday": "1928",
  "hometown": "Pittsburgh, Pennsylvania",
  "location": "New York, New York",
  "nationality": "American",
  "image_versions": [
    "four_thirds",
    "large",
    "square",
    "tall"
  ],
  "_links": {
    "thumbnail": {
      "href": "https://d32dm0rphc51dk.cloudfront.net/PFufT6nMKNwLOpPEezf4Ww/four_thirds.jpg"
    },
    "image": {
      "href": "https://d32dm0rphc51dk.cloudfront.net/PFufT6nMKNwLOpPEezf4Ww/{image_version}.jpg",
      "templated": true
    },
    "self": {
      "href": "https://api.artsy.net/api/artists/4d8b92b34eb68a1b2c0003f4"
    },
    "permalink": {
      "href": "http://www.artsy.net/artist/andy-warhol"
    },
    "artworks": {
      "href": "https://api.artsy.net/api/artworks?artist_id=4d8b92b34eb68a1b2c0003f4"
    },
    "published_artworks": {
      "href": "https://api.artsy.net/api/artworks?artist_id=4d8b92b34eb68a1b2c0003f4&published=true"
    },
    "similar_artists": {
      "href": "https://api.artsy.net/api/artists?similar_to_artist_id=4d8b92b34eb68a1b2c0003f4"
    },
    "similar_contemporary_artists": {
      "href": "https://api.artsy.net/api/artists?similar_to_artist_id=4d8b92b34eb68a1b2c0003f4&similarity_type=contemporary"
    },
    "genes": {
      "href": "https://api.artsy.net/api/genes?artist_id=4d8b92b34eb68a1b2c0003f4"
    }
  }
}