Elevate.Art API

Build on the future of art infrastructure

Quick Start

1

Get API Key

Sign up and generate your API key from the dashboard

Authorization: Bearer YOUR_API_KEY
2

Install SDK

Use our official SDKs for faster integration

npm install @elevate-art/sdk
3

Make First Call

Fetch artwork metadata with a simple API call

GET /v1/artworks/123

API Features

Metadata Standard v1.0

Comprehensive artwork metadata following institutional standards

Blockchain Verification

Cryptographic proof of authenticity and ownership history

Real-time Updates

Webhook notifications for artwork events and market changes

IPFS Integration

Decentralized storage for artwork images and documents

RESTful & GraphQL

Choose between REST API or GraphQL for flexible data queries

Comprehensive Docs

Detailed documentation with examples in multiple languages

Code Examples

JavaScript/TypeScript

import { ElevateClient } from '@elevate-art/sdk';

const client = new ElevateClient({
  apiKey: process.env.ELEVATE_API_KEY
});

// Fetch artwork with metadata
const artwork = await client.artworks.get('123');

// Update artwork metadata
await client.artworks.updateMetadata('123', {
  'elevate:artistControlled': {
    statement: 'Updated artist statement',
    tags: ['landscape', 'nature']
  }
});

// Verify artwork authenticity
const verification = await client.verify(artwork.id);
console.log('Trust score:', verification.trustScore);

Python

from elevate_art import ElevateClient

client = ElevateClient(
    api_key=os.environ['ELEVATE_API_KEY']
)

# Fetch artwork with metadata
artwork = client.artworks.get('123')

# Add verification event
verification = client.artworks.add_verification(
    artwork_id='123',
    method='Physical Inspection',
    provider='Certified Appraiser',
    confidence=0.98
)

# Search artworks by artist
results = client.artworks.search(
    artist='Jane Artist',
    style='Impressionist'
)

Core Endpoints

MethodEndpointDescription
GET/v1/artworksList artworks with filtering and pagination
GET/v1/artworks/:id/metadataGet complete metadata for an artwork
POST/v1/artworksCreate new artwork with metadata
PATCH/v1/artworks/:id/metadataUpdate artwork metadata fields
POST/v1/artworks/:id/verifyAdd verification event to artwork

Get Support

Join our developer community for help, updates, and to share what you're building.