What it returns
The Metropolitan Museum of Art's collection through its Open Access API. Public-domain images and data are CC0.
Object ID, accession number, title, object type, department, culture, period, dynasty, artist name, bio, nationality and life dates with Wikidata and ULAN links, object date, medium, dimensions, credit line, geography, classification, gallery number, public-domain flag, primary and additional image links, subject tags and the Met page.
Common uses
Art education and apps, image datasets of public-domain works, provenance and catalog research, museum and gallery tools, content for publishers.
Request
POST https://api.pushbuild.com/met-museum-collection/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
searchQueries | list of strings | e.g. sunflowers, samurai armor, Hokusai. |
objectIds | list of strings | Met object IDs, e.g. 436524. |
departmentId | integer | 1 American Decorative Arts, 11 European Paintings, 6 Asian Art, 10 Egyptian Art, 21 Modern Art (see the Met departments list). |
dateBegin | integer | Negative for BC, e.g. -500. |
dateEnd | integer | e.g. 1900. |
medium | string | e.g. Paintings, Ceramics, Textiles. |
geoLocation | string | e.g. France, Japan, Egypt. |
hasImages | boolean | Only objects with images. |
isOnView | boolean | Only objects on view now. |
isHighlight | boolean | Only the Met's highlighted works. |
artistOrCulture | boolean | Match keywords against artist name or culture only. |
offset | integer | Skip this many results (paging). |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/met-museum-collection/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"searchQueries": ["sunflowers"], "maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.24 per 1,000 objects. No charge for errors or empty searches.
Related APIs
Academic Papers Search API
Search scholarly papers across Crossref (150M+ works), arXiv and PubMed in one run.
Art Institute of Chicago API
Artworks from the Art Institute of Chicago collection: title, artist, date, medium, dimensions, place of origin, department, type, classification, style, public-domain and on-view flags, gallery, credit line, subject terms and a IIIF image URL.
Article & Web Page to Markdown API
Turn any URLs into clean, Markdown, text or JSON.
Bitcoin Fees API
Bitcoin network data from mempool.space: recommended fee rates (sat/vB), projected next blocks, mempool size, recent blocks with fees, reward and mining pool, difficulty adjustment estimate, hashrate and difficulty history, and mining pool share..
Bitstamp API
Bitstamp exchange public market data: 24h ticker for every pair (last, bid, ask, open, high, low, VWAP, volume in base and quote, change) and OHLC candles from 1 minute to 3 days, up to 1,000 per pair..
Book Search API
Search millions of books by keyword, title, author, subject or ISBN, plus author lookup.
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com