search_actors_public
Search energy market participants including DSOs, generators, suppliers, and traders using 23 filter keys for name, function, role, location, and status.
Instructions
Search market actors (Marktakteure) — no auth required.
Find energy market participants: DSOs (Netzbetreiber), generators, suppliers, traders, and more. 23 filter keys for name, function, role, location, status, and DSO flags (large DSO, closed distribution network).
NOTE: MaStR stores '&' as fullwidth U+FF06 in company names. Use 'name%' with a substring without '&' for reliable company name searches.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 1-based page number. | |
| filters | Yes | Filter dict with optional operator suffixes on each key. Operators: '=' (eq, default), '!=' (neq), '%' (contains), '!%' (not contains), ':' (starts with), '$' (ends with), '>' (gt), '<' (lt), '?' (is null), '!' or '!?' (is not null). Supported filter keys: name, mastr_number, bnetza_number, acer_code, vat_id, register_court, register_number, function, roles, industry_group, postcode, city, street, bundesland, nuts_region, status, registration_date, last_update, activity_start, activity_end, dso_large, dso_closed, sme_flag. Dropdown fields (bundesland, function, status, roles, nuts_region, industry_group) accept label or MaStR ID. Boolean fields (dso_large, dso_closed, sme_flag) accept true/false, ja/nein, 1/0. NOTE: MaStR stores '&' as fullwidth U+FF06 — use 'name%' with a substring without '&' for company name searches. Example: {'function': 'Stromnetzbetreiber', 'dso_large': True} | |
| page_size | No | Page size (max 5000). |