artsy.net APIwww.artsy.net ↗
Access 300,000+ artist profiles, auction listings, and gallery shows from Artsy. Browse alphabetically, search by name, and retrieve bios, genres, and artwork counts.
curl -X GET 'https://api.parse.bot/scraper/432d8fd8-0d14-4c65-831d-e06c39b39a25/list_artists?page=1&size=3&letter=z' \ -H 'X-API-Key: $PARSE_API_KEY'
List artists with optional letter filtering and pagination. Returns artists alphabetically with basic info including nationality and formatted date labels.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (1-based). |
| size | integer | Number of artists per page (max 100). |
| letter | string | Filter by first letter (a-z). Omit to list all artists. |
{
"type": "object",
"fields": {
"page": "current page number",
"count": "number of artists in this page",
"letter": "filter letter applied or 'all'",
"artists": "array of artist objects with internal_id, name, slug, href, nationality, birthday, deathday, formatted_label",
"total_count": "total artists matching filter",
"total_pages": "total pages available (max 100)",
"has_next_page": "boolean indicating more pages exist"
},
"sample": {
"data": {
"page": 1,
"count": 1,
"letter": "z",
"artists": [
{
"href": "/artist/navid-z-alizadeh",
"name": "Navid Z. Alizadeh",
"slug": "navid-z-alizadeh",
"birthday": "",
"deathday": "",
"internal_id": "5f77305286ac9800123dc895",
"nationality": "Iranian",
"formatted_label": "Iranian"
}
],
"total_count": 3622,
"total_pages": 100,
"has_next_page": true
},
"status": "success"
}
}About the artsy.net API
The Artsy API provides 5 endpoints covering artists, auctions, and gallery shows from Artsy's database of over 300,000 artists. The get_artist endpoint returns detailed profiles including biography fields, genre classifications, artwork counts, and nationality. list_artists supports alphabetical letter filtering and pagination, while search_artists, search_auctions, and search_shows return keyword-matched results with images and metadata.
Artist Browsing and Search
The list_artists endpoint accepts optional letter (a–z), page, and size parameters and returns an array of artist objects. Each object includes name, slug, nationality, birthday, deathday, and a formatted_label suitable for display. Pagination metadata (total_count, total_pages, has_next_page) is included in every response. The maximum page depth is 100, and each request can return up to 100 artists.
The search_artists endpoint accepts a query string and returns up to 7 matching artists. Results include image_url, has_artworks, and has_auction_lots flags alongside the standard name and href fields — useful for quickly determining whether an artist has available works or sale history before fetching a full profile.
Artist Detail Profiles
The get_artist endpoint takes an artist slug (e.g. pablo-picasso) and returns a structured profile. Key fields include genes (an array of genre and category strings such as "Impressionism" or "Photography"), counts (integers for follows, forSaleArtworks, and total artworks), gender, hometown, birthday, deathday, and an awards string. This endpoint provides the most complete view of an individual artist available in the API.
Auctions and Shows
The search_auctions and search_shows endpoints both accept a keyword query and return up to 10 matching results. Each result includes name, href, image_url, slug, internal_id, and a description field. These endpoints are useful for discovering active or past sale events and exhibitions by medium, theme, or time period — for example, querying photography or contemporary to surface relevant auctions and gallery shows.
- Build an artist discovery tool that browses Artsy's catalog alphabetically using
list_artistswithletterfiltering. - Populate an autocomplete search field for artist names using
search_artistswith real-timequeryinput. - Display structured artist profile pages using
get_artistfields:genes,counts,nationality, andhometown. - Track for-sale artwork availability per artist using the
counts.forSaleArtworksfield fromget_artist. - Surface relevant auction events by medium or theme using
search_auctionswith keyword queries like 'prints' or 'contemporary'. - Index gallery show metadata including images and descriptions using
search_showsfor exhibition discovery features. - Cross-reference artist genre classifications from the
genesarray to build category-based browsing in an art database.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Artsy have an official developer API?+
What does `get_artist` return beyond basic name and nationality?+
genes (an array of genre/category strings), counts with integers for total artworks, for-sale artworks, and follows, plus gender, hometown, awards, birthday, and deathday. The slug field is the value you pass as artist_id to call the endpoint.How deep can I paginate in `list_artists`?+
total_pages value is capped at 100 regardless of how many artists match the filter. Each page supports up to 100 results via the size parameter, so the maximum addressable set per letter filter is 10,000 artists. The has_next_page boolean in each response indicates whether another page exists.Can I retrieve individual artworks or lot results for a specific artist?+
Do `search_auctions` and `search_shows` support filtering by date or location?+
query keyword string and return up to 10 results. Date range and geographic filtering are not supported parameters. You can fork this API on Parse and revise it to add date or location parameters to those endpoints.