Skip to main content
Version: v5

list_tables

List all OECD tables with keyword search, topic, subtopic, and dataflow ID filtering.

Examples​

from openbb import obb
# List all OECD tables.
obb.oecd.list_tables()
# Search for GDP tables.
obb.oecd.list_tables(query='GDP')
# Filter by topic.
obb.oecd.list_tables(topic='HEA')
# Find a specific table by dataflow ID.
obb.oecd.list_tables(dataflow_id='DF_PRICES_ALL')
# Search OECD tables.
tables = obb.oecd.utils.list_tables(query='prices')
print(tables.results)

Parameters​

query: str
Keyword search. Space-separated terms are AND-ed; use | for OR within a word.

topic: str
Filter by topic ID (e.g. 'ECO', 'HEA'). Use list_topics() to see all topics.

subtopic: str
Filter by subtopic ID within the selected topic.

dataflow_id: str
Filter by exact or partial dataflow (table) ID (e.g. 'DF_PRICES_ALL').


Returns​

results: Any

Serializable results.

provider: str

Provider name.

warnings: Optional[list[Warning_]]

List of warnings.

chart: Optional[Chart]

Chart object.

extra: dict[str, Any]

Extra info.