Search Whitney audio guides
whitney_search_guidesRead-onlyIdempotent
Find Whitney Museum audio guides published since 2009. Search by title or filters, and retrieve guide stops for each result.
Instructions
Search audio guides published since 2009. Fetching an individual guide also returns its stops.
Args:
title (string, optional), filters (object, optional), sort (string, optional)
page (number, default 1), limit (number, 1-30, default 10)
response_format ('markdown' | 'json', default 'markdown')
Returns: { total, count, page, has_more, next_page?, results[] }
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 1-based page number; the API returns 30 records per page | |
| sort | No | Ransack sort string, e.g. 'start_time desc', 'title asc', or 'random' | |
| limit | No | Maximum records to return from the fetched page (1-30). Keep this low unless you need the detail — Whitney records are verbose. | |
| title | No | Words appearing in the title | |
| filters | No | Raw Ransack predicates, e.g. { "title_cont": "moon", "classification_eq": "Paintings" }. Matchers: _eq, _not_eq, _cont, _not_cont, _cont_all_split, _true, _false, _gt, _gteq, _lt, _lteq. | |
| response_format | No | Output format: 'markdown' for reading, 'json' for machine processing | markdown |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | Advisory note about trimming or pagination | |
| page | Yes | Page that was fetched | |
| count | Yes | Records returned in this response | |
| total | Yes | Total matching records across all pages | |
| source | Yes | Attribution for the data, as the Whitney's terms ask for | |
| results | Yes | The records | |
| has_more | Yes | Whether further pages exist | |
| next_page | No | Page number to request next |