자주 묻는 질문

공식 등기부와 공고에서 와요: Handelsregister(상업 등기부), 연간 재무제표가 담긴 Unternehmensregister(기업 등기부), 파산 공고. 뉴스와 웹사이트 내용은 웹에서 가져와요. 자세한 내용은 데이터 제공 범위에 있어요.

많은 세부 정보를 공개된 문서와 공고에서 자동으로 읽어 내요. 이를 위해 최신 기술을 쓰고 품질에 많은 투자를 하지만, 개별 오류가 있을 수 있어요.

회사 프로필은 저희 데이터베이스에서 나와요. 실시간 모드를 사용하면 API가 Handelsregister를 실시간으로 조회해 현재 등기된 인물을 반환해요. 문서는 요청할 때 API가 등기부에서 가져와요.

같은 문서를 직전에 가져온 적이 있다면 최대 24시간 전의 것일 수 있어요.

회사는 결산일로부터 늦어도 12개월 안에 연간 재무제표를 공개해야 하며, 많은 회사가 그 기간을 모두 써요. 그래서 최신 재무제표가 재작년 것인 경우가 많아요.

대개 회사가 그 값을 공개할 의무가 없기 때문이에요. 공개 범위는 법적 형태와 규모에 따라 달라요. 예를 들어 소형 GmbH는 손익계산서를 공개하지 않으므로 보통 매출이 없어요. 빈 값은 응답에서 null 또는 []로 나타나요.

여러 회사가 공유하는 이름이면 API가 그중 하나를 반환할 수 있는데, 원하는 회사가 아닐 수도 있고 404로 응답할 수도 있어요. 정확해야 한다면 등기 법원과 등기 번호(예: “Ansbach HRB 6089”) 또는 entity_id로 조회하세요. 같은 번호가 여러 법원에 있으므로 등기 번호만으로는 부족해요.

아니요. 기능은 데이터를 반환할 때만 과금돼요. 반면 AI 모드는 회사를 찾지 못해도 과금돼요. API가 요청을 408로 중단한 경우에만 과금되지 않아요. 실시간 모드는 새 내용이 없더라도 실시간 조회가 성공할 때마다 크레딧이 들어요.

없어요. 오류로 끝난 요청은 과금되지 않으며, 유일한 예외는 AI 모드 추가 요금이에요. 상태 402에서는 meta.request_credit_cost가 그 요청에 들었을 최대 비용을 알려 줘요. 자세한 내용은 오류에 있어요.

아니요. 회사 프로필, 검색 및 내보내기, 문서, Signals는 어떤 계정으로든 쓸 수 있고 크레딧만 지불하면 돼요. 크레딧 구독은 추가 데이터를 열어 줘요:

• Plus: 인물 프로필.
• Pro: 확장 재무 KPI, 기업 네트워크 기능, 소유권·경영진·파산 검색 필터, Signals 주제 파산.
• Max: Pro의 모든 것에 더해 심층 주주 정보 기능, 에너지 공급사의 활동 보고서, Signals 주제 조직 변경 & M&A.

가격과 플랜에 관한 모든 내용은 과금에 있어요.

새 계정은 시작 크레딧 150을 받아요. 크레딧 구독이 없으면 시작 크레딧과 충전 크레딧은 30일 동안 유효해요. 크레딧 구독이 활성 상태인 동안에는 만료되지 않아요.

실시간 모드, 인물 프로필, 문서는 시간이 더 걸리므로 최소 120초로 설정하세요. 실시간 모드에서 실시간 조회만 실패하면 실시간 추가 요금 없이 저장된 데이터를 받아요. 요청이 너무 오래 걸리면 408로, 문서는 504로 끝나요. 이 경우 과금되지 않아요. 나중에 다시 시도하세요.

회사 프로필은 계정당 분당 60 요청, 문서는 5 요청이에요. 이를 넘으면 API가 상태 429로 응답하고 Retry-After에 대기 시간을 알려 줘요. 모든 한도는 한도에 있어요.

네, 회사 프로필, 인물 프로필, 검색, 문서에서 가능해요. 헤더 Idempotency-Key에 직접 정한 값을 보내세요. 24시간 안에 같은 키와 같은 파라미터로 요청을 반복하면 비용이 들지 않아요.

네. 계정 › API 키에서 예를 들어 애플리케이션마다 키를 하나씩 더 만들 수 있어요. 키를 삭제하면 즉시 무효가 돼요. 모든 키는 계정의 잔액을 공유해요.