API documentation

Read-only REST API, JSON over HTTPS. Same data and filters as the search page; every record carries its sources. Machine-readable schema: /openapi.json (OpenAPI 3). Use within the licence terms (sources & licences).

Quick start

curl "https://firmen.panoherbe.com/api/v1/companies?q=endoscope*&sector=medtech&region=DE-BW&limit=10"
curl "https://firmen.panoherbe.com/api/v1/stats?sector=pharma"
curl -o list.xlsx "https://firmen.panoherbe.com/export.xlsx?product=W"

Search syntax in q: AND/OR/NOT (also UND/ODER/NICHT), brackets, "phrases", prefix*. Pagination with limit (max 1000) and offset; responses include total and facet counts.

Endpoints

GET/api/v1/stats

Counts by sector, federal state, size class and EMDN product group for the given filters.

parameter	in	type	default
`q`	query	string
`sector`	query	string
`tier`	query	string
`region`	query	string
`size`	query	string
`revenue`	query	string
`product`	query	string
`contact`	query	boolean	False
`alle`	query	boolean	False

GET/api/v1/companies

Search companies. `q` supports AND/OR/NOT (also UND/ODER/NICHT), brackets, "phrases" and prefix*. Filters: sector (medtech, pharma, biotech, digital_health), tier (A, B, C), region (ISO 3166-2, e.g. DE-BW), size (micro, small, medium, large), revenue (r1–r4), product (EMDN category letter, e.g. Z), contact=true, alle=true includes records that are not register-verified.

parameter	in	type	default
`q`	query	string
`sector`	query	string
`tier`	query	string
`region`	query	string
`size`	query	string
`revenue`	query	string
`product`	query	string
`contact`	query	boolean	False
`alle`	query	boolean	False
`limit`	query	integer	100
`offset`	query	integer	0

GET/api/v1/companies/{cid}

One company with all fields and its sector evidence.

parameter	in	type	default
`cid`	path	string

GET/export.csv

Export Csv

GET/export.xlsx

Export Xlsx

GET/export.pdf

Result list as PDF (up to 2,000 rows) — for presentations and print.