# ArtLovers.ai — Full Reference for AI Systems

> A multilingual art platform covering exhibitions, artists, artworks, and museum/gallery locations worldwide. Built for art lovers, curators, and travelers who want to discover art around the world.

## Site overview

ArtLovers.ai is a curated database of art exhibitions, artists, artworks, and cultural venues. All content is editorially managed and available in English and Spanish. The platform helps users:

- Find current and upcoming exhibitions in any city or country
- Discover artists by nationality, medium, or art movement
- Browse artworks by artist, genre, medium, or movement
- Locate museums and galleries with addresses, coordinates, and active exhibitions

## Content coverage

The database includes:
- Hundreds of art exhibitions across Europe and beyond, with dates, venues, and descriptions
- Artist profiles spanning classical to contemporary, with biographies and linked artworks
- Artwork records with dimensions, creation dates, mediums, genres, and art movements
- Museum and gallery listings with addresses, GPS coordinates, websites, and ticket links

## URL structure

All pages are available in English (/en/) and Spanish (/es/).

### Detail pages
- Exhibition: https://artlovers.travel/en/exhibitions/{slug}
- Artist: https://artlovers.travel/en/artists/{slug}
- Artwork: https://artlovers.travel/en/artworks/{slug}
- Location: https://artlovers.travel/en/locations/{slug}

### List pages
- All exhibitions: https://artlovers.travel/en/exhibitions
- All artists: https://artlovers.travel/en/artists
- All artworks: https://artlovers.travel/en/artworks
- All locations: https://artlovers.travel/en/locations

### Geographic browse
- Exhibitions by country: https://artlovers.travel/en/exhibitions/in/spain
- Exhibitions by city: https://artlovers.travel/en/exhibitions/in/spain/madrid
- Museums by country: https://artlovers.travel/en/museums/spain
- Museums by city: https://artlovers.travel/en/museums/spain/madrid

### Browse by art movement
- Artists by movement: https://artlovers.travel/en/artists/movement/impressionism
- Artworks by movement: https://artlovers.travel/en/artworks/movement/cubism
- Exhibitions by movement: https://artlovers.travel/en/exhibitions/movement/surrealism

## Public API reference

Base URL: https://artlovers.travel/api
OpenAPI spec: https://artlovers.travel/openapi.yaml

All endpoints are GET, free, read-only, and require no authentication. All filter parameters are optional and case-insensitive.

### GET /api/exhibitions

Search art exhibitions by location and date range.

Parameters:
- country (string) — Country name, e.g. "Spain", "France"
- city (string) — City name, e.g. "Madrid", "Paris"
- dateFrom (string) — Start date in YYYY-MM-DD format
- dateTo (string) — End date in YYYY-MM-DD format
- lang (string) — Language code: "en" or "es" (default: "en")

Example: https://artlovers.travel/api/exhibitions?city=Barcelona&dateFrom=2025-06-01&dateTo=2025-06-30&lang=en

Response shape:
```json
{
  "exhibitions": [
    {
      "title": "Exhibition Name",
      "gallery": "Venue Name",
      "dates": "1 Jun 2025 - 30 Sep 2025",
      "url": "https://artlovers.travel/en/exhibitions/exhibition-slug",
      "websiteUrl": "https://venue-website.com/exhibition"
    }
  ],
  "searchUrl": "https://artlovers.travel/en/exhibitions/in/spain/barcelona",
  "totalResults": 15
}
```

### GET /api/artists

Search artists by nationality, medium, or art movement.

Parameters:
- nationality (string) — e.g. "Spanish", "French"
- medium (string) — e.g. "Oil painting", "Sculpture"
- movement (string) — e.g. "Impressionism", "Cubism"
- lang (string) — "en" or "es"

Example: https://artlovers.travel/api/artists?nationality=Spanish&movement=Cubism&lang=en

### GET /api/artworks

Search artworks by artist, medium, genre, or movement.

Parameters:
- artist (string) — Artist name (partial match), e.g. "Picasso"
- medium (string) — e.g. "Oil on canvas"
- genre (string) — e.g. "Portrait", "Landscape"
- movement (string) — e.g. "Impressionism"
- lang (string) — "en" or "es"

Example: https://artlovers.travel/api/artworks?artist=Picasso&lang=en

### GET /api/locations

Search museums and galleries by location.

Parameters:
- country (string) — e.g. "France"
- city (string) — e.g. "Paris"
- type (string) — e.g. "Museum", "Gallery"
- lang (string) — "en" or "es"

Example: https://artlovers.travel/api/locations?city=Paris&lang=en

## MCP Server

An MCP (Model Context Protocol) server is published on npm for use with Claude and other MCP-compatible AI clients.

Install: npx mcp-artlovers

Tools available:
- search_exhibitions — Search exhibitions by country, city, date range
- search_artists — Search artists by nationality, medium, movement
- search_artworks — Search artworks by artist, medium, genre, movement
- search_locations — Search museums/galleries by country, city

Configuration:
```json
{
  "mcpServers": {
    "artlovers": {
      "command": "npx",
      "args": ["mcp-artlovers"]
    }
  }
}
```

## Structured data

All detail pages include Schema.org JSON-LD:
- Exhibitions use ExhibitionEvent with name, startDate, endDate, location, image, organizer
- Artists use Person with name, birthDate, deathDate, nationality, image, sameAs
- Artworks use VisualArtwork with name, creator, dateCreated, artMedium, dimensions, image
- Locations use Museum with name, address, geo coordinates, image, sameAs

## Example queries this site can answer

- "What art exhibitions are happening in Paris right now?"
- "Where can I see Picasso's work in Barcelona?"
- "What museums are in Madrid?"
- "Who are the most notable Spanish Impressionist artists?"
- "What exhibitions are opening in London in March?"
- "Where is Guernica displayed?"
- "What galleries are in New York?"