search_artworks
ActiveTool of Provenio — Art Intelligence
Cost: ~0.5s. Shortlist artworks by title/artist/medium/date, or risk-filter (provenance_risk, attribution_status). Returns summary rows. Use when: you need a list, not one work's detail. Do NOT use if: you know the artwork ID — call get_artwork (one call contains iconography + custody + polity + transactions). Do NOT chain multiple search_artworks calls for the same work — use get_artwork after you have the ID. Do NOT put artist names in the query field alone — use the artist filter with the person ID slug (e.g. 'person:jean-michel-basquiat'). If title is ambiguous, combine query + artist filter. Title match is substring (ILIKE %query%). For best results, use the artist filter rather than embedding artist name in query. Note: when provenance_risk filter is used, returns coverage_gaps: ['no_custody_history'] when the matching custody record pool is smaller than expected — interpret this as a data-density limitation, not a clean result. STOP after this unless you need deep detail on ONE artwork.
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 100,
"minimum": 1,
"description": "Max rows. Default 10."
},
"query": {
"type": "string",
"description": "Substring match on title and id (ILIKE %query%). Empty '' browses all. Do NOT embed artist names here — use the artist parameter instead."
},
"artist": {
"type": "string",
"description": "Filter by creator — person ID slug ('picasso') or full 'person:...' form (e.g. 'person:jean-michel-basquiat'). Obtain this from search_artists if needed."
},
"medium": {
"type": "string",
"description": "Substring match on medium, e.g. 'oil', 'bronze', 'watercolor'."
},
"date_to": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Latest production year (inclusive)."
},
"date_from": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Earliest production year (inclusive)."
},
"provenance_risk": {
"enum": [
"nazi_era_gap",
"colonial_seizure",
"forced_sale",
"repatriation_pending",
"knoedler_forgery_window"
],
"type": "string",
"description": "Surface artworks whose custody_history matches a risk profile. Use for bulk due-diligence audits."
},
"attribution_status": {
"enum": [
"single_author",
"workshop",
"disputed",
"anonymous"
],
"type": "string",
"description": "Filter by authorship status. 'disputed' surfaces contested attributions; 'workshop' surfaces 'Workshop of X' works; 'anonymous' surfaces unattributed; 'single_author' surfaces those with confirmed creator."
}
}
}No endpoints wrapped at confidence ≥ 0.50.
Parent server
Provenio — Art Intelligence
https://github.com/mildo-ai/brain_for_art
1/7 registries