快速入门
五分钟获取你的第一份公司档案。
你需要一个账户和一个终端。完成后，你将通过示例请求获取 Hetzner Online GmbH 的公司档案，并了解响应包含什么。
复制你的 API 密钥
创建一个免费账户并确认你的电子邮件地址。你会获得 150 初始积分，有效期 30 天。
你的第一个 API 密钥已在账户 › API 密钥下准备好。复制它，并像对待密码一样保管它。
每个请求都在请求头 x-api-key 中发送密钥。示例中用 YOUR_API_KEY 代替它。
如果 API 返回 401，说明密钥缺失或未完整复制。返回 403 表示你的电子邮件地址尚未确认。确认链接在你的收件箱中。
获取公司档案
调用 fetch-organization，并在参数 q 中传入公司名称。不带其他参数时，你以 5 积分获得基本数据。
复制请求，填入你的密钥并运行。cURL 会直接输出 JSON。在 Python 和 JavaScript 中，响应随后位于 data 中。用 print(data["name"]) 或 console.log(data.name) 可以看到公司名称。
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: YOUR_API_KEY" \ --data-urlencode 'q=Hetzner Online GmbH'
import requests response = requests.get( "https://handelsregister.ai/api/v1/fetch-organization", headers={"x-api-key": "YOUR_API_KEY"}, params={ "q": "Hetzner Online GmbH", }, ) data = response.json()
const url = new URL("https://handelsregister.ai/api/v1/fetch-organization"); url.searchParams.append("q", "Hetzner Online GmbH"); const response = await fetch(url, { headers: { "x-api-key": "YOUR_API_KEY" }, }); const data = await response.json();
读取响应
响应是 JSON 格式的公司档案。以下是你最常用的字段：
| 字段 | 含义 |
|---|---|
| entity_id | 公司在 handelsregister.ai 的 ID。请保存它，用于后续请求。 |
| name, legal_form, status |
公司名称、法律形式和登记状态，示例中为 ACTIVE。
|
| registration | 登记法院、登记类型和登记号，示例中为 Ansbach HRB 6089。 |
| address, seat | 带坐标的营业地址，以及登记册中的注册地。 |
| purpose, industry_classification | 经营范围，以及按 WZ 2008 和 WZ 2025 划分的行业。 |
| representation_scheme |
代表规则：current 为今天适用的规则，history 显示每个已登记的状态。
|
| meta |
请求的费用（request_credit_cost）以及之后的余额（credits_remaining）。
|
1{2 "entity_id": "94eb910fef13f94585c48c263fa446d4",3 "name": "Hetzner Online GmbH",4 "status": "ACTIVE",5 "legal_form": "GmbH",6 "registration": {7 "court": "Ansbach",8 "register_type": "HRB",9 "register_number": "6089"10 },11 "industry_classification": {12 "WZ2008": [13 {14 "code": "62.01.0",15 "label": "Erbringung von Dienstleistungen der Informationstechnologie"16 },17 {18 "code": "63.11.0",19 "label": "Datenverarbeitung, Hosting und damit verbundene Tätigkeiten"20 },21 {22 "code": "61.90.0",23 "label": "Telekommunikation, sonstige"24 }25 ],26 "WZ2025": [27 {28 "code": "62.20.1",29 "label": "Erbringung von Beratungsleistungen auf dem Gebiet der Informationstechnologie"30 },31 {32 "code": "46.50.1",33 "label": "Großhandel mit Datenverarbeitungsgeräten, peripheren Geräten und Software"34 },35 {36 "code": "62.90.0",37 "label": "Erbringung von sonstigen Dienstleistungen der Informationstechnologie"38 }39 ]40 },41 "address": {42 "house_number": "25",43 "street": "Industriestraße",44 "postal_code": "91710",45 "city": "Gunzenhausen",46 "county": "Weißenburg-Gunzenhausen",47 "state": "Bayern",48 "country": "DEU",49 "coordinates": {50 "latitude": 49.12483,51 "longitude": 10.7805252 }53 },54 "seat": {55 "city": "Gunzenhausen"56 },57 "registration_date": null,58 "representation_scheme": {59 "current": [60 "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."61 ],62 "history": [63 {64 "value": [65 "Ist nur ein Vorstandsmitglied bestellt, so vertritt es die Gesellschaft allein. Sind mehrere Vorstandsmitglieder bestellt, so wird die Gesellschaft durch zwei Vorstandsmitglieder oder durch ein Vorstandsmitglied gemeinsam mit einem Prokuristen vertreten."66 ],67 "effective_from": "2002-10-15",68 "effective_to": "2015-07-28"69 },70 {71 "value": [72 "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."73 ],74 "effective_from": "2015-07-28",75 "effective_to": null76 }77 ]78 },79 "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.",80 "meta": {81 "request_credit_cost": 5,82 "credits_remaining": 14583 }84}
以后你可以用 entity_id 直接查询同一家公司。它也是 fetch-document 和 Signals 的键。登记法院和登记号同样唯一，示例中为 Ansbach HRB 6089。
curl -G "https://handelsregister.ai/api/v1/fetch-organization" \ -H "x-api-key: YOUR_API_KEY" \ --data-urlencode 'q=94eb910fef13f94585c48c263fa446d4'
import requests response = requests.get( "https://handelsregister.ai/api/v1/fetch-organization", headers={"x-api-key": "YOUR_API_KEY"}, params={ "q": "94eb910fef13f94585c48c263fa446d4", }, ) data = response.json()
const url = new URL("https://handelsregister.ai/api/v1/fetch-organization"); url.searchParams.append("q", "94eb910fef13f94585c48c263fa446d4"); const response = await fetch(url, { headers: { "x-api-key": "YOUR_API_KEY" }, }); const data = await response.json();