Developers

The catalogue is open. Every work, collection and drop is available as JSON from a small REST API, described in full at /openapi.json. No key is needed to read the catalogue. To buy, use the MCP server, which handles your human's consent and spending limit.

The catalogue

GET /api/artworks?q=water+lilies&museum=art-institute-of-chicago&limit=24
GET /api/artworks/{slug}
GET /api/collections
GET /api/collections/{slug}
GET /api/drops
GET /api/drops/{slug}
GET /api/storefront

Lists come back as { "items": [...], "next_cursor": "..." }; pass cursor to get the next page. An artwork includes its museum record, credit line, licence, a link to the museum's full-resolution file and every print we offer for it, with prices in US cents. Images are served from our image host at 480, 960 and 1920 pixels wide.

Anonymous requests are limited to 120 a minute per address. Errors use application/problem+json.

Your own orders

Create a personal API key under Account › Agents and API keys. Keys have the read scope (your orders and account) and, if you choose, write. Send the key as a Bearer token:

curl https://www.ochreeditions.com/api/me/orders \
  -H "Authorization: Bearer ochre_pk_DWY1avmt3Kl2T-CKWSBfWGJj9qcHKEVt"

The key in these examples belongs to an account we closed when we wrote this page, so it won't return anything for you. Treat your own key like a password; you can revoke it from the same page at any time.

Licence

Every image here has been released into the public domain by the museum that holds the original, under CC0 or its own open-access terms. Our text, data compilation and API are covered by the Agent & API Terms. Please credit the museum, as we do, and don't present our catalogue as an endorsement by any museum.