과금
요청 비용과 그 내역을 확인하는 방법.
엔드포인트와 기능별 가격
API는 크레딧으로 과금해요. 각 요청은 엔드포인트의 기본 가격에, 데이터를 반환한 기능과 선택한 추가 요금을 더한 비용이 들어요. 가격은 모든 플랜에서 같아요. 플랜은 어떤 기능을 쓸 수 있는지를 정해요.
| 엔드포인트 | 항목 | 크레딧 |
|---|---|---|
| fetch-organization | 기본 데이터가 포함된 회사 프로필 | 5 |
| fetch-organization | 기능, 다음 표 참고 | 1~80 |
| fetch-organization | AI 모드 추가 요금, 일치 결과가 없어도 | +20 |
| fetch-organization | 실시간 모드 추가 요금, 실시간 조회가 성공할 때마다 | +10 |
| fetch-person | 인물 프로필, 웹 조사 포함(Plus부터) | 15 |
| fetch-person |
shareholdings 기능, 데이터를 반환할 때만
|
+5 |
| fetch-person |
network 기능(Pro, Max), 데이터를 반환할 때만
|
+25 |
| search-organizations | 결과 한 페이지, 비어 있어도 | 1 |
| fetch-document | 전달된 문서 1건 | 15 |
| signals | Signals 한 페이지 또는 개별 Signal 1건 | 20 |
| signals |
주제 카탈로그 /v1/signals/catalog
|
무료 |
| account, auth | 계정, 잔액, 사용량, 키, 토큰, 웹훅 엔드포인트 | 무료 |
fetch-organization의 기능은 하나씩 요청해요. 각각 데이터를 반환할 때만 비용이 들어요:
| 기능 | 내용 | 크레딧 | 플랜 |
|---|---|---|---|
| related_persons | 경영진 | 2 | 모든 계정 |
| shareholders | 주주(베타) | 5 | 모든 계정 |
| shareholders_deep | 심층 주주 정보 | 80 | Max |
| ubos | 실소유자(UBO, 베타) | 10 | 모든 계정 |
| shareholdings | 지분 참여(베타) | 5 | 모든 계정 |
| mergers_and_acquisitions | 인수합병(M&A, 베타) | 20 | 모든 계정 |
| network | 기업 네트워크(베타) | 25 | Pro, Max |
| publications | 이력: 등기 공고 | 1 | 모든 계정 |
| financial_kpi | 재무 KPI | 1 | 모든 계정 |
| balance_sheet_accounts | 재무상태표 | 3 | 모든 계정 |
| profit_and_loss_account | 손익계산서 | 3 | 모든 계정 |
| annual_financial_statements | 연간 재무제표(Markdown) | 5 | 모든 계정 |
| annual_financial_statements__html | 연간 재무제표(HTML) | 5 | 모든 계정 |
| insolvency_publications | 파산 공고 | 5 | 모든 계정 |
| news | 뉴스 | 10 | 모든 계정 |
| website_content | 웹사이트 콘텐츠 · AI 모드와 함께일 때만 | 무료 | 모든 계정 |
모든 기능과 두 추가 요금을 쓰면 fetch-organization 요청은 최대 215 크레딧이에요. 이 범위는 Max에 포함돼요.
모니터는 확인 간격에 따라 30일 기간마다 고정 가격이 들어요. 생성과 첫 기준선은 무료예요.
| 확인 간격 | 30일당 크레딧 |
|---|---|
| 매일 | 50 |
| 3일마다 | 40 |
| 7일마다 | 20 |
| 30일마다 | 10 |
| 기간 내 추가로 성공한 확인 1회당 | +2 |
이 단계들 사이의 간격은 바로 다음으로 더 잦은 단계와 같은 비용이 들어요. 자세한 내용은 account/monitors에 있어요.
데이터를 반환한 것만 지불
데이터가 없는 기능은 비용이 들지 않아요. null이나 빈 목록을 반환하면 지불하지 않아요. insolvency_publications를 포함해 모든 기능에 적용돼요: 파산 공고가 없으면 무료예요.
기본 가격과 추가 요금은 고유한 규칙을 따라요. 기본 가격은 전달된 회사 프로필마다 내요. AI 모드는 일치 결과가 없어도 비용이 들어요. 실시간 모드는 등기부에 바뀐 것이 없어도 실시간 조회가 성공할 때마다 비용이 들어요. 자세한 내용은 추가 요금에 있어요.
일부 기능은 특정 내용이 있는지가 중요해요:
shareholders와shareholders_deep는 현재 항목이 있을 때만 비용이 들어요. 이력만 있으면 무료예요.mergers_and_acquisitions는 거래, 지배 관계, 법적 승계가 있을 때만 비용이 들어요.network는 연결이 하나 이상 있을 때만 비용이 들어요.news는 목록에 기사가 하나라도 있으면 비용이 들어요.
fetch-organization은 플랜에 포함되지 않은 기능을 빼고 과금하지 않아요.
검색 및 내보내기, 문서, Signals는 요청 자체에 대해 지불해요: 결과 한 페이지, 문서 1건, Signals 한 페이지. 결과가 없는 검색과 빈 Signals 페이지도 과금돼요.
실패하거나 거부된 요청은 비용이 들지 않아요. 오류를 참고하세요.
AI 모드와 실시간 모드 추가 요금
fetch-organization에는 요청마다 켜는 추가 요금이 두 가지 있어요.
AI 모드(ai_search=on-default, +20 크레딧)는 모호한 입력으로도 회사를 찾고 웹에서 조사해요. 조사가 실행되면 회사를 찾지 못하거나 데이터 소스가 오류를 보고해도 과금돼요. API가 요청을 408로 중단한 경우에만 과금되지 않아요.
실시간 모드(realtime_mode=handelsregister-default, +10 크레딧)는 Handelsregister(상업 등기부)에서 등기된 인물을 실시간으로 가져와요. 실시간 조회가 성공하면 무엇을 반환하든 추가 요금을 과금해요. 이때 _realtime_mode.status의 값은 success예요.
그 밖의 값은 실시간 조회가 실패했다는 뜻이에요. 그러면 저장된 데이터를 받고, 실시간 추가 요금 없이 나머지 요청 비용만 내요. 요청이 너무 오래 걸리면 API가 408로 응답하고 과금하지 않아요.
1{2 "name": "Hetzner Online GmbH",3 "_realtime_mode": {4 "mode": "handelsregister-default",5 "status": "success"6 },7 "meta": {8 "request_credit_cost": 15,9 "credits_remaining": 14510 }11}
응답에 담긴 비용
모든 응답은 비용을 알려 줘요. JSON 응답에서는 meta에, 문서에서는 헤더에 있어요.
| 위치 | 의미 |
|---|---|
| meta.request_credit_cost |
이 요청의 비용. Idempotency 키를 쓴 재시도와 거의 모든 오류에서는 0이에요.
|
| meta.credits_remaining | 요청 후 잔액. |
| X-Credits-Charged | signals와 전달된 문서: 요청 비용, 헤더로. |
| X-Credits-Remaining | 전달된 문서: 요청 후 잔액, 헤더로. |
1{2 "name": "Hetzner Online GmbH",3 "meta": {4 "request_credit_cost": 5,5 "credits_remaining": 1456 }7}
인증 거부(401, 403)와 한도 초과(429)는 대개 meta 없이 와요. 절대 비용이 들지 않아요.
모든 차감 내역은 계정 › 사용량과 API의 GET /v1/account/usage/transactions에 있어요. account를 참고하세요.
크레딧 부족
API는 요청을 처리하기 전에 잔액이 가능한 최고 비용(기본 가격, 요청한 모든 기능, 추가 요금)을 감당하는지 확인해요. 그렇지 않으면 402로 응답하고 과금하지 않아요.
응답은 이 최대 금액을 meta.request_credit_cost에, 잔액을 meta.credits_remaining에 보여 줘요. 나중에 실제로 과금되는 금액은 데이터가 없는 기능이 무료이므로 더 낮은 경우가 많아요.
예: AI 모드와 ubos 기능을 쓴 기본 데이터는 미리 35 크레딧이 필요해요. ubos가 데이터를 반환하지 않으면 요청 비용은 25 크레딧이에요.
signals는 Problem Details와 코드 INSUFFICIENT_CREDITS로 응답해요.
크레딧 구독과 충전 크레딧
새 계정은 모두 시작 크레딧 150을 받아요. 30일 동안 유효해요.
크레딧 구독(Plus, Pro, Max 또는 Enterprise)을 쓰면 매달 크레딧을 받아요. 결제 기간이 끝날 때까지 유효해요. 플랜을 바꾸면 쓰지 않은 월간 크레딧을 새 기간으로 가져가요. Plus부터 fetch-person을 쓸 수 있고, Pro와 Max는 추가 데이터를 열어 줘요.
충전 크레딧은 한 번씩 추가로 구매해요. 크레딧 구독이 없으면 30일 동안 유효해요. 크레딧 구독이 이어지는 동안에는 충전 크레딧도 시작 크레딧도 만료되지 않아요.
잔액과 만료 일정은 계정 › 크레딧과 API의 GET /v1/account/credits에서 볼 수 있어요.
모든 플랜과 가격은 가격 페이지에 있어요.