Grind away: 부동산 실거래가 조회 API · 정보 조회 자동화 · 호출당 과금 REST API

APICK · SERVICE BROCHURE · 정보 조회

부동산 실거래가 조회 API

지번주소·도로명주소 기반으로 아파트·오피스텔·단독주택의 실거래가 이력을 조회하는 API

💳 호출당 - ⚡ 실시간 응답 🔐 단일 인증키 📡 REST 표준

About APICK

APICK 은 어떤 서비스인가요?

APICK(에이픽) 은 금융·사업자·부동산·신분증·OCR·이미지·문서까지 80여 종의 비즈니스 API 를 REST 표준으로 제공하는 호출당 과금 플랫폼 입니다. 단일 인증키 CL_AUTH_KEY 하나로 모든 API 를 사용할 수 있고, 월 최소 비용 없이 호출한 만큼만 과금되는 투명한 요금 정책이 특징입니다.

✅ 단일 인증키 · 80+ REST API 통합 사용 — 한 번 가입하면 추가 계약 없이 바로 확장
✅ 호출당 포인트 과금 · 월 최소 비용 없음 — 트래픽 규모와 무관하게 부담 없이 시작
✅ 실시간 응답 · 호출 메타 자동 제공 — api.cost · api.ms · api.pl_id 자동 기록

APICK 회원가입 · 지금 시작하기 →

왜 APICK 인가 · 3가지 핵심 강점

정찰제 · 투명 가격

모든 API 가격이 정찰제로 공개되어 누구나 동일한 조건으로 이용합니다.

가입 즉시 전체 사용

회원가입 후 포인트 충전만으로 80여 종 API 를 즉시 호출할 수 있습니다.

5분 연동 · 무심사

별도 인증·심사·계약 없이 가입 후 5분 안에 모든 API 를 연동합니다.

주요 서비스 분야

금융·계좌 인증

계좌 실명 조회 · 은행코드 · 1원 인증 · 거래영업일

사업자·기업

사업자 정보 · 벤처기업 · 휴폐업 · 세무 상태

부동산·등기

건축물대장 · 인터넷등기소 · 토지대장 · 공시지가

개인·신분증 인증

주민번호 진위 · 신분증 OCR·진위 · 개인통관부호

이미지·영상·음성

얼굴 감지·블러 · 워터마크 · STT · TTS · 음성 변환

웹·문서·주소·검색

구글·유튜브 · URL 스크린샷 · PDF·DOCX 변환 · 도로명

한눈에 보는 연동 사양

엔드포인트

/rest/land_rt_price

REST · POST 요청

호출 단가

정책 별도

후불제 정책 별도 · 호출당

응답 시간

api.ms

응답 본문 api.ms 값으로 확인

핵심 특장점 · 빠른 도입 포인트

연동 담당자가 가장 먼저 확인하면 좋은 6가지 포인트입니다.

최소 입력 · 즉시 응답

필수 파라미터만 전달하면 평균 10초 이내, 최대 35초 응답으로 실시간 검증이 가능합니다.

표준 인증 방식

CL_AUTH_KEY (MD5 인증키) 를 헤더로 전달. 별도 OAuth 흐름 없이 즉시 호출 가능합니다.

호출 메타 자동 제공

응답에 api.cost · api.ms · api.pl_id 가 함께 반환되어 과금·성능·결제 로그를 즉시 추적할 수 있습니다.

투명한 과금

선불제 호출당 과금 · 후불제 정책 별도. 응답 본문 api.cost 로 실제 차감 포인트를 확인합니다.

단순 REST 인터페이스

표준 POST 요청 + FormData 형식으로 어떤 언어·프레임워크에서도 즉시 통합 가능합니다.

실패 응답 처리

data.success 값으로 판단: 0 실패 · 1 성공 · 3 타임아웃. 실패 응답은 정책에 따라 과금되지 않을 수 있습니다.

도입 효과

호출 메타 자동 제공 · 표준 REST 인터페이스 · 실시간 응답으로 기존 서비스 흐름에 즉시 편입됩니다.

✅ 호출 메타 자동 제공

api.cost / api.ms / api.pl_id 로 호출당 과금·성능·결제 로그를 즉시 추적합니다.

✅ 표준 REST 인터페이스

단순 POST + FormData 구조로 어떤 언어·프레임워크에서도 즉시 통합됩니다.

✅ 실시간 응답

평균 10초 이내 응답으로 사용자 흐름 중간에 자연스럽게 호출할 수 있습니다.

연동 사양 요약

Method	POST
Endpoint	`https://apick.app/rest/land_rt_price`
Header	CL_AUTH_KEY(인증키(MD5))
FormData	값: addr1, addr2, type, year
Response	data · api 객체
api 객체	success · cost · ms · pl_id
success 값	0 실패 · 1 성공 · 3 타임아웃
응답시간	api.ms 값으로 확인 · 네트워크 상황에 따라 변동
과금 단위	- / 호출당

요청 파라미터

이름	타입	필수	설명
`addr1`	String	필수	도,광역시,특별시 (17개 지역 옵션)
`addr2`	String	필수	시, 군, 구
`type`	String	필수	유형(A~H): A=아파트, B=연립/다세대, C=단독/다가구, D=오피스텔, E=분양/입주권, F=상업/업무용, G=토지, H=공장/창고등
`year`	String	필수	조회 년도

요청 예시 · cURL

공식 가이드 기준 파라미터를 FormData 로 전달, 인증키는 헤더로 전달합니다.

curl -k -X POST "https://apick.app/rest/land_rt_price" \
  -H "CL_AUTH_KEY: $API_KEY" \
  -F "addr1=sample" \
  -F "addr2=sample" \
  -F "type=sample" \
  -F "year=sample"

응답 예시 · JSON 샘플

표준 응답 구조 샘플입니다. 실제 필드·값은 호출 대상에 따라 달라질 수 있으며, 정확한 스펙은 공식 개발가이드를 기준으로 확인하세요.

{
  "data": {
    "result": 1,
    "data": [
      {
        "NO": "1",
        "시군구": "서울특별시 금천구 시흥동",
        "번지": "111",
        "본번": "0111",
        "부번": "0000",
        "단지명": "OO",
        "전용면적(㎡)": "59.6800",
        "계약년월": "202501",
        "계약일": "01",
        "거래금액(만원)": "99,999",
        "동": "-",
        "층": "2",
        "매수자": "개인",
        "매도자": "개인",
        "건축년도": "2000",
        "도로명": "OO대로OO길 OO",
        "해제사유발생일": "-",
        "거래유형": "직거래",
        "중개사소재지": "-",
        "등기일자": "25.01.07"
      }
    ],
    "count": 4,
    "success": 1
  },
  "api": {
    "success": true,
    "cost": 100,
    "ms": 390,
    "pl_id": 4135
  }
}

응답 필드

경로	타입	설명
`data.result`	Integer	검색 결과 (0=유효하지 않은 입력, 1=성공, 2=오류, 3=처리시간 초과)
`data.msg`	String	메시지 내용 (result=0인 경우)
`data.error`	String	오류 내용 (result=2,3인 경우)
`data.options`	Array	result=0인 경우 입력 가능한 값 목록
`data.data`	Array	실거래 목록
`data.data[].NO`	String	NO
`data.data[].시군구`	String	시군구
`data.data[].번지`	String	번지
`data.data[].본번`	String	본번
`data.data[].부번`	String	부번
`data.data[].단지명`	String	단지명
`data.data[].전용면적(㎡)`	String	전용면적(㎡)
`data.data[].계약년월`	String	계약년월
`data.data[].계약일`	String	계약일
`data.data[].거래금액(만원)`	String	거래금액(만원)
`data.data[].동`	String	동
`data.data[].층`	String	층
`data.data[].매수자`	String	매수자
`data.data[].매도자`	String	매도자
`data.data[].건축년도`	String	건축년도
`data.data[].도로명`	String	도로명 주소
`data.data[].해제사유발생일`	String	해제사유발생일
`data.data[].거래유형`	String	거래유형
`data.data[].중개사소재지`	String	중개사소재지
`data.data[].등기일자`	String	등기일자
`data.count`	Integer	조회된 총 개수
`data.success`	Integer	과금 여부 (0=실패, 1=성공, 3=실패-timeout)
`api.success`	Boolean	API 서버 정상 응답 여부
`api.cost`	Integer	API 호출 요금
`api.ms`	Integer	API 응답 시간
`api.pl_id`	Integer	API 결제 로그 ID

도입 체크리스트

Checklist

연동 작업 전 확인이 필요한 항목

✓APICK 회원가입 후 인증키(CL_AUTH_KEY) 발급

✓선불제 포인트 충전 또는 후불제 약정

✓호출 IP 화이트리스트 설정 검토

✓응답 객체 파싱 및 빈 값 처리 정책 수립

✓타임아웃(35초) 대응 로직 구현

✓api.cost 기반 과금 모니터링 구성

📄 부동산 실거래가 조회 API 가이드 PDF 다운로드

지금 바로 APICK 에 연동해보세요

회원가입 즉시 CL_AUTH_KEY 발급.
부동산 실거래가 조회 API 는 호출당 정책 별도, 월 최소 비용 없이 호출한 만큼만 과금됩니다.

APICK 회원가입 · 지금 시작하기 → 공식 개발 가이드 보기

* 본 문서는 APICK 공식 스펙을 바탕으로 정리한 연동 참고 자료입니다. 최신·정확한 스펙은 공식 개발 가이드 를 기준으로 확인하세요.

#APICK #에이픽 #비즈니스API #호출당과금API #RESTAPI #단일인증키API #월최소비용없는API #개발자API #부동산실거래가조회API

Grind away

2026년 4월 22일 수요일

부동산 실거래가 조회 API · 정보 조회 자동화 · 호출당 과금 REST API | APICK 에이픽