# Artsy Artworks API

> Artsy artworks for sale with prices, artists, gallery shows and art fairs

- Vendor: `artsyartworksapi` · version 1.0 · category E-commerce · tags artsy api, artworks api, art market api, art prices api, artist api, art fairs api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/artsyartworksapi
- This document: https://apiclay.com/docs/artsyartworksapi.md
- OpenAPI 3.1: https://apiclay.com/api/artsyartworksapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `artsyartworksapi`
- Updated: 2026-11-18

## About

## Artsy Artworks API

Read Artsy (artsy.net), the online art marketplace: browse artworks newest first or by artist, medium, price range and availability, with sale price or status, dimensions, image and gallery; open one artwork with description, provenance and exhibition history; read an artist's bio, dates and artwork counts; search artists and artworks by name; and list running gallery shows and current art fairs.

Data comes from **artsy.net** (https://www.artsy.net). Every route calls the source's own public JSON endpoint (found with the live-URL scan of https://www.artsy.net) and returns it unchanged.

Typical flow: `/search` with `banksy` for an artist slug, `/artworks` with that slug in `artistIDs`, then `/artwork` with an artwork `slug`.

### Routes

Every route is a POST with a JSON body `{"variables": {...}}`; the GraphQL query is fixed.

#### POST `/artworks` - Artworks
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| variables.first | body | number | no | Artworks per page, e.g. 20. |
| variables.after | body | string | no | `pageInfo.endCursor` from the previous page. |
| variables.sort | body | string | no | `-published_at` (newest), `-decayed_merch` (featured), `-prices`, `prices`. |
| variables.artistIDs | body | array | no | Artist slugs or ids, e.g. `["andy-warhol"]`. |
| variables.medium | body | string | no | `painting`, `photography`, `sculpture`, `prints`, `drawing`, `design`. |
| variables.forSale | body | boolean | no | Only artworks for sale. |
| variables.priceRange | body | string | no | USD range, e.g. `1000-50000` or `*-5000`. |

Returns: `data.artworksConnection` (`counts.total`, `pageInfo`, `edges[].node` with `slug`, `title`, `date`, `medium`, `category`, `artistNames`, `saleMessage`, `isForSale`, `dimensions`, `image.url`, `partner.name`).

#### POST `/artwork` - Artwork
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| variables.id | body | string | yes | Artwork `slug` from `/artworks`. |

Returns: `data.artwork` with `saleMessage`, `isSold`, `editionOf`, `description`, `provenance`, `exhibitionHistory`, `image` (`url`, `width`, `height`), `artists`, `partner`.

#### POST `/artist` - Artist
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| variables.id | body | string | yes | Artist slug, e.g. `andy-warhol`. |

Returns: `data.artist` (`name`, `nationality`, `birthday`, `deathday`, `hometown`, `location`, `biographyBlurb.text`, `counts` (`artworks`, `forSaleArtworks`, `follows`), `image.url`).

#### POST `/search` - Search
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| variables.term | body | string | yes | Search text. |
| variables.first | body | number | no | Results, e.g. 10. |
| variables.entities | body | array | no | `ARTIST`, `ARTWORK`, `GALLERY`, `FAIR`, `SHOW`, `ARTICLE`. |

Returns: `data.searchConnection.edges[].node` (`__typename`, `displayLabel`, `href`, `slug`).

#### POST `/shows` - Running shows
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| variables.first | body | number | no | Shows per page. |
| variables.after | body | string | no | `pageInfo.endCursor` from the previous page. |

Returns: `data.showsConnection.edges[].node` (`slug`, `name`, `startAt`, `endAt`, `partner.name`, `location` (`city`, `country`)), newest first.

#### POST `/fairs` - Art fairs
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| variables.first | body | number | no | Fairs per page. |
| variables.after | body | string | no | `pageInfo.endCursor` from the previous page. |

Returns: `data.fairsConnection.edges[].node` (`slug`, `name`, `startAt`, `endAt`, `location`), newest first.

### Caveats

- Prices are set by the selling galleries and auction houses and may be in currencies other than USD; artwork images and texts belong to Artsy, the galleries and the artists.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by artsy.net.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### POST /artworks — Artworks
- Gateway: `POST https://api.apiclay.com/v1/api/artsyartworksapi/artworks`
- Body sample (JSON):

```json
{"variables": {"first": 20, "sort": "-published_at", "medium": "painting", "forSale": true}}
```

- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /artwork — Artwork
- Gateway: `POST https://api.apiclay.com/v1/api/artsyartworksapi/artwork`
- Body sample (JSON):

```json
{"variables": {"id": "andy-warhol-15-dollars-1"}}
```

- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /artist — Artist
- Gateway: `POST https://api.apiclay.com/v1/api/artsyartworksapi/artist`
- Body sample (JSON):

```json
{"variables": {"id": "andy-warhol"}}
```

- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /search — Search
- Gateway: `POST https://api.apiclay.com/v1/api/artsyartworksapi/search`
- Body sample (JSON):

```json
{"variables": {"term": "banksy", "first": 10, "entities": ["ARTIST", "ARTWORK"]}}
```

- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /shows — Shows
- Gateway: `POST https://api.apiclay.com/v1/api/artsyartworksapi/shows`
- Body sample (JSON):

```json
{"variables": {"first": 20}}
```

- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /fairs — Fairs
- Gateway: `POST https://api.apiclay.com/v1/api/artsyartworksapi/fairs`
- Body sample (JSON):

```json
{"variables": {"first": 20}}
```

- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X POST "https://api.apiclay.com/v1/api/artsyartworksapi/artworks" \
  -H "token: <YOUR_APICLAY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"variables": {"first": 20, "sort": "-published_at", "medium": "painting", "forSale": true}}'
```

Index of every published API: https://apiclay.com/llms.txt
