Princeton University Art Museum API

Open, REST-style API providing developer access to data about the Princeton University Art Museum and its collections. Four surfaces: objects (with a label-level /tombstone sub-resource and filtering by maker, department, term and on-view status), makers, packages, and a full-text search endpoint that returns the raw Elasticsearch envelope. Pagination and incremental harvesting are supported via size, from, sort, sortorder and lastupdated. No authentication is currently required, though the Museum documents that this may change. Weekly-refreshed static JSON dumps of the whole collection are offered alongside the API for bulk and machine-learning use. The Museum publishes prose documentation, not a contract; the OpenAPI in this repo is DERIVED from that documentation and verified against live responses, and is not Princeton's own artifact.

Operations 1

GET /search/artmuseum /search/artmuseum?query={query} #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/art-museum-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

princeton-art-museum-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Allsearch Art Museum API
  description: Backend API for allsearch.princeton.edu
  version: v1
servers:
- url: https://allsearch-api.princeton.edu
- url: https://allsearch-api-staging.princeton.edu
tags:
- name: Art Museum
paths:
  /search/artmuseum:
    parameters:
    - name: query
      in: query
      description: A string to query the Art Museum
      schema:
        type: string
    get:
      summary: /search/artmuseum?query={query}
      tags:
      - Art Museum
      operationId: searchArtmuseum
      description: Searches the Art Museum using a query term
      responses:
        '200':
          description: successful
          content:
            application/json:
              example:
                number: 263
                records:
                - title: Two cats
                  creator: Theophile-Alexandre Steinlen, 1859–1923; born Lausanne, Switzerland; died Paris, France
                  id: '6463'
                  type: artobjects
                  url: https://artmuseum.princeton.edu/collections/objects/6463
                  other_fields:
                    credit_line: Bequest of Dan Fellows Platt, Class of 1895
                    medium: Graphite
                    dimensions: 25.1 × 26.2 cm. (9 7/8 × 10 5/16 in.)
                    primary_image: https://puam-loris.aws.princeton.edu/loris/INV34694.jp2?a=b&c=d
                    object_number: x1948-1210
                    date: '1900'
                - title: Cats Tales
                  creator: Peter Finnemore, British (Welsh), born 1963
                  id: '40016'
                  type: artobjects
                  url: https://artmuseum.princeton.edu/collections/objects/40016
                  other_fields:
                    credit_line: Gift of the artist
                    medium: Gelatin silver print
                    dimensions: 'image: 19.8 x 28.1 cm (7 13/16 x 11 1/16 in.)

                      sheet: 27.5 x 33 cm (10 13/16 x 13 in.)'
                    primary_image: https://puam-loris.aws.princeton.edu/loris/INV11648.jp2
                    object_number: 2001-158
                    date: '1994'
                - title: Two Cats
                  creator: Francisco Toledo, 1940–2019, born Juchitan, Oaxaca, Mexico; died Oaxaca City, Mexico; active Oaxaca City
                  id: '40222'
                  type: artobjects
                  url: https://artmuseum.princeton.edu/collections/objects/40222
                  other_fields:
                    credit_line: Bequest of David L. Meginnity, Class of 1958
                    medium: "Recto: Black ink and watercolor \nVerso: Black ink and watercolor"
                    dimensions: 28 x 38 cm (11 x 14 15/16 in.)
                    primary_image: https://puam-loris.aws.princeton.edu/loris/PUAMSTU2018-1959213.jp2
                    object_number: 2001-120
                    date: '1993'
                more: https://artmuseum.princeton.edu/search/collections?mainSearch=%22cats%22
        '400':
          description: with a search query that only contains whitespace
          content:
            application/json:
              example:
                error:
                  problem: QUERY_IS_EMPTY
                  message: The query param must contain non-whitespace characters.