建立公司列表

使用搜索与导出，按行业、地区、规模等筛选公司。

search-organizations 按特征而不是名称查找公司。你可以组合筛选条件、按 KPI 排序并翻阅结果。如需将列表保存为文件，可在网页应用中导出。

组合筛选条件

筛选条件以 JSON 对象形式放入参数 filters。所有筛选条件同时生效。如果在一个筛选条件中给出多个取值，只要其中一个匹配即可。

curl -G "https://handelsregister.ai/api/v1/search-organizations" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode 'filters={"legal_form_code":"GmbH","city":"Gunzenhausen","active":true}' \
  --data-urlencode 'limit=5'

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/search-organizations",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "filters": "{\"legal_form_code\":\"GmbH\",\"city\":\"Gunzenhausen\",\"active\":true}",
        "limit": "5",
    },
)
data = response.json()

const url = new URL("https://handelsregister.ai/api/v1/search-organizations");
url.searchParams.append("filters", "{\"legal_form_code\":\"GmbH\",\"city\":\"Gunzenhausen\",\"active\":true}");
url.searchParams.append("limit", "5");

const response = await fetch(url, {
  headers: { "x-api-key": "YOUR_API_KEY" },
});
const data = await response.json();

1{2  "results": [3    {4      "entity_id": "0100d4d86f3f26fceac3a833db59d700",5      "name": "Beyer Grundstücksverwaltungs-GmbH",6      "registration": {7        "court": "Ansbach",8        "register_type": "HRB",9        "register_number": "3635"10      },11      "address": {12        "house_number": "42",13        "street": "Nürnberger Str.",14        "postal_code": "91710",15        "city": "Gunzenhausen",16        "county": "Weißenburg-Gunzenhausen",17        "state": "Bayern",18        "country": "DEU",19        "coordinates": {20          "latitude": 49.11954,21          "longitude": 10.7591822        }23      },24      "seat": {25        "city": "Gunzenhausen"26      },27      "registration_date": "2003-04-15T00:00:00",28      "purpose": "Die Beteiligung als persönlich haftende Gesellschafterin an der Beyer Grundbesitz GmbH & Co. KG sowie die Geschäftsführung dieser Kommanditgesellschaft. Unternehmensgegenstand dieser Kommanditgesellschaft ist die Verwaltung eigenen Vermögens, insbesondere der Erwerb, die Verwaltung, die Bebauung und die Verwertung von Grundbesitz, jedoch mit Ausnahme von Tätigkeiten, die einer Genehmigung nach § 34 c GewO bedürfen.",29      "_match_context": [],30      "status_normalized": "ACTIVE"31    },32    {33      "entity_id": "0269de827eef8cae201195e4966886c3",34      "name": "Martin Bosch GmbH",35      "registration": {36        "court": "Ansbach",37        "register_type": "HRB",38        "register_number": "5034"39      },40      "address": {41        "house_number": "14 A",42        "street": "Auweg",43        "postal_code": "91710",44        "city": "Gunzenhausen",45        "county": "Weißenburg-Gunzenhausen",46        "state": "Bayern",47        "country": "DEU",48        "coordinates": {49          "latitude": 49.11129,50          "longitude": 10.7580151        }52      },53      "seat": {54        "city": "Gunzenhausen"55      },56      "registration_date": "2010-09-23T00:00:00",57      "purpose": "Gegenstand des Unternehmens ist - der Vertrieb und die Montage von Waren aller Art, insbesondere von Photovoltaikanlagen, Bauteilen nach DIN vorwiegend von Fenstern und Türen, - die Erbringung von Dienstleistungen und Vertriebsunterstützung im Bereich von Sport und Freizeitartikeln, - die Erbringung von Bauleistungen aller Art, insbesondere im Bereich Wohnbau, und zwar auch Leistungen im Sinne des § 34 c Abs. 1 Nr. 3. GewO, d.h. gewerbsmäßige Vorbereitung oder Durchführung von Bauvorhaben als Ba …",58      "_match_context": [],59      "status_normalized": "ACTIVE"60    },61    {62      "entity_id": "072223d1d792f9295175f80dded04545",63      "name": "König & Reuß Softwarelösungen GmbH",64      "registration": {65        "court": "Ansbach",66        "register_type": "HRB",67        "register_number": "5881"68      },69      "address": {70        "house_number": "6",71        "street": "Kirchenplatz",72        "postal_code": "91710",73        "city": "Gunzenhausen",74        "county": "Weißenburg-Gunzenhausen",75        "state": "Bayern",76        "country": "DEU",77        "coordinates": {78          "latitude": 49.11263,79          "longitude": 10.7553280        }81      },82      "seat": {83        "city": "Gunzenhausen"84      },85      "registration_date": "2014-07-15T00:00:00",86      "purpose": "Die Entwicklung und der Vertrieb von Software, die Organisationsberatung für EDV-Lösungen, EDV-Schulungen sowie der damit zusammenhängende An- und Verkauf von Hardware.",87      "_match_context": [],88      "status_normalized": "ACTIVE"89    },90    {91      "entity_id": "078582ddfc9526b6405289afa26b66f5",92      "name": "Wolfgang Seifert GmbH",93      "registration": {94        "court": "Ansbach",95        "register_type": "HRB",96        "register_number": "7369"97      },98      "address": {99        "house_number": "1",100        "street": "Brechhausstr.",101        "postal_code": "91710",102        "city": "Gunzenhausen",103        "county": "Weißenburg-Gunzenhausen",104        "state": "Bayern",105        "country": "DEU",106        "coordinates": {107          "latitude": 49.12887,108          "longitude": 10.7468109        }110      },111      "seat": {112        "city": "Gunzenhausen"113      },114      "registration_date": "2020-12-07T00:00:00",115      "purpose": "Die Ausführung von Isolierarbeiten sowie der Betrieb eines Getränkemarktes.",116      "_match_context": [],117      "status_normalized": "ACTIVE"118    },119    {120      "entity_id": "08764e95299e20f75f873d9497eab723",121      "name": "Zimmerei Ortner GmbH",122      "registration": {123        "court": "Ansbach",124        "register_type": "HRB",125        "register_number": "7994"126      },127      "address": {128        "house_number": "22",129        "street": "Hauptstr.",130        "postal_code": "91710",131        "city": "Gunzenhausen",132        "county": "Weißenburg-Gunzenhausen",133        "state": "Bayern",134        "country": "DEU",135        "coordinates": {136          "latitude": 49.10797,137          "longitude": 10.73341138        }139      },140      "seat": {141        "city": "Gunzenhausen"142      },143      "registration_date": "2022-12-19T00:00:00",144      "purpose": "Der Betrieb einer Zimmerei sowie die Durchführung von Dachdeckerarbeiten, Trockenbauarbeiten und Holzbauarbeiten aller Art.",145      "_match_context": [],146      "status_normalized": "ACTIVE"147    }148  ],149  "total": 239,150  "total_exact": false,151  "total_relation": "upper_bound",152  "meta": {153    "request_credit_cost": 1,154    "credits_remaining": 145155  }156}

200 · 示例响应：Gunzenhausen 存续的 GmbH

特征
特征	筛选条件
地区	`state`、`county`、`city`、`postal_code`；半径搜索用 `location_coordinates` 和 `location_max_distance_km`
行业	`industry_code`，WZ 2025 的五位代码，如 `62.10.1`，也可为列表
法律形式	`legal_form_code`，如 `GmbH`、`AG` 或 `UG (haftungsbeschränkt)`
状态	`status`（`ACTIVE`、`INSOLVENT` …）或 `active`（true、false）
规模	`company_size_category` 按资产负债表，`emp_size_category` 按员工人数：`micro`、`small`、`medium`、`large`
KPI	带范围的 `financial_filters`，如 `{"emp_count": {"gte": 50}}`
登记	`registration_date_from`、`registration_date_to`
Pro 起	`owner_filters`、`ownership_filters`、`executive_filters`、`lifecycle_filters`：股东、所有权结构、管理层、破产

所有筛选条件及其取值见 search-organizations。total 通常是结果数量的上限。从 10,000 条结果起，它是估计值。

排序

使用 sort 和 order 设置顺序，例如按营业收入、员工人数、资产总额或登记日期。没有该值的公司排在最后。示例在该县搜索至少 50 名员工的 GmbH，并按营业收入排序。

curl -G "https://handelsregister.ai/api/v1/search-organizations" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode 'filters={"county":"Weißenburg-Gunzenhausen","legal_form_code":"GmbH","status":"ACTIVE","financial_filters":{"emp_count":{"gte":50}}}' \
  --data-urlencode 'sort=revenue' \
  --data-urlencode 'order=desc' \
  --data-urlencode 'limit=5' \
  --data-urlencode 'match_context=1'

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/search-organizations",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "filters": "{\"county\":\"Weißenburg-Gunzenhausen\",\"legal_form_code\":\"GmbH\",\"status\":\"ACTIVE\",\"financial_filters\":{\"emp_count\":{\"gte\":50}}}",
        "sort": "revenue",
        "order": "desc",
        "limit": "5",
        "match_context": "1",
    },
)
data = response.json()

const url = new URL("https://handelsregister.ai/api/v1/search-organizations");
url.searchParams.append("filters", "{\"county\":\"Weißenburg-Gunzenhausen\",\"legal_form_code\":\"GmbH\",\"status\":\"ACTIVE\",\"financial_filters\":{\"emp_count\":{\"gte\":50}}}");
url.searchParams.append("sort", "revenue");
url.searchParams.append("order", "desc");
url.searchParams.append("limit", "5");
url.searchParams.append("match_context", "1");

const response = await fetch(url, {
  headers: { "x-api-key": "YOUR_API_KEY" },
});
const data = await response.json();

1{2  "results": [3    {4      "entity_id": "94eb910fef13f94585c48c263fa446d4",5      "name": "Hetzner Online GmbH",6      "registration": {7        "court": "Ansbach",8        "register_type": "HRB",9        "register_number": "6089"10      },11      "address": {12        "house_number": "25",13        "street": "Industriestraße",14        "postal_code": "91710",15        "city": "Gunzenhausen",16        "county": "Weißenburg-Gunzenhausen",17        "state": "Bayern",18        "country": "DEU",19        "coordinates": {20          "latitude": 49.12483,21          "longitude": 10.7805222        }23      },24      "seat": {25        "city": "Gunzenhausen"26      },27      "registration_date": "2015-07-28T00:00:00",28      "purpose": "Die Durchführung von Internet- und Netzwerkdienstleistungen, das Erstellen und Vertreiben von Software, der Handel mit Hard- und Software, der Betrieb einer Werbeagentur,darüber hinaus der Im- und Export von Waren aller Art, soweit sie keiner Einfuhr- oder Ausfuhrbeschränkung unterliegen und soweit keine Genehmigungen erforderlich sind.",29      "_match_context": {30        "financial": {31          "emp_count": 340,32          "year": 202333        },34        "legal_form": {35          "name": "Gesellschaft mit beschränkter Haftung",36          "category": "capital_company",37          "liability_type": "limited"38        }39      },40      "status_normalized": "ACTIVE"41    },42    {43      "entity_id": "e937d0eb0d9b938afaae55808a066400",44      "name": "Auto Bierschneider GmbH",45      "registration": {46        "court": "Ansbach",47        "register_type": "HRB",48        "register_number": "3953"49      },50      "address": {51        "house_number": "23",52        "street": "Dettenheimer Str.",53        "postal_code": "91781",54        "city": "Weißenburg i. Bay.",55        "county": "Weißenburg-Gunzenhausen",56        "state": "Bayern",57        "country": "DEU",58        "coordinates": {59          "latitude": 49.00163,60          "longitude": 10.9519861        }62      },63      "seat": {64        "city": "Weißenburg i. Bay."65      },66      "registration_date": "2005-03-22T00:00:00",67      "purpose": "Die Reparatur und der Handel mit Kraftfahrzeugen aller Art.",68      "_match_context": {69        "financial": {70          "emp_count": 263,71          "year": 202472        },73        "legal_form": {74          "name": "Gesellschaft mit beschränkter Haftung",75          "category": "capital_company",76          "liability_type": "limited"77        }78      },79      "status_normalized": "ACTIVE"80    },81    {82      "entity_id": "7bde1c2520a00de2e67da1237163c629",83      "name": "Hasselbacher GmbH Metallrecycling",84      "registration": {85        "court": "Ansbach",86        "register_type": "HRB",87        "register_number": "3865"88      },89      "address": {90        "house_number": "24",91        "street": "Treuchtlinger Str.",92        "postal_code": "91781",93        "city": "Weißenburg i.Bay.",94        "county": "Weißenburg-Gunzenhausen",95        "state": "Bayern",96        "country": "DEU",97        "coordinates": {98          "latitude": 49.01128,99          "longitude": 10.95407100        }101      },102      "seat": {103        "city": "Weißenburg i. Bay."104      },105      "registration_date": "2004-10-05T00:00:00",106      "purpose": "Das Metallrecycling sowie der Schrott- und Metallgroßhandel.",107      "_match_context": {108        "financial": {109          "emp_count": 50,110          "year": 2024111        },112        "legal_form": {113          "name": "Gesellschaft mit beschränkter Haftung",114          "category": "capital_company",115          "liability_type": "limited"116        }117      },118      "status_normalized": "ACTIVE"119    },120    {121      "entity_id": "3d495cff8ca2f1e8e717d8ff1317f61d",122      "name": "KTX GmbH",123      "registration": {124        "court": "Ansbach",125        "register_type": "HRB",126        "register_number": "5941"127      },128      "address": {129        "house_number": "34",130        "street": "Dettenheimer Strasse",131        "postal_code": "91781",132        "city": "Weißenburg",133        "county": "Weißenburg-Gunzenhausen",134        "state": "Bayern",135        "country": "DEU",136        "coordinates": {137          "latitude": 49.00551,138          "longitude": 10.95048139        }140      },141      "seat": {142        "city": "Weißenburg"143      },144      "registration_date": "2014-11-24T00:00:00",145      "purpose": "Die Entwicklung von technischen Problemlösungen auf dem Gebiet der Kunststoffindustrie, die Herstellung, Weiterverarbeitung und der Vertrieb von Kunststoffartikeln aller Art, insbesondere, aber nicht nur, für die Automobilindustrie.",146      "_match_context": {147        "financial": {148          "emp_count": 664,149          "year": 2024150        },151        "legal_form": {152          "name": "Gesellschaft mit beschränkter Haftung",153          "category": "capital_company",154          "liability_type": "limited"155        }156      },157      "status_normalized": "ACTIVE"158    },159    {160      "entity_id": "c95348029f78b1a5162a365a46e772a3",161      "name": "GUTMANN GmbH",162      "registration": {163        "court": "Ansbach",164        "register_type": "HRB",165        "register_number": "3621"166      },167      "address": {168        "house_number": "57",169        "street": "Nürnberger Straße",170        "postal_code": "91781",171        "city": "Weißenburg",172        "county": "Weißenburg-Gunzenhausen",173        "state": "Bayern",174        "country": "DEU",175        "coordinates": {176          "latitude": 49.04067,177          "longitude": 10.96989178        }179      },180      "seat": {181        "city": "Weißenburg i. Bay."182      },183      "registration_date": "2003-03-19T00:00:00",184      "purpose": "Die Produktion von Erzeugnissen aller Art und der Handel und Vertrieb von Produkten aller Art; insbesondere die Be- und Verarbeitung von Metall, Holz und Kunststoff.",185      "_match_context": {186        "financial": {187          "emp_count": 356,188          "year": 2024189        },190        "legal_form": {191          "name": "Gesellschaft mit beschränkter Haftung",192          "category": "capital_company",193          "liability_type": "limited"194        }195      },196      "status_normalized": "ACTIVE"197    }198  ],199  "total": 36,200  "total_exact": false,201  "total_relation": "upper_bound",202  "meta": {203    "request_credit_cost": 1,204    "credits_remaining": 145205  }206}

200 · 示例响应：Weißenburg-Gunzenhausen 县营业收入最高的 GmbH

使用 match_context=1 时，每条结果都会在 _match_context 下显示其匹配原因，KPI 还会附上该值的年份。这很重要，因为每家公司最新的报表可能来自不同年份。结果本身不包含营业收入；你需要通过 fetch-organization 的 financial_kpi 获取。

不指定 sort 时，带 q 的搜索按相关性排序。对于纯筛选查询，如果顺序重要，请设置 sort。

翻阅结果

limit 设置每页的结果数，最多 30。skip 跳过若干结果：第二页从 skip 等于 limit 开始。

curl -G "https://handelsregister.ai/api/v1/search-organizations" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode 'filters={"legal_form_code":"GmbH","city":"Gunzenhausen","active":true}' \
  --data-urlencode 'limit=3' \
  --data-urlencode 'skip=3'

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/search-organizations",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "filters": "{\"legal_form_code\":\"GmbH\",\"city\":\"Gunzenhausen\",\"active\":true}",
        "limit": "3",
        "skip": "3",
    },
)
data = response.json()

const url = new URL("https://handelsregister.ai/api/v1/search-organizations");
url.searchParams.append("filters", "{\"legal_form_code\":\"GmbH\",\"city\":\"Gunzenhausen\",\"active\":true}");
url.searchParams.append("limit", "3");
url.searchParams.append("skip", "3");

const response = await fetch(url, {
  headers: { "x-api-key": "YOUR_API_KEY" },
});
const data = await response.json();

1{2  "results": [3    {4      "entity_id": "078582ddfc9526b6405289afa26b66f5",5      "name": "Wolfgang Seifert GmbH",6      "registration": {7        "court": "Ansbach",8        "register_type": "HRB",9        "register_number": "7369"10      },11      "address": {12        "house_number": "1",13        "street": "Brechhausstr.",14        "postal_code": "91710",15        "city": "Gunzenhausen",16        "county": "Weißenburg-Gunzenhausen",17        "state": "Bayern",18        "country": "DEU",19        "coordinates": {20          "latitude": 49.12887,21          "longitude": 10.746822        }23      },24      "seat": {25        "city": "Gunzenhausen"26      },27      "registration_date": "2020-12-07T00:00:00",28      "purpose": "Die Ausführung von Isolierarbeiten sowie der Betrieb eines Getränkemarktes.",29      "_match_context": [],30      "status_normalized": "ACTIVE"31    },32    {33      "entity_id": "08764e95299e20f75f873d9497eab723",34      "name": "Zimmerei Ortner GmbH",35      "registration": {36        "court": "Ansbach",37        "register_type": "HRB",38        "register_number": "7994"39      },40      "address": {41        "house_number": "22",42        "street": "Hauptstr.",43        "postal_code": "91710",44        "city": "Gunzenhausen",45        "county": "Weißenburg-Gunzenhausen",46        "state": "Bayern",47        "country": "DEU",48        "coordinates": {49          "latitude": 49.10797,50          "longitude": 10.7334151        }52      },53      "seat": {54        "city": "Gunzenhausen"55      },56      "registration_date": "2022-12-19T00:00:00",57      "purpose": "Der Betrieb einer Zimmerei sowie die Durchführung von Dachdeckerarbeiten, Trockenbauarbeiten und Holzbauarbeiten aller Art.",58      "_match_context": [],59      "status_normalized": "ACTIVE"60    },61    {62      "entity_id": "0a5cea0c9d3861d10d42f21c1d3f9816",63      "name": "TJ Gastro 3 GmbH",64      "registration": {65        "court": "Ansbach",66        "register_type": "HRB",67        "register_number": "8809"68      },69      "address": {70        "house_number": "111",71        "street": "Nürnberger Straße",72        "postal_code": "91710",73        "city": "Gunzenhausen",74        "county": "Weißenburg-Gunzenhausen",75        "state": "Bayern",76        "country": "DEU",77        "coordinates": {78          "latitude": 49.12861,79          "longitude": 10.7708280        }81      },82      "seat": {83        "city": "Gunzenhausen"84      },85      "registration_date": "2021-01-11T00:00:00",86      "purpose": "Der Betrieb von Restaurants entsprechend dem mit der McDonald´s Deutschland Inc., Zweigniederlassung München, und Herrn Dr. Konrad Exempelmann abgeschlossenen Franchise-Vertrag, dem die Gesellschaft beigetreten ist.",87      "_match_context": [],88      "status_normalized": "ACTIVE"89    }90  ],91  "total": 239,92  "total_exact": false,93  "total_relation": "upper_bound",94  "meta": {95    "request_credit_cost": 1,96    "credits_remaining": 14597  }98}

200 · 示例响应：Gunzenhausen 存续 GmbH 的第二页，每页三条结果

每页收取 1 积分，即使是没有结果的页面。因此大页面按公司计最便宜。

一次搜索最多到第 10,000 条结果。对于更大的集合，请拆分，例如按州、邮政编码或登记期间。

导出列表

在网页应用中获取文件：在“搜索与导出”中设置筛选条件并选择“导出”。导出以 CSV、XLSX 或 JSON 格式返回最多 5,000 家公司。

开始前，你会看到上限和费用。导出会排除没有公开地址的公司；如有需要可以包含它们。完成的文件位于“账户 › 导出”下。

导出在运行时才读取结果。因此截至那时的变更都会包含在内。通过 API，你可以按上文所示逐页建立相同的列表。

常见陷阱

准确填写取值：status 用大写，registration_number 不带“HRB”，行业代码为五位。未知取值返回 0 条结果，该页仍会计费。
Pro 起的筛选条件：owner_filters 及其他 Pro 筛选条件需要 Pro 或 Max 积分订阅。否则 API 返回 HTTP 403，不收费。
搜索词中的登记号：q 搜索的是名称。查登记号请使用筛选条件 registration_authority_name 和 registration_number。
空的 q：空的 q= 会返回 HTTP 400。只筛选时请省略 q。

继续阅读

search-organizations 搜索的所有筛选条件、排序选项和字段。 Playground 试用筛选条件并导出列表。补全客户数据为结果补充完整的公司档案。获取公司档案直接获取单份公司档案。