# 부동산 실거래가 조회



부동산의 실제 거래이력을 조회합니다.



인증: Authorization: Bearer $APICK_API_KEY

본문 있는 REST 요청: multipart/form-data. GET 본문 및 MCP JSON-RPC 규격은 해당 명세를 따릅니다.

인증키는 서버에 보관하세요. 모든 예제는 정적 자료입니다.



## POST /rest/land_rt_price 응답 필드

- `data` (object): 요청 처리 결과 묶음입니다. 조회한 값·작업 상태·오류 설명이 이 안에 들어 있으며, 실제 하위 필드 구성은 서비스마다 다릅니다. 값이 없으면 null·빈 배열·필드 생략 중 해당 서비스의 규칙을 따릅니다.

- `data.result` (integer): 조회 결과 본문입니다. 서비스가 찾은 실제 데이터가 들어 있으며, 자료가 없거나 조회에 실패하면 null이거나 필드가 생략됩니다.

- `data.data` (array): 조회한 자료 행 목록입니다. 각 행은 서비스가 정한 항목 이름과 값으로 구성됩니다.

- `data.data[].NO` (string): 응답 행의 순번입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.data[].시군구` (string): 주소를 구성하는 행정구역·지번 정보입니다. 같은 거래라도 표기 기준에 따라 값이 달라질 수 있으므로 도로명 주소와 함께 확인하세요.

- `data.data[].번지` (string): 주소를 구성하는 행정구역·지번 정보입니다. 같은 거래라도 표기 기준에 따라 값이 달라질 수 있으므로 도로명 주소와 함께 확인하세요.

- `data.data[].본번` (string): 주소를 구성하는 행정구역·지번 정보입니다. 같은 거래라도 표기 기준에 따라 값이 달라질 수 있으므로 도로명 주소와 함께 확인하세요.

- `data.data[].부번` (string): 주소를 구성하는 행정구역·지번 정보입니다. 같은 거래라도 표기 기준에 따라 값이 달라질 수 있으므로 도로명 주소와 함께 확인하세요.

- `data.data[].단지명` (string): 아파트·주상복합 등 단지 이름입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.

- `data.data[].전용면적(㎡)` (string): 면적 값입니다. 단위는 제곱미터(㎡)이며, 평 단위로 보려면 3.3058로 나눕니다.

- `data.data[].계약년월` (string): 실거래 계약이 체결된 연월(또는 일자)입니다. 신고일과 다를 수 있으며, YYYYMM·YYYYMMDD 형식으로 옵니다.

- `data.data[].계약일` (string): 실거래 계약이 체결된 연월(또는 일자)입니다. 신고일과 다를 수 있으며, YYYYMM·YYYYMMDD 형식으로 옵니다.

- `data.data[].거래금액(만원)` (string): 실거래 금액입니다. 단위는 만원이며, 숫자만 오므로 원 단위로 환산하려면 10,000을 곱합니다.

- `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): 조회된 거래 건수입니다. 건수입니다. 0이면 해당 항목이 없습니다. 숫자로 오며, 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요.

- `data.success` (integer): 업무 처리 결과 코드입니다. 1은 정상 결과, 0은 실패 또는 무료 응답입니다. 서비스에 따라 2·3처럼 추가 코드를 쓰므로 같은 응답의 status·msg·error 필드도 함께 확인하세요.

- `data.msg` (string): 처리 결과를 사람이 읽을 수 있는 문장으로 설명합니다. 성공·실패 사유가 담기며, 오류 코드는 별도 필드에서 확인합니다.

- `data.options` (array): result=0일 때 입력 가능한 지역 이름 목록입니다. 각 항목의 구성은 서비스에 따라 다르며, 값이 없으면 빈 배열입니다. 항목 수와 순서를 함께 확인하세요.

- `api` (object): API 호출 메타데이터입니다. 이번 요청의 서버 처리 성공 여부(api.success), 실제 차감 포인트(api.cost), 결제 기록 ID(api.pl_id)를 담습니다. 처리 시간(api.ms)은 응답에 포함된 경우에만 제공됩니다. 업무 결과는 data에서 확인합니다.

- `api.success` (boolean): API 서버가 이번 요청을 정상 처리했는지 여부입니다. true여도 업무 결과가 실패일 수 있으므로 data.success·data.status와 함께 판단합니다. 인증 실패·잘못된 입력·서버 오류 응답에서는 false입니다.

- `api.cost` (integer): 이번 호출에서 실제로 차감된 포인트입니다. 유료 성공 응답에서만 단가만큼 차감되며, 실패·무료 조회·같은 요청의 멱등 재전송은 0입니다. 화면의 표시 단가와 실제 차감액이 다를 수 있으므로 정산은 이 값을 기준으로 합니다.

- `api.ms` (integer): 서버가 요청을 받아 응답 본문을 만들기까지 걸린 처리 시간(밀리초)입니다. 네트워크 왕복 시간과 클라이언트 대기 시간은 포함되지 않습니다.

- `api.pl_id` (integer): 포인트 차감 기록 ID입니다. 차감이 발생한 호출에만 값이 있으며, 과금 내역을 문의할 때 이 번호를 사용합니다. 무과금 응답은 -1·null이거나 필드가 생략됩니다.

## API 요청: POST /rest/land_rt_price



### 입력

- `addr1` (string, 필수): 주소의 시·도 정식 명칭입니다. 예: 서울특별시, 경기도, 부산광역시. 축약형(서울, 경기)은 인식되지 않을 수 있습니다.

- `addr2` (string, 필수): 주소의 시·군·구 이름입니다. 예: 금천구, 수원시. 시·도(addr1)와 함께 보냅니다.

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

- `year` (string, 필수): 조회할 연도(4자리)입니다. 1950년부터 현재 연도까지 지원하며, 예: 2025. 최근 연도는 신고·집계 지연으로 자료가 없을 수 있습니다.



### 응답 명세

```json

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "result": {
          "type": "integer",
          "description": "1: 거래 목록 조회 성공, 0: 지역 이름이 목록에 없음(data.options 확인)."
        },
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "NO": {
                "type": "string"
              },
              "시군구": {
                "type": "string",
                "description": "시·군·구와 법정동입니다."
              },
              "번지": {
                "type": "string",
                "description": "번지입니다. 본번·부번은 4자리로 맞춘 값입니다."
              },
              "본번": {
                "type": "string"
              },
              "부번": {
                "type": "string"
              },
              "단지명": {
                "type": "string",
                "description": "단지·건물 이름입니다."
              },
              "전용면적(㎡)": {
                "type": "string",
                "description": "전용면적(㎡)입니다."
              },
              "계약년월": {
                "type": "string",
                "description": "계약 연월 YYYYMM입니다. 계약일과 합쳐 계약일자를 만듭니다."
              },
              "계약일": {
                "type": "string"
              },
              "거래금액(만원)": {
                "type": "string",
                "description": "거래금액(만 원)입니다. 쉼표가 들어 있으므로 숫자로 바꿀 때 쉼표를 지우세요."
              },
              "동": {
                "type": "string"
              },
              "층": {
                "type": "string",
                "description": "층입니다."
              },
              "매수자": {
                "type": "string",
                "description": "매수자 구분입니다. 예: 개인, 법인."
              },
              "매도자": {
                "type": "string",
                "description": "매도자 구분입니다."
              },
              "건축년도": {
                "type": "string",
                "description": "건축 연도입니다."
              },
              "도로명": {
                "type": "string",
                "description": "도로명주소입니다."
              },
              "해제사유발생일": {
                "type": "string",
                "description": "계약이 해제된 경우 그 날짜입니다. 값이 있으면 실제로 성사되지 않은 거래이므로 시세 계산에서 빼세요."
              },
              "거래유형": {
                "type": "string",
                "description": "중개거래 또는 직거래입니다."
              },
              "중개사소재지": {
                "type": "string",
                "description": "중개거래일 때 중개사무소의 시·군·구입니다."
              },
              "등기일자": {
                "type": "string",
                "description": "소유권 이전 등기일(YY.MM.DD)입니다. 아직 등기 전이면 -입니다."
              }
            }
          },
          "description": "거래 목록입니다. 항목 이름은 한글이며 유형(type)에 따라 일부 항목이 다를 수 있으므로 있는 항목만 읽으세요. 값이 없으면 -입니다."
        },
        "count": {
          "type": "integer",
          "description": "조회된 거래 건수입니다."
        },
        "success": {
          "type": "integer"
        },
        "msg": {
          "type": "string",
          "description": "result=0일 때 어느 입력이 틀렸는지 알려 주는 문구입니다."
        },
        "options": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "result=0일 때 입력 가능한 지역 이름 목록입니다."
        }
      }
    },
    "api": {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean"
        },
        "cost": {
          "type": "integer",
          "description": "차감된 포인트입니다."
        },
        "ms": {
          "type": "integer"
        },
        "pl_id": {
          "type": "integer"
        }
      }
    }
  }
}

```

### 정적 응답 예시

```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"
      },
      {
        "NO": "2",
        "시군구": "서울특별시 금천구 가산동",
        "번지": "222-22",
        "본번": "0222",
        "부번": "0022",
        "단지명": "OO5차",
        "전용면적(㎡)": "62.5300",
        "계약년월": "202501",
        "계약일": "01",
        "거래금액(만원)": "99,900",
        "동": "-",
        "층": "3",
        "매수자": "개인",
        "매도자": "개인",
        "건축년도": "2001",
        "도로명": "OO로OO길 OO",
        "해제사유발생일": "-",
        "거래유형": "중개거래",
        "중개사소재지": "서울 금천구",
        "등기일자": "-"
      }
    ],
    "count": 2,
    "success": 1
  },
  "api": {
    "success": true,
    "cost": 50,
    "ms": 390,
    "pl_id": 4135
  }
}

```

### 정적 응답 예시

```json

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

```

### curl

```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 (서버 ESM)

```javascript

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

```python

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

```php

<?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);

```

## 사용 예시 1. 구 단위 아파트 실거래 목록

특정 구의 한 해 아파트 거래 내역을 받아 단지별 시세를 계산할 때 씁니다.

```bash

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'

```

- `data.result`가 1이면 `data.data[]`에 거래가 담깁니다. 건수는 `data.count`입니다.

- `거래금액(만원)`은 쉼표를 지운 뒤 숫자로 바꾸고, `해제사유발생일`이 `-`가 아닌 거래는 시세 계산에서 뺍니다.

## 사용 예시 2. 토지 거래 조회

토지 거래를 볼 때 유형을 `G`로 보냅니다.

```bash

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=G' \
  --form-string 'year=2024'

```

- 유형에 따라 항목 이름이 달라질 수 있으니 고정된 키 목록을 가정하지 말고 있는 항목만 읽습니다.

- `data.result`가 0이면 `data.options`에서 정확한 시·군·구 이름을 골라 다시 요청합니다. 이 응답도 과금되므로 이름은 미리 맞춰 두세요.

## 사용 예시 3. 오피스텔 거래 조회

광역시의 오피스텔 거래를 볼 때 유형을 `D`로 보냅니다.

```bash

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=D' \
  --form-string 'year=2025'

```

- `계약년월`과 `계약일`을 합쳐 계약일자를 만들고 월별 거래량을 집계합니다.

- `data.error`가 "[년도] 입력 항목이 잘못됐습니다."이면 1950~올해 범위의 4자리 연도로 보냅니다(과금 없음).

## 코드·오류

### 업무 실패 응답

입력 오류·대상 없음·일시 실패는 data.error(사유)와 data.success=0으로 오며 api.cost는 0(과금 없음)입니다. HTTP 상태는 400·404·408·424 중 하나입니다. 입력 오류는 값을 고쳐 다시 요청하고, 408·424는 잠시 후 한 번 다시 시도하세요.

```json

{
  "data": {
    "error": "입력값을 확인해 주세요.",
    "success": 0
  },
  "api": {
    "success": true,
    "cost": 0,
    "ms": 5
  }
}

```

## 상세 기능·요금

이용 전 확인 시·도, 시·군·구, 부동산 유형, 연도를 지정하면 그 해에 실제 계약된 거래 목록을 한 번에 돌려줍니다. 시세 분석, 단지별 거래 이력 확인, 지역별 거래량 집계에 씁니다. 한 건당 50P가 차감됩니다. 실제 차감액은 응답의 api.cost에서 확인하세요. addr1·addr2가 목록에 없는 이름이면 data.result=0과 입력 가능한 이름 목록(data.options)을 돌려주며, 목록만 안내하고 실제 거래를 주지 못했으므로 과금되지 않습니다(api.cost 0). 지역 이름은 아래 표기를 그대로 쓰세요. 조건에 맞는 거래가 0건이면 data.result=1·data.count 0으로 오며, 조회가 정상으로 끝났으므로 요금이 차감됩니다. year·type이 잘못됐거나 조회에 실패하면 data.error로 응답하며 과금되지 않습니다. 처리에 최대 60초가 걸릴 수 있습니다. 요청 시간 제한을 60초 이상으로 잡으세요.

## 상세 요청

항목설정 메서드·주소POST https://apick.app/rest/land_rt_price 인증 헤더Authorization: Bearer — 내 계정의 API 인증키 본문 형식multipart/form-data 요청 예시 form-data 전체 예제 보기

## 상세 응답

필드타입설명 data.resultinteger1: 거래 목록 조회 성공, 0: 지역 이름이 목록에 없음(data.options 확인). data.countinteger조회된 거래 건수입니다. data.data[]array거래 목록입니다. 항목 이름은 한글이며 유형(type)에 따라 일부 항목이 다를 수 있으므로 있는 항목만 읽으세요. 값이 없으면 -입니다. data.data[].시군구string시·군·구와 법정동입니다. data.data[].번지string번지입니다. 본번·부번은 4자리로 맞춘 값입니다. data.data[].단지명string단지·건물 이름입니다. data.data[].전용면적(㎡)string전용면적(㎡)입니다. data.data[].계약년월string계약 연월 YYYYMM입니다. 계약일과 합쳐 계약일자를 만듭니다. 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소유권 이전 등기일(YY.MM.DD)입니다. 아직 등기 전이면 -입니다. data.msgstringresult=0일 때 어느 입력이 틀렸는지 알려 주는 문구입니다. data.optionsarrayresult=0일 때 입력 가능한 지역 이름 목록입니다. api.costinteger차감된 포인트입니다. 응답 예시 — 조회 성공 { "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", "시군구": "서울특별시 금천구 가산동", "번지": "222-22", "본번": "0222", "부번": "0022", "단지명": "OO5차", "전용면적(㎡)": "62.5300", "계약년월": "202501", "계약일": "01", "거래금액(만원)": "99,900", "동": "-", "층": "3", "매수자": "개인", "매도자": "개인", "건축년도": "2001", "도로명": "OO로OO길 OO", "해제사유발생일": "-", "거래유형": "중개거래", "중개사소재지": "서울 금천구", "등기일자": "-" } ], "count": 2, "success": 1 }, "api": { "success": true, "cost": 50, "ms": 390, "pl_id": 4135 } } 응답 예시 — 시·군·구 이름이 틀렸을 때(addr2=가산동) { "data": { "msg": "[addr2] 입력 항목이 잘못됐습니다.", "result": 0, "options": ["강남구", "강동구", "강북구", "강서구", "관악구", "광진구", "구로구", "금천구", "노원구", "도봉구", "동대문구", "동작구", "마포구", "서대문구", "서초구", "성동구", "성북구", "송파구", "양천구", "영등포구", "용산구", "은평구", "종로구", "중구", "중랑구"], "success": 0 }, "api": { "success": true, "cost": 0, "ms": 240, "pl_id": -1 } }

## 상세 코드·정책

오류 코드 응답의미대처 data.result=0, data.msg "[addr1] 입력 항목이 잘못됐습니다."시·도 이름이 목록에 없습니다.data.options의 이름 중 하나로 다시 요청합니다. 과금되지 않습니다. data.result=0, data.msg "[addr2] 입력 항목이 잘못됐습니다."시·군·구 이름이 그 시·도에 없습니다.data.options의 이름 중 하나로 다시 요청합니다. 과금되지 않습니다. data.error "[년도] 입력 항목이 잘못됐습니다. ex) 2024"year가 숫자가 아니거나 1950~올해 범위 밖입니다.4자리 연도로 고쳐 보냅니다. 과금되지 않습니다. data.error "[유형] 입력 항목이 잘못됐습니다. ex) A"type이 A~H가 아닙니다.대문자 한 글자로 보냅니다. 과금되지 않습니다. data.error "알 수 없는 이유로 실패했습니다."조회하지 못했습니다.잠시 후 다시 요청합니다. 과금되지 않습니다.
