개발자용 API
주소 한 줄, 법인등록번호 하나로 부동산·법인 등기사항증명서를 PDF로 바로 받습니다. 한두 건 확인부터 수천 건 대량 발급까지 같은 API로 자동화하세요.
서비스·시스템에 연동하는 기업·개발자를 위한 API입니다. 인증키로 호출하고 사용한 만큼 포인트가 차감됩니다.
등기부등본(등기사항증명서)은 부동산과 법인의 권리관계와 그 변동 내역이 담긴 공적 기록입니다. 소유자, 근저당·압류 같은 권리, 법인의 임원과 본점을 확인하는 가장 기본적인 서류입니다.
쓰임새는 계속 늘어납니다. 계약 전 한 건을 확인하는 일도 있지만, 재개발 구역 전체나 대단지 아파트 전 세대처럼 수백·수천 건을 한꺼번에 떼어야 하는 일이 빠르게 늘고 있습니다.
에이픽 등기부등본 API는 이 반복 업무를 프로그램 호출로 바꿉니다. 주소나 고유번호 목록을 넣으면 대상을 확정하고, 열람·발급한 PDF를 물건별로 바로 저장합니다.
이전한 건씩 직접 열람·발급
이제주소·고유번호 목록을 돌며 호출하면 수백·수천 건도 사람 손 없이 순서대로 처리합니다.
이전화면 캡처·종이로 남는 결과
이제등기사항증명서를 PDF 파일로 바로 받아 물건 번호별로 저장·공유합니다. 받은 PDF는 72시간 안에 다시 내려받을 수 있습니다.
이전비슷한 주소로 엉뚱한 대상 발급
이제검색 API로 부동산고유번호를 먼저 확정한 뒤 발급해 동·호 착오를 막습니다.
이전재전송 때 중복 발급·중복 결제
이제idempotency_key 를 같이 보내면 네트워크 오류로 다시 보내도 한 번만 발급·과금합니다.
이전서류마다 떼는 곳이 달라 따로 처리
이제같은 인증키로 건축물대장·토지 정보·실거래가·경매 진행 정보까지 함께 받아 한 흐름으로 묶습니다.
이전받은 등본이 진짜인지 확인
이제발급확인번호만 넣으면 발급 사실과 증명서 종류·발급일을 확인하는 진위 확인 API도 있습니다.
한 계정이 동시에 처리하는 요청 수에는 상한이 있습니다. 429 응답을 받으면 잠시 쉬었다가 같은 요청을 다시 보내세요. 직접 개발하기 어렵거나 정기 대량 발급이 필요하면 맞춤형 API 문의로 상담하세요. 맞춤형 API 문의
인증키는 Authorization: Bearer 헤더로 보냅니다. 서버에서만 호출하고 인증키를 브라우저·앱에 넣지 마세요.
curl -X POST "https://apick.app/rest/registry_realestate_jobs" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"서울특별시 예시구 예시로 123","index":1,"usage":"view"}' \
-o registry.pdf
import { writeFile } from "node:fs/promises";
const API = "https://apick.app/rest";
const headers = { Authorization: "Bearer " + process.env.APICK_API_KEY, "Content-Type": "application/json" };
const post = (path, body) => fetch(API + path, { method: "POST", headers, body: JSON.stringify(body) });
const addresses = ["서울특별시 예시구 예시로 123", "서울특별시 예시구 예시로 125"]; // 목록 파일에서 읽어 오세요
for (const query of addresses) {
// ① 대상 확정: 검색 결과의 부동산고유번호(pin)
const found = await (await post("/registry_realestate_search", { query })).json();
const target = found.data.targets?.[0];
if (!target) { console.log("대상 없음", query); continue; }
// ② 열람 → PDF 저장. 같은 키로 다시 보내면 추가 과금 없이 같은 PDF를 받습니다.
const res = await post("/registry_realestate_jobs", { pin: target.pin, usage: "view", idempotency_key: "batch-" + target.pin });
if ((res.headers.get("content-type") || "").includes("application/pdf")) {
await writeFile(target.pin + ".pdf", Buffer.from(await res.arrayBuffer()));
} else {
const { data } = await res.json();
console.log("다시 보낼 목록", query, data.error_code || data.pdf); // 429·준비 중이면 잠시 뒤 같은 키로
}
}
HTTP/1.1 200 OK
Content-Type: application/pdf
X-Apick-Job-Id: <작업 번호 · 재다운로드에 사용>
X-Apick-Cost: <차감된 포인트>
(등기사항증명서 PDF 본문)
성공하면 JSON이 아니라 PDF 파일이 바로 옵니다. 실패하면 data.error·data.error_code가 담긴 JSON이 오고 포인트는 차감되지 않습니다.
HTTP 상태 → api.success → data.error → api.cost 순서로 확인하세요. 실패 응답은 과금되지 않습니다.
REGISTRY_TOO_MANY_ACTIVEHTTP 429동시에 처리할 수 있는 작업 수를 넘었습니다. 진행 중인 요청이 끝난 뒤 같은 요청을 다시 보내세요.
REGISTRY_BAD_REQUESTHTTP 400query 또는 pin 이 없거나 형식이 맞지 않습니다. 검색 결과의 pin 을 그대로 넣으세요.
REGISTRY_MAINTENANCEHTTP 503등기 발급 시스템 점검 시간입니다. 점검이 끝난 뒤 다시 보내세요. 차감되지 않습니다.
REGISTRY_POINTS_INSUFFICIENTHTTP 402포인트가 부족합니다. 충전한 뒤 같은 요청을 다시 보내세요.
REGISTRY_PDF_EXPIREDHTTP 410재다운로드 보관 기한(72시간)이 지났습니다. 다시 열람·발급을 요청하세요.
전체 응답 항목과 오류 코드는 개발 문서에 있습니다.