빠른 시작

5분 만에 첫 회사 프로필을 받아 보세요.

계정과 터미널만 있으면 돼요. 마지막에는 예시 요청으로 Hetzner Online GmbH의 회사 프로필을 가져오고, 응답에 무엇이 담겨 있는지 알게 돼요.

API 키 복사

무료 계정을 만들고 이메일 주소를 인증하세요. 30일 동안 유효한 시작 크레딧 150을 받아요.

첫 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}

200 · Hetzner Online GmbH 예시 응답, 기본 데이터만

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();

다음으로

기능 추가 같은 요청에서 대표이사, 주주 또는 재무. 등기 번호로 회사 가져오기 등기 법원, 등기 번호, entity_id를 통한 고유한 방법. 기본 개념 크레딧, 실시간 모드, 이력, 빈 값의 작동 방식. ChatGPT 플러그인 코드 없이 채팅에서 같은 데이터. Python SDK 준비된 메서드로 Python에서 쓰는 API. Node SDK JavaScript와 TypeScript에서 쓰는 API.