Please note, we are in the process of retiring the public api. The public api, as well as its documentation and playground, may be taken down at any time without additional notice. This change will not affect integration partners using our partner api.
If you're an Artsy partner gallery, reach out to your Artsy Liaison or contact our Support team for assistance.
Public API Documentation > Resources > Genes
Think about an art object, say a painting by Andy Warhol. You might say it is a painting, that it is a work of Pop Art, that it is a silkscreen, that it features an image of Marilyn Monroe, that it is very high contrast, or even that it emphasizes the flatness of the image. These characteristics or terms (e.g. "Pop Art", "Flatness", "Bright Colors") are what we call genes.
Retrieve genes by following the genes link from root, or the "genes" links within an artwork or artist.
curl -v "https://stagingapi.artsy.net/api/genes/{id}" -H "X-XAPP-Token: XAPP_TOKEN"
This endpoint accepts the following parameters.
| Name | Value |
|---|---|
| artist_id | Retrieve genes for a given artist. |
| artwork_id | Retrieve genes for a given artwork. |
error: the server responded with status 404
| Key | Target |
|---|---|
| self | The gene resource. |
| thumbnail | Default image thumbnail. |
| image | Curied image location. |
| permalink | An external location on the artsy.net website. |
| artists | All artists that have this gene. |
| artworks | Public domain artworks that have this gene. |
| published_artworks | All published artworks that have this gene. |
error: the server responded with status 400