opendata-cat

{'type': 'object', 'required': ['dataset_id'], 'properties': {'dataset_id': {'type': 'string', 'description': "Unique dataset identifier in 'portal:id' format. Obtained from search_datasets results. Examples: 'generalitat:gn9e-3qhr', 'barcelona:qualitat-de-laire', 'renfe:vehicle-positions-gtfsrt'."}}}

{'type': 'object', 'required': [], 'properties': {}}

{'type': 'object', 'required': ['dataset_id'], 'properties': {'dataset_id': {'type': 'string', 'description': "Unique dataset identifier in 'portal:id' format. Obtained from search_datasets results."}}}

{'type': 'object', 'required': [], 'properties': {}}

{'type': 'object', 'required': ['dataset_id'], 'properties': {'limit': {'type': 'number', 'default': 20, 'description': 'Number of rows to return. Min 1, max 100. Default 20. Use offset for pagination.'}, 'offset': {'type': 'number', 'default': 0, 'description': 'Number of rows to skip for pagination. Default 0. Combine with limit to navigate large results.'}, 'search': {'type': 'string', 'description': 'Free text search within dataset data. Works with Socrata ($q) and CKAN (q). For Diba and CIDO, use specific filters.'}, 'filters': {'type': 'object', 'description': 'Key-value filters where the key is the field name and the value is the filter value. Examples: {"municipi": "Barcelona"}, {"any": "2024"}, {"NOM_ENS": "Ajuntament de Tiana"}. Use list_dataset_fields to know valid field names.', 'additionalProperties': {'type': 'string'}}, 'dataset_id': {'type': 'string', 'description': "Unique dataset identifier in 'portal:id' format. Obtained from search_datasets results."}}}

{'type': 'object', 'required': ['dataset_id'], 'properties': {'dataset_id': {'type': 'string', 'description': 'Dataset ID to find related datasets for. Obtained from search_datasets.'}}}

{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'number', 'default': 20, 'description': 'Maximum number of results to return. Min 1, max 100. Default 20.'}, 'query': {'type': 'string', 'description': "Search text in Catalan or Spanish. Examples: 'qualitat aire', 'pressupostos municipals', 'transport públic', 'residus', 'educació', 'rodalies'."}, 'portal': {'enum': ['generalitat', 'barcelona', 'diba', 'aoc', 'reus', 'girona', 'fgc', 'idescat', 'renfe', 'ine', 'ree', 'sepe', 'cnmc', 'cora', 'catalonica'], 'type': 'string', 'description': 'Filter results to a single portal.'}, 'category': {'type': 'string', 'description': "Filter by thematic category. Examples: 'Medi Ambient', 'Educació', 'Salut', 'Economia', 'Transport', 'Seguretat'. Use list_categories to see all available categories."}}}

{'type': 'object', 'required': ['query'], 'properties': {'type': {'enum': ['Episode', 'Program', 'Person'], 'type': 'string', 'description': 'Filter by document type.'}, 'year': {'type': 'string', 'description': "Filter by year (4 digits, e.g. '2025'). NOTE: only year-level filtering is indexed; for a specific day, use the broader year filter and look at the URL path (radioteca URLs include /YYYY/MM/DD/) or the 'subheading' field which often contains the date."}, 'limit': {'type': 'number', 'default': 10, 'description': 'Maximum results. Min 1, max 50. Default 10.'}, 'query': {'type': 'string', 'description': "Free text in Catalan or Spanish. Searches title, description (contains episode summary), program and subheading. Examples: 'visita papa', 'eleccions municipals', 'crisi habitatge', 'Albert Serra cinema'."}, 'offset': {'type': 'number', 'default': 0, 'description': 'Pagination offset. Default 0.'}, 'publisher': {'enum': ['Catalunya Ràdio', 'RAC1', 'Catalunya Música', 'iCat', 'Catalunya Informació', 'RTVE', 'Cadena SER', 'ara.cat'], 'type': 'string', 'description': 'Filter by broadcaster.'}}}