Quick Start

Get up and running with the Artland Partner Sync API in 5 minutes.

Prerequisites

An Artland account (claimed artist or gallery)
An API key from Account → API Keys

Step 1: Verify Your Key

Start by confirming your API key works and check your access level:

curl https://api.artland.com/v1/me \
  -H "Authorization: Bearer ak_live_your_key_here"

Response:

{
  "key_prefix": "ak_live_a1b2",
  "label": "Gallery CMS Sync",
  "tier": "read_write",
  "scopes": ["artworks:write", "artists:write", "events:write", "profile:read"],
  "entity": { "type": "gallery", "id": 1, "name": "Gagosian" },
  "usage": { "reads_today": 0, "writes_today": 0, "daily_read_limit": null }
}

Step 2: Push Your First Artwork

Create an artwork with a permanent image URL:

curl -X POST https://api.artland.com/v1/artworks \
  -H "Authorization: Bearer ak_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Composition in Blue",
    "creation_year": 2024,
    "medium": "Oil on canvas",
    "dimensions": "120 × 90 cm",
    "price": 45000,
    "currency": "EUR",
    "availability": "available",
    "description": "Part of the Chromatic Series exploring color theory.",
    "image_url": "https://your-gallery.com/artworks/composition-blue.jpg",
    "external_url": "https://your-gallery.com/artworks/composition-blue",
    "artist_name": "Maria Schmidt"
  }'

Response:

{
  "id": 123,
  "title": "Composition in Blue",
  "source_fingerprint": "a1b2c3d4e5f6...",
  "created": true
}

Step 3: Verify the Sync

List your artworks to confirm:

curl https://api.artland.com/v1/artworks \
  -H "Authorization: Bearer ak_live_your_key_here"

Response:

{
  "artworks": [
    {
      "id": 123,
      "title": "Composition in Blue",
      "creation_year": 2024,
      "medium": "Oil on canvas",
      "price": 45000,
      "currency": "EUR",
      "availability": "available"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 50
}

What’s Next?

Sync more artworks — batch your catalog
Push events — publish exhibitions and openings
Update your profile — keep your info current
Set up MCP — integrate with AI assistants