Art Institute Gallery Display State Evidence API

Compare declared Art Institute of Chicago gallery/on-view state for exact known artwork IDs. One /api/v1/artworks/ID request each with fields=id,title,is_on_view,gallery_id,gallery_title,updated_at, at most5 IDs. Return the identity/title, tri-state onViewDeclared, optional gallery ID/title and declared update timestamp. Null status/location stays unknown rather than becoming false or a guessed room.

The source display flag can be delayed or incomplete; this is not a guarantee that a work will be visible during a visit or a real-time museum itinerary. A null/empty gallery is not proof of absence or disposal. This differs from object-medium/accession catalog inventory: the selected hash tracks display state and update metadata. No artist data, loan details, descriptions, images/IIIF, media downloads, coordinates, visitor tracking, tickets, search or full collection crawl. Current API responses license these selected fields under CC0 and the institution's terms; images/descriptions can have different rights and are omitted. Anonymous API limit is60/minute and shared IPs can be limited; respect provider instructions and cache/reduce requests. A404 is an error, not a guessed missing-row state.

Quick start

{"artworkIds": [129884, 27992]}

Pricing and budget

0.0007 USD per emitted gallery state observation (0.7 USD per1000), plus0.005 USD startup at default256MB. Higher memory can multiply startup events; check effective Store pricing. Failed/empty sources do not emit result charges; startup can still apply. At zero result budget, input validation occurs but no upstream request is sent, and rowsAvailable is null (unknown). A positive budget can request the bounded source set before output; emission stops at the result cap and complete=false/PARTIAL_BUDGET reports truncation.

Snapshot, integration and limits

Use dataset rows together with OUTPUT and SNAPSHOT. Pass SNAPSHOT.previousHashes as previousHashes in a later run. NO_BASELINE/FIRST_SEEN/UNCHANGED/CHANGED compare only selected metadata including itemKey and sourceUrl; missing records are not deletions. FIRST_SEEN means absent from the supplied baseline. There is no persistent hidden state or automatic polling. Export JSON/CSV/Excel through the default dataset.

API example: POST https://api.apify.com/v2/actors/soilair~artic-gallery-display-state-evidence-api/runs with your Apify Authorization header and the JSON input above. Poll the returned run; read dataset items and OUTPUT/SNAPSHOT records using its store IDs. Do not place tokens or confidential data in input. No upstream key is needed. Results live in Apify run storage according to retention; no separate analytics service.

Only fixed HTTPS provider endpoints are constructed from validated identifiers. Public-IP DNS validation, pinned connections, TLS hostname verification,2MiB decoded responses, approximately95 seconds of network budget, at most5 same-provider redirects. Official API calls are distinct from website crawling; no arbitrary URLs or HTML pages. No linked documents/files are fetched. Queries are sequential with1-second spacing. Provider403/429 or Retry-After stops later calls; retry instructions are reported and no retry/proxy/circumvention is attempted. Shared IP limits and changes to upstream services can still block runs. Caller must respect provider headers and cache/reduce repeated requests. Text is data and should not be executed.

Developed with AI assistance. Tests and live/cloud comparisons qualify the selected-field contract; they do not prove commercial demand, provider uptime or a legal/license determination. Support: share a run ID and expected fields, without credentials or private material.

References: https://api.artic.edu/docs/