ArtGraph
Log inGet started

API Reference

Access 158K artists, 1.6M artworks, 23K exhibitions, and galleries via REST or MCP.

Authentication

All requests require your API key in the X-API-Key header. Find your key in the dashboard.

curl https://api.art-graph.com/v1/artists \
  -H "X-API-Key: ag_your_key_here"

Base URL

https://api.art-graph.com

All REST endpoints are under /v1/.

Rate Limits

Default limit is 60 requests/minute per API key. Exceeding this returns HTTP 429.

TierMonthly quotaMax results/page
Free5010
Pro2,500100
Business15,000100

Artists

GET/v1/artists

Search and filter artists. Returns paginated results.

Query parameters

qstringName search (case-insensitive)
nationalitystringFilter by nationality
art_movementstringFilter by art movement
genderstringFilter by gender
birth_year_fromintegerMinimum birth year
birth_year_tointegerMaximum birth year
limitintegerResults per page (max 10 Free, 100 Pro+)
offsetintegerPagination offset

Example request

curl "https://api.art-graph.com/v1/artists?q=monet&nationality=French&limit=5" \
  -H "X-API-Key: ag_your_key_here"

Example response

{
  "items": [
    {
      "id": 1842,
      "full_name": "Claude Monet",
      "nationality": "French",
      "birth_year": 1840,
      "death_year": 1926,
      "art_movement": "Impressionism",
      "bio": "French impressionist painter...",
      "country": "France"
    }
  ],
  "total": 1,
  "limit": 5,
  "offset": 0
}
GET/v1/artists/{id}

Get full details for a single artist including social links and contact info.

Example request

curl "https://api.art-graph.com/v1/artists/1842" \
  -H "X-API-Key: ag_your_key_here"

Example response

{
  "id": 1842,
  "full_name": "Claude Monet",
  "nationality": "French",
  "birth_year": 1840,
  "death_year": 1926,
  "art_movement": "Impressionism",
  "bio": "French impressionist painter known for...",
  "country": "France",
  "social_links": [
    { "platform": "wikipedia", "url": "https://..." }
  ]
}

Artworks

GET/v1/artworksFree+

Search artworks with filters. Price fields require Pro tier.

Query parameters

qstringTitle search (case-insensitive)
artist_idintegerFilter by artist
mediumstringFilter by medium (e.g. "oil on canvas")
artwork_typestringFilter by type (e.g. "painting")
year_fromintegerEarliest creation year
year_tointegerLatest creation year
is_availablebooleanOnly available works
price_maxnumberMaximum price (Pro+)
limitintegerResults per page
offsetintegerPagination offset

Example request

curl "https://api.art-graph.com/v1/artworks?artist_id=1842&year_from=1890&limit=5" \
  -H "X-API-Key: ag_your_key_here"

Example response

{
  "items": [
    {
      "id": 98231,
      "title": "Water Lilies",
      "artist_id": 1842,
      "year": 1906,
      "medium": "Oil on canvas",
      "artwork_type": "Painting",
      "images": [
        { "url": "https://...", "width": 1200, "height": 900 }
      ]
    }
  ],
  "total": 47,
  "limit": 5,
  "offset": 0
}
GET/v1/artworks/{id}

Full artwork detail including all images, provenance, and price data (Pro+).

Example request

curl "https://api.art-graph.com/v1/artworks/98231" \
  -H "X-API-Key: ag_your_key_here"

Example response

{
  "id": 98231,
  "title": "Water Lilies",
  "artist_id": 1842,
  "year": 1906,
  "medium": "Oil on canvas",
  "artwork_type": "Painting",
  "price": 85000000,
  "currency": "USD",
  "is_available": false,
  "provenance": "...",
  "images": [...]
}

Exhibitions

GET/v1/exhibitions

Browse exhibitions with optional filters.

Query parameters

venuestringFilter by venue name
locationstringFilter by city/country
artist_idintegerFilter by featured artist
year_fromintegerStart year filter
year_tointegerEnd year filter
exhibition_typestringsolo, group, fair, etc.
limitintegerResults per page
offsetintegerPagination offset

Example request

curl "https://api.art-graph.com/v1/exhibitions?artist_id=1842&year_from=1900" \
  -H "X-API-Key: ag_your_key_here"

Example response

{
  "items": [
    {
      "id": 441,
      "title": "Monet: The Series Paintings",
      "venue": "Royal Academy of Arts",
      "location": "London, UK",
      "start_year": 1990,
      "exhibition_type": "solo"
    }
  ],
  "total": 12,
  "limit": 20,
  "offset": 0
}

Galleries

GET/v1/galleries

Search galleries and art dealers.

Query parameters

namestringGallery name search
countrystringFilter by country
gallery_typestringcommercial, museum, auction, etc.
limitintegerResults per page
offsetintegerPagination offset

Example request

curl "https://api.art-graph.com/v1/galleries?country=France&limit=5" \
  -H "X-API-Key: ag_your_key_here"

Example response

{
  "items": [
    {
      "id": 77,
      "name": "Galerie Durand-Ruel",
      "country": "France",
      "gallery_type": "commercial"
    }
  ],
  "total": 340,
  "limit": 5,
  "offset": 0
}

Bulk Export

Requires Business tier. Rate limited to 10 requests/hour.

Export endpoints stream results as NDJSON (newline-delimited JSON) — one record per line, no pagination needed.

GET/v1/export/artistsBusiness+

Stream all artists matching the given filters as NDJSON.

Query parameters

qstringName filter
nationalitystringNationality filter
art_movementstringMovement filter

Example request

curl "https://api.art-graph.com/v1/export/artists?nationality=French" \
  -H "X-API-Key: ag_your_key_here" \
  > french_artists.ndjson

Example response

{"id":1842,"full_name":"Claude Monet","nationality":"French",...}
{"id":2103,"full_name":"Edgar Degas","nationality":"French",...}
...
GET/v1/export/artworksBusiness+

Stream all artworks matching the given filters as NDJSON.

Query parameters

artist_idintegerFilter by artist
mediumstringMedium filter
year_fromintegerEarliest year
year_tointegerLatest year

Example request

curl "https://api.art-graph.com/v1/export/artworks?artist_id=1842" \
  -H "X-API-Key: ag_your_key_here" \
  > monet_artworks.ndjson

Example response

{"id":98231,"title":"Water Lilies","year":1906,...}
{"id":98232,"title":"Haystacks","year":1891,...}
...

MCP Server

Connect AI assistants directly to ArtGraph via the Model Context Protocol (SSE transport). The MCP server exposes 8 tools that mirror the REST API.

Endpoint

https://api.art-graph.com/mcp/sse

Claude Desktop config

{
  "mcpServers": {
    "atelier": {
      "url": "https://api.art-graph.com/mcp/sse",
      "headers": {
        "X-API-Key": "ag_your_key_here"
      }
    }
  }
}

Available tools

search_artistsSearch artists by name, nationality, movement, birth year
get_artistGet full artist profile by ID
search_artworksSearch artworks by title, artist, medium, year range
get_artworkGet full artwork detail by ID
list_exhibitionsList exhibitions with venue/location/artist filters
search_galleriesSearch galleries by name, country, type
list_mediumsList all available artwork mediums
list_artwork_typesList all available artwork types

Quota Response Headers

Every REST API response includes these headers:

X-Quota-LimitYour monthly query limit
X-Quota-UsedQueries used this month
X-Quota-RemainingQueries remaining this month
X-Quota-WarningAppears when usage exceeds 80% of limit