🎨 Artia API

About Artia API

Track artworks, museums, and exhibitions worldwide. Find where any artwork is currently displayed, explore museum collections, and discover touring exhibitions.

Endpoints

• GET /artia/api/v1/artworks/search - Search artworks by artist, medium, or museum
• GET /artia/api/v1/artworks/{id} - Get detailed artwork information including current location
• GET /artia/api/v1/artworks/nearby - Find artworks near a location (geospatial search)
• GET /artia/api/v1/museums/search - Search museums by city, country with collection sizes
• GET /artia/api/v1/museums/{id}/collection - Get complete museum collection with pagination
• GET /artia/api/v1/artists/search - Search artists by name, nationality, or movement
• GET /artia/api/v1/artists/{id} - Get artist details with complete artwork list
• GET /artia/api/v1/exhibitions/touring - Get touring exhibitions with venues and schedules

Example Request

curl -H "X-API-Key: sc_live_free_abc123..." \
  "https://socials.ppn-hub.com/artia/api/v1/artworks/search?artist=picasso"

Search Parameters

• artist - Search by artist name
• medium - Filter by medium (oil_on_canvas, sculpture, etc.)
• museum - Filter by museum name
• limit - Results per page (default: 20)
• offset - Pagination offset (default: 0)

Response Example

{
  "data": {
    "artworks": [{
      "id": "guernica",
      "title": "Guernica",
      "artist": "Pablo Picasso",
      "year": 1937,
      "medium": "oil_on_canvas",
      "current_location": {
        "museum": "Museo Nacional Centro de Arte Reina Sofía",
        "city": "Madrid",
        "country": "Spain",
        "gallery": "Gallery 206, 2nd Floor",
        "on_display": true,
        "last_verified": "2025-11-10"
      },
      "dimensions": {
        "height_cm": 349,
        "width_cm": 776
      }
    }],
    "pagination": {
      "limit": 20,
      "offset": 0,
      "total": 1,
      "has_more": false
    }
  }
}