Fetch all available CBS catalogs.

Returns: dict[str, Any]: Count and list of catalogs.

Search datasets with OData filtering, sorting, and pagination.

RECOMMENDATION: use filter with contains() instead of search. The CBS $search often returns irrelevant results. Example: filter="contains(Title,'warmte')" or filter="contains(Title,'energie') and contains(Title,'verbruik')".

Args: catalog: Catalog identifier, typically CBS. select: OData $select. filter: OData $filter -- use contains() for title search. orderby: OData $orderby. top: OData $top. skip: OData $skip. count: OData $count. search: OData $search (UNRELIABLE -- use filter instead). expand: OData $expand. exclude_discontinued: Prepend a default filter to exclude discontinued datasets.

Returns: dict[str, Any]: Query info and dataset results.

Fetch all dimensions for a dataset.

Args: catalog: Catalog identifier. dataset: Dataset identifier.

Returns: dict[str, Any]: Table of dimensions and labels per dimension.

Fetch values for a specific dimension.

WARNING: this endpoint returns 404 on most CBS datasets. Prefer get_dimensions(), which already resolves all dimension codes and labels via the reliable {dim}Codes endpoints.

Args: catalog: Catalog identifier. dataset: Dataset identifier. dimension: Dimension identifier. select: OData $select. filter: Additional OData $filter. orderby: OData $orderby. top: OData $top.

Returns: dict[str, Any]: Count and dimension values.

Fetch observations with automatic pagination.

Automatically follows @odata.nextLink to retrieve all pages. With resolve_labels=True, dimension and measure codes are replaced with human-readable labels.

Args: catalog: Catalog identifier. dataset: Dataset identifier. filters: Dimension filters (key=dimension, value=code). paginate: Fetch all pages (True) or just one page (False). resolve_labels: Replace codes with labels (True) or keep raw codes (False, faster). limit: Maximum number of observations (safety limit).

Returns: dict[str, Any]: Observation result.

Query observations with advanced OData options.

Args: catalog: Catalog identifier. dataset: Dataset identifier. select: OData $select. filter: OData $filter. orderby: OData $orderby. top: OData $top. skip: OData $skip. count: OData $count. search: OData $search. expand: OData $expand.

Returns: dict[str, Any]: Query info and observation results.

Fetch the OData metadata document (EDM schema).

Note: This returns the catalog-wide schema, not dataset-specific metadata. Use get_dataset_info() for metadata of a single dataset.

Returns: dict[str, str]: Metadata as an XML string.

Fetch metadata for a single specific dataset.

Returns title, description, status, last modification date, and more. Use this to quickly check whether a dataset is relevant.

Args: catalog: Catalog identifier. dataset: Dataset identifier (e.g. '85523NED').

Returns: dict[str, Any]: Dataset metadata.

Fetch measure code definitions for a dataset.

Measures are the columns containing actual measurement values in observations. Each measure has an Identifier (code) and Title (label).

Args: catalog: Catalog identifier. dataset: Dataset identifier.

Returns: dict[str, Any]: Count and list of measure codes.