부동산 실거래가 조회

기능·제공 범위

인증: Bearer 키
요청: form-data
응답: JSON
요금·이용 조건: 기본 단가 100P · 건당

빠른 시작

서버의 APICK_API_KEY를 준비하고 입력값을 바꾸세요. 아래에서 경로별 입력·응답·실행 환경을 함께 확인할 수 있습니다.

요청과 응답

API 요청 예제직접 실행하지 않습니다POST /rest/land_rt_price

POSIX 셸 · APICK_API_KEY 환경변수를 먼저 설정하세요. Windows에서는 Unicode 지원 cURL을 사용하세요.

curl --fail-with-body --request POST 'https://apick.app/rest/land_rt_price' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form-string 'addr1=서울특별시' \
  --form-string 'addr2=금천구' \
  --form-string 'type=A' \
  --form-string 'year=2025'

Node.js 22+ · 서버에서 실행하는 ESM 예제입니다. 키를 브라우저에 넣지 마세요.

const form = new FormData();
form.append("addr1", "서울특별시");
form.append("addr2", "금천구");
form.append("type", "A");
form.append("year", "2025");
const response = await fetch("https://apick.app/rest/land_rt_price", {
  method: "POST",
  headers: { Authorization: "Bearer " + process.env.APICK_API_KEY },
  body: form,
  signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
const result = await response.json();
console.log(result);

Python 3 · requests 설치가 필요합니다. 키는 서버 환경변수로 읽습니다.

import os
import requests
parts = [
    ("addr1", (None, "서울특별시")),
    ("addr2", (None, "금천구")),
    ("type", (None, "A")),
    ("year", (None, "2025")),
]
response = requests.request("POST", "https://apick.app/rest/land_rt_price",
    headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]},
    files=parts,
    timeout=(10, 120))
response.raise_for_status()
result = response.json()
print(result)

PHP 8 · cURL 확장이 필요합니다. 키는 서버 환경변수로 읽습니다.

<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$form = [
    'addr1' => '서울특별시',
    'addr2' => '금천구',
    'type' => 'A',
    'year' => '2025',
];
$curl = curl_init('https://apick.app/rest/land_rt_price');
curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_POSTFIELDS => $form,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120,
]);
$body = curl_exec($curl);
if ($body === false) { throw new RuntimeException(curl_error($curl)); }
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($status >= 400) { throw new RuntimeException($body); }
$result = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

POSIX 셸 · APICK_API_KEY 환경변수를 먼저 설정하세요. Windows에서는 Unicode 지원 cURL을 사용하세요.

curl --fail-with-body --request POST 'https://apick.app/rest/land_rt_price' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --connect-timeout 10 --max-time 120 \
  --form-string 'addr1=서울특별시' \
  --form-string 'addr2=금천구' \
  --form-string 'type=A' \
  --form-string 'year=2025'

Node.js 22+ · 서버에서 실행하는 ESM 예제입니다. 키를 브라우저에 넣지 마세요.

const form = new FormData();
form.append("addr1", "서울특별시");
form.append("addr2", "금천구");
form.append("type", "A");
form.append("year", "2025");
const response = await fetch("https://apick.app/rest/land_rt_price", {
  method: "POST",
  headers: { Authorization: "Bearer " + process.env.APICK_API_KEY },
  body: form,
  signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
const result = await response.json();
if (result.error || result.data?.error || result.result?.error || result.success === false || result.api?.success === false) {
  throw new Error(JSON.stringify(result));
}
console.log(result);

Python 3 · requests 설치가 필요합니다. 키는 서버 환경변수로 읽습니다.

import os
import requests
parts = [
    ("addr1", (None, "서울특별시")),
    ("addr2", (None, "금천구")),
    ("type", (None, "A")),
    ("year", (None, "2025")),
]
response = requests.request("POST", "https://apick.app/rest/land_rt_price",
    headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]},
    files=parts,
    timeout=(10, 120))
response.raise_for_status()
result = response.json()
if result.get("error") or (isinstance(result.get("data"), dict) and result["data"].get("error")) or (isinstance(result.get("result"), dict) and result["result"].get("error")) or result.get("success") is False or (result.get("api") or {}).get("success") is False:
    raise RuntimeError(result)
print(result)

PHP 8 · cURL 확장이 필요합니다. 키는 서버 환경변수로 읽습니다.

<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$form = [
    'addr1' => '서울특별시',
    'addr2' => '금천구',
    'type' => 'A',
    'year' => '2025',
];
$curl = curl_init('https://apick.app/rest/land_rt_price');
curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_POSTFIELDS => $form,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120,
]);
$body = curl_exec($curl);
if ($body === false) { throw new RuntimeException(curl_error($curl)); }
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($status >= 400) { throw new RuntimeException($body); }
$result = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
if (!empty($result["error"]) || !empty($result["data"]["error"]) || !empty($result["result"]["error"]) || ($result["success"] ?? true) === false || ($result["api"]["success"] ?? true) === false) {
    throw new RuntimeException($body);
}
print_r($result);

API 요청

POST/rest/land_rt_price

Bearer 인증 · multipart/form-data · JSON 응답

입력 항목

폼 항목·타입

필수

설명·예제

addr1string

필수

도/광역시/특별시 정식 명칭 (예: 서울특별시, 경기도, 부산광역시)예: 서울특별시

addr2string

필수

시/군/구 (예: 금천구)예: 금천구

typestring

필수

유형 코드 A~H 중 하나. A:아파트, B:연립/다세대, C:단독/다가구, D:오피스텔, E:분양/입주권, F:상업/업무용, G:토지, H:공장/창고등예: A

yearstring

필수

조회 년도 (1950 ~ 현재 년도, 예: 2025)예: 2025

응답과 성공 판정

HTTP 성공과 업무 결과를 구분하세요. 아래 서비스별 결과 필드가 실제 성공·실패를 나타냅니다.

응답 상태

{
  "data": {
    "result": 1,
    "data": [
      {
        "NO": "1",
        "시군구": "서울특별시 금천구 시흥동",
        "번지": "111",
        "본번": "0111",
        "부번": "0000",
        "단지명": "OO",
        "전용면적(㎡)": "59.6800",
        "계약년월": "202501",
        "계약일": "01",
        "거래금액(만원)": "99,999",
        "동": "-",
        "층": "2",
        "매수자": "개인",
        "매도자": "개인",
        "건축년도": "2000",
        "도로명": "OO대로OO길 OO",
        "해제사유발생일": "-",
        "거래유형": "직거래",
        "중개사소재지": "-",
        "등기일자": "25.01.07"
      },
      {
        "NO": "2",
        "시군구": "서울특별시 금천구 시흥동",
        "번지": "1010",
        "본번": "1010",
        "부번": "0000",
        "단지명": "OO",
        "전용면적(㎡)": "84.9900",
        "계약년월": "202501",
        "계약일": "01",
        "거래금액(만원)": "99,999",
        "동": "-",
        "층": "15",
        "매수자": "개인",
        "매도자": "개인",
        "건축년도": "2000",
        "도로명": "OO로 OOO",
        "해제사유발생일": "-",
        "거래유형": "중개거래",
        "중개사소재지": "서울 금천구",
        "등기일자": "-"
      },
      {
        "NO": "3",
        "시군구": "서울특별시 금천구 가산동",
        "번지": "222-22",
        "본번": "0222",
        "부번": "0022",
        "단지명": "OO5차",
        "전용면적(㎡)": "62.5300",
        "계약년월": "202501",
        "계약일": "01",
        "거래금액(만원)": "99,900",
        "동": "-",
        "층": "3",
        "매수자": "개인",
        "매도자": "개인",
        "건축년도": "2001",
        "도로명": "OO로OO길 OO",
        "해제사유발생일": "-",
        "거래유형": "중개거래",
        "중개사소재지": "서울 금천구",
        "등기일자": "-"
      },
      {
        "NO": "4",
        "시군구": "서울특별시 금천구 독산동",
        "번지": "5555",
        "본번": "5555",
        "부번": "0000",
        "단지명": "금천OOOOOOOO3차",
        "전용면적(㎡)": "59.9672",
        "계약년월": "202501",
        "계약일": "04",
        "거래금액(만원)": "99,000",
        "동": "-",
        "층": "14",
        "매수자": "개인",
        "매도자": "개인",
        "건축년도": "2018",
        "도로명": "OO대로 OOO",
        "해제사유발생일": "-",
        "거래유형": "중개거래",
        "중개사소재지": "서울 금천구",
        "등기일자": "-"
      }
    ],
    "count": 4,
    "success": 1
  },
  "api": {
    "success": true,
    "cost": 100,
    "ms": 390,
    "pl_id": 4135
  }
}

필드·타입

의미·조건

dataobject

조회 데이터

data.resultinteger

검색 결과 0: 유효하지 않은 시, 도 등 입력 시(options와 함께 응답) 1: 성공 2: 오류(에이픽 서버 오류)(해당 오류 발생 시 요청 내용과 함께 문의글로 남겨주시기 바랍니다.) 3: 오류(처리시간 초과)

data.dataarray

조회 데이터

data.data[].NOstring

아래 하위 항목을 확인하세요.

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.countinteger

조회된 총 개수

data.successinteger

과금 여부0: 실패1: 성공3: 실패(timeout)

data.msgstring

메시지 내용 (result가 0인 경우 반환)

data.optionsarray

result가 0인 경우 입력 가능한 값 목록

data.errorstring

오류 내용 (result가 2,3인 경우 반환)

apiobject

API 호출 공통 데이터

api.successboolean

API 서버 정상 응답 여부

api.costinteger

API 호출 요금

api.msinteger

API 응답 시간

api.pl_idinteger

API 결제 로그 ID

정적 연동 예시입니다. 실제 계정·개인정보를 조회하지 않습니다.

추가 입력 조건·전송 규칙

Header

이름

필수

설명

Authorization

O

Bearer 인증키

응답 상세

서비스 고유 응답·필드 상세 설명

Body

이름

타입

설명

data

Object

조회 데이터

result

Integer

검색 결과
0: 유효하지 않은 시, 도 등 입력 시
(options와 함께 응답)
1: 성공
2: 오류(에이픽 서버 오류)
(해당 오류 발생 시 요청 내용과 함께 문의글로 남겨주시기 바랍니다.)
3: 오류(처리시간 초과)

msg

String

메시지 내용
(result가 0인 경우 반환)

error

String

오류 내용
(result가 2,3인 경우 반환)

options

Array

result가 0인 경우 입력 가능한 값 목록

data

Array

실거래 목록

{}

Object

거래 정보

NO

String

NO

시군구

String

시군구

번지

String

번지

본번

String

본번

부번

String

부번

단지명

String

단지명

전용면적(㎡)

String

전용면적(㎡)

계약년월

String

계약년월

계약일

String

계약일

거래금액(만원)

String

거래금액(만원)

동

String

동

층

String

층

매수자

String

매수자

매도자

String

매도자

건축년도

String

건축년도

도로명

String

도로명 주소

해제사유발생일

String

해제사유발생일

거래유형

String

거래유형

중개사소재지

String

중개사소재지

등기일자

String

등기일자

count

Integer

조회된 총 개수

success

Integer

과금 여부
0: 실패
1: 성공
3: 실패(timeout)

api

Object

API 호출 공통 데이터

success

Boolean

API 서버 정상 응답 여부

cost

Integer

API 호출 요금

ms

Integer

API 응답 시간

pl_id

Integer

API 결제 로그 ID

경로별 응답 예시와 필드 명세는 위 API 요청 설명에 붙어 있습니다. JSON을 파일로 저장하기 전에는 Content-Type과 오류를 확인하세요.

상태·오류·재시도

HTTP 상태 → API 처리 여부 → 업무 상태 순서로 확인하세요. 결과 유무와 과금 여부는 서로 다릅니다.

공통 폼 입력 오류

FORM_DATA_INVALID · HTTP 400: 필드 이름·타입·배열 인덱스를 확인하세요. 인덱스는 0부터 연속으로 사용합니다.

FORM_DATA_FIELD_CONFLICT · HTTP 400: 같은 값과 중첩 경로를 동시에 지정하지 마세요.

MULTIPART_LIMIT_OR_PARSE_ERROR · HTTP 400/413: boundary·파일 크기·필드 개수를 확인하세요. 서비스별 제한이 우선 적용됩니다.

요금·제한·이용 조건

기능·제공 범위·요금·제한 전체 보기

해당 년도에 실제 거래된 내역을 조회합니다.

Method

URL

POST

https://apick.app/rest/land_rt_price

addr1에 유효하지 않은 시,도 등을 입력 시 "입력항목이 잘못됐습니다."라는 메시지와 함께 options 으로 유효한 목록이 응답됩니다. addr2에 유효하지 않은 시,군,구 등을 입력 시 "입력항목이 잘못됐습니다."라는 메시지와 함께 options 으로 유효한 목록이 응답됩니다.

연동 시 확인할 내용

예제는 경로별로 최소 요청과 오류 처리 포함 모드를 제공합니다. 실제 사용 환경의 시간 제한·취소·업무 성공 판정을 적용하세요.

추가 예제·서비스별 연동 안내

요청 예시

예시 1
예시 2

form-data 전체 예제 보기

응답 예시

예시 1
예시 2


{
    "data": {
        "result": 1,
        "data": [
            {
                "NO": "1",
                "시군구": "서울특별시 금천구 시흥동",
                "번지": "111",
                "본번": "0111",
                "부번": "0000",
                "단지명": "OO",
                "전용면적(㎡)": "59.6800",
                "계약년월": "202501",
                "계약일": "01",
                "거래금액(만원)": "99,999",
                "동": "-",
                "층": "2",
                "매수자": "개인",
                "매도자": "개인",
                "건축년도": "2000",
                "도로명": "OO대로OO길 OO",
                "해제사유발생일": "-",
                "거래유형": "직거래",
                "중개사소재지": "-",
                "등기일자": "25.01.07"
            },
            {
                "NO": "2",
                "시군구": "서울특별시 금천구 시흥동",
                "번지": "1010",
                "본번": "1010",
                "부번": "0000",
                "단지명": "OO",
                "전용면적(㎡)": "84.9900",
                "계약년월": "202501",
                "계약일": "01",
                "거래금액(만원)": "99,999",
                "동": "-",
                "층": "15",
                "매수자": "개인",
                "매도자": "개인",
                "건축년도": "2000",
                "도로명": "OO로 OOO",
                "해제사유발생일": "-",
                "거래유형": "중개거래",
                "중개사소재지": "서울 금천구",
                "등기일자": "-"
            },
            {
                "NO": "3",
                "시군구": "서울특별시 금천구 가산동",
                "번지": "222-22",
                "본번": "0222",
                "부번": "0022",
                "단지명": "OO5차",
                "전용면적(㎡)": "62.5300",
                "계약년월": "202501",
                "계약일": "01",
                "거래금액(만원)": "99,900",
                "동": "-",
                "층": "3",
                "매수자": "개인",
                "매도자": "개인",
                "건축년도": "2001",
                "도로명": "OO로OO길 OO",
                "해제사유발생일": "-",
                "거래유형": "중개거래",
                "중개사소재지": "서울 금천구",
                "등기일자": "-"
            },
            {
                "NO": "4",
                "시군구": "서울특별시 금천구 독산동",
                "번지": "5555",
                "본번": "5555",
                "부번": "0000",
                "단지명": "금천OOOOOOOO3차",
                "전용면적(㎡)": "59.9672",
                "계약년월": "202501",
                "계약일": "04",
                "거래금액(만원)": "99,000",
                "동": "-",
                "층": "14",
                "매수자": "개인",
                "매도자": "개인",
                "건축년도": "2018",
                "도로명": "OO대로 OOO",
                "해제사유발생일": "-",
                "거래유형": "중개거래",
                "중개사소재지": "서울 금천구",
                "등기일자": "-"
            }
        ],
        "count": 4,
        "success": 1
    },
    "api": {
        "success": true,
        "cost": 100,
        "ms": 390,
        "pl_id": 4135
    }
}


{
    "data": {
        "msg": "[addr2] 입력 항목이 잘못됐습니다.",
        "result": 0,
        "options": [
            "강남구",
            "강동구",
            "강북구",
            "강서구",
            "관악구",
            "광진구",
            "구로구",
            "금천구",
            "노원구",
            "도봉구",
            "동대문구",
            "동작구",
            "마포구",
            "서대문구",
            "서초구",
            "성동구",
            "성북구",
            "송파구",
            "양천구",
            "영등포구",
            "용산구",
            "은평구",
            "종로구",
            "중구",
            "중랑구"
        ],
        "success": 1
    },
    "api": {
        "success": true,
        "cost": 100,
        "ms": 240,
        "pl_id": 4134
    }
}

기능·제공 범위

빠른 시작

요청과 응답

API 요청

입력 항목

응답과 성공 판정

Header

응답 상세

Body

상태·오류·재시도

요금·제한·이용 조건

연동 시 확인할 내용

요청 예시

응답 예시

개발가이드 검색

AI•LLM

전체상품

API 체험하기

요금정책

고객지원

개발가이드