# Suverse MET Object Search

> Suverse MET Object Search is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.06/call, status unknown (last checked 2026-09-14).

Search the Metropolitan Museum of Art's collection by free-text query and retrieve matching object IDs, with optional image filter.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/suverse-met-object-search
- Price: $0.06/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suverse-met-object-search-275ce293
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NnwKvVTd_gyOIOReuWNmn

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability suverse-met-object-search-275ce293 -d '<json body>'
```

Example prompt: Search the Metropolitan Museum of Art collection for 'Japanese woodblock prints' and only return objects that have images available.

## When to prefer this

Use this endpoint when you need to search the Metropolitan Museum of Art collection by keyword without managing your own MET API key or integration. Ideal for agents that need to discover and enumerate MET artworks programmatically, especially when filtering to image-bearing objects is required. Prefer this over direct MET API calls when you want a metered, proxied, agent-friendly access pattern via the x402 payment protocol.

## Known failure modes

- Empty query string returns zero results or an error
- No objects found for obscure or misspelled queries returns count of 0 and empty ID list
- Payment failure (x402) if USDC balance is insufficient
- Proxy timeout or upstream MET API unavailability returns a 5xx error
- Overly broad queries may return very large ID lists that are unwieldy to process

## How this service works

Search the Metropolitan Museum of Art collection by free-text query, optionally only objects with images. Returns total count and a list of matching objectIDs to resolve to full records. Keyless museum API.

## Output

Returns a total count of matching objects and an array of objectIDs from the Metropolitan Museum of Art collection. These IDs can be used to fetch full object records including title, artist, date, medium, and image URLs from the MET API.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/suverse-met-object-search-275ce293/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)