본문 바로가기
개발가이드정보 조회토지 종합 분석

토지 종합 분석 API

명세 내보내기
OpenAPI 3.0.3Postman 컬렉션Markdown

필지의 지목·면적·용도지역·공시지가 이력·토지이동이력을 모아 공시지가 변동률·연평균 변동률·추세·규제 저촉을 분석합니다.

POSThttps://apick.app/rest/land_info
인증
Bearer 키
요청 형식
form-data
응답
JSON
경로
1개

왜 토지 종합 분석인가

땅 한 필지, 계약 전에 한 번에 확인합니다

토지를 사고팔거나 담보로 잡을 때 서류만 보고 판단하면 용도지역과 규제, 주변 시세를 놓치기 쉽습니다. 주소 하나로 토지 정보와 규제, 시세를 함께 정리해 검토 시간을 줄입니다.

도입 효과

  • 계약 검토 항목을 한 화면에
  • 서류 발급과 대조 반복을 줄임
  • 현장 방문 전 위험 요소 확인

이런 곳에서 많이 씁니다

  • 토지 매입 전 기초 검토
  • 담보 대출 서류 준비
  • 부동산 중개 자료 작성
가입하고 API 키 받기API 키 하나로 바로 호출 · 실패한 요청은 과금되지 않습니다

알아둘 점

이용 전 확인

성공한 조회 한 건당 50P가 차감됩니다. 입력 오류, 주소를 필지로 확정하지 못한 경우, 모든 항목을 가져오지 못한 경우는 data.error로 응답하며 과금되지 않습니다.

필지 기본정보·토지특성·개별공시지가(연도별)·토지이용계획·토지이동이력을 한 번에 돌려줍니다. 소유자·소유권 변동이력은 제공하지 않습니다.

필지 기본정보와 개별공시지가 중 하나라도 받지 못하면 받은 항목만 돌려주고 success 0으로 응답하며 과금하지 않습니다. 이때 받지 못한 항목 이름이 partial.missing에 옵니다. 토지특성·토지이용계획·토지이동이력만 비면 null 또는 빈 배열로 오고 나머지는 정상 응답(과금)입니다.

응답 시간은 보통 8초 이내이고 최대 25초입니다. 요청 시간 제한을 30초 이상으로 잡으세요.

인증키는 서버 환경변수에 보관하고 공개 저장소·웹페이지에 넣지 마세요.

요청과 응답

API 요청
POST/rest/land_info
  • Bearer 인증
  • multipart/form-data
  • JSON 응답
요청 파라미터 5개
파라미터
설명
pnustring조건부
필지고유번호 (19자리) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
형식
^[0-9]{19}$
addressstring조건부
지번 또는 도로명 주소 (pnu 가 없을 때 사용) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
예시
서울특별시 강남구 역삼동 12
addrTypestring선택
주소 유형 (기본 auto) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. 가능한 값은 3가지입니다. parcel = 지번 주소를 기준으로 조회하는 값입니다. road = 도로명 주소를 기준으로 조회하는 값입니다. auto = 서버·모델이 상황에 맞춰 자동으로 정하는 값입니다. 별도 지정이 필요 없습니다.
허용값
parcel road auto
예시
parcel
yearstring선택
토지특성·공시지가 기준연도 (기본 전년도) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
형식
^[0-9]{4}$
예시
2024
priceYearsinteger선택
공시지가 이력 연수 (1~5, 기본 3) 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다.
예시
5
응답 필드 45개
응답 필드
설명
dataobject
요청 처리 결과 묶음입니다. 조회한 값·작업 상태·오류 설명이 이 안에 들어 있으며, 실제 하위 필드 구성은 서비스마다 다릅니다. 값이 없으면 null·빈 배열·필드 생략 중 해당 서비스의 규칙을 따릅니다.
data.PNUstring
확정된 필지고유번호 19자리입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.소재지string
주소로 조회했을 때 확정된 주소입니다. pnu로 조회하면 빈 문자열입니다.
data.지번string
주소로 조회했을 때의 지번 표기입니다. pnu로 조회하면 빈 문자열입니다.
data.법정동코드string
법정동코드 10자리입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.지역코드string
시군구 단위 지역코드 5자리입니다. 실거래가 조회 등에 그대로 씁니다. pnu로 조회하면 빈 문자열일 수 있습니다.
data.좌표object
경위도 좌표(x 경도, y 위도)입니다. pnu로 조회하면 null입니다. null 허용.
data.기준연도string
실제로 적용된 기준연도입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.필지object
필지 기본정보입니다. 가져오지 못하면 null입니다. 하위 필드에 코드·이름·상태 같은 세부 값이 들어 있으며, 자료가 없으면 빈 객체이거나 생략됩니다. null 허용.
data.토지특성object
기준연도의 토지특성입니다. 가져오지 못하거나 그해 자료가 없으면 null입니다. null 허용.
data.공시지가array
연도별 개별공시지가입니다. 최근 연도부터 정렬하며, 자료가 없는 연도는 빠집니다.
data.토지이용계획array
필지에 걸린 용도지역·지구·구역 목록입니다. 없으면 빈 배열입니다. 각 항목의 구성은 서비스에 따라 다르며, 값이 없으면 빈 배열입니다. 항목 수와 순서를 함께 확인하세요.
data.토지이동이력array
분할·합병·지목변경 같은 토지 이동 이력입니다. 없으면 빈 배열입니다. 각 항목의 구성은 서비스에 따라 다르며, 값이 없으면 빈 배열입니다. 항목 수와 순서를 함께 확인하세요.
apiobject
API 호출 메타데이터입니다. 이번 요청의 서버 처리 성공 여부(api.success), 실제 차감 포인트(api.cost), 결제 기록 ID(api.pl_id)를 담습니다. 처리 시간(api.ms)은 응답에 포함된 경우에만 제공됩니다. 업무 결과는 data에서 확인합니다.
api.costinteger
이번 호출에서 실제로 차감된 포인트입니다. 유료 성공 응답에서만 단가만큼 차감되며, 실패·무료 조회·같은 요청의 멱등 재전송은 0입니다. 화면의 표시 단가와 실제 차감액이 다를 수 있으므로 정산은 이 값을 기준으로 합니다.
api.successboolean
API 서버가 이번 요청을 정상 처리했는지 여부입니다. true여도 업무 결과가 실패일 수 있으므로 data.success·data.status와 함께 판단합니다. 인증 실패·잘못된 입력·서버 오류 응답에서는 false입니다.
api.msinteger
서버가 요청을 받아 응답 본문을 만들기까지 걸린 처리 시간(밀리초)입니다. 네트워크 왕복 시간과 클라이언트 대기 시간은 포함되지 않습니다.
하위 필드 28개 더 보기
응답 필드
설명
data.좌표.xnumber
'x' 수치 값입니다. 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요.
data.좌표.ynumber
'y' 수치 값입니다. 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요.
data.필지.PNUstring
'PNU' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다.
data.필지.법정동코드string
'법정동코드' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다.
data.필지.법정동string
주소를 구성하는 행정구역·지번 정보입니다. 같은 거래라도 표기 기준에 따라 값이 달라질 수 있으므로 도로명 주소와 함께 확인하세요.
data.필지.지번string
본번-부번 표기입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.필지.지목string
지목 이름입니다. 예: 대, 전, 임야 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.필지.면적number
토지 면적(㎡)입니다. 값이 없으면 null입니다. 숫자로 오며, 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요. null 허용.
data.필지.필지구분string
대장 구분 표기입니다. 예: 토지대장, 임야대장 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.토지특성.지목string
'지목' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다.
data.토지특성.면적number
'면적' 수치 값입니다. 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요.
data.토지특성.용도지역_1string
첫 번째 용도지역입니다. 예: 제2종일반주거지역 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.토지특성.용도지역_2string
두 번째 용도지역입니다. 없으면 빈 문자열입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.토지특성.토지이용상황string
실제 이용 상황입니다. 예: 상업용, 단독 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.토지특성.지형고저string
지형의 높낮이입니다. 예: 평지 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.토지특성.지형형상string
필지 모양입니다. 예: 가로장방 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.토지특성.도로접면string
도로에 닿은 형태입니다. 예: 광대로한면 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.토지특성.기준일자string
'기준일자' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다.
data.공시지가[].기준연도string
공시 기준연도입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.공시지가[].기준일자string
'기준일자' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다.
data.공시지가[].단위면적당가격integer
㎡당 개별공시지가(원)입니다. 토지 전체 가격은 필지.면적을 곱해 구합니다.
data.토지이용계획[].용도지역지구구역string
지역·지구·구역 이름입니다. 예: 도시지역, 가축사육제한구역 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.토지이용계획[].저촉여부string
필지가 그 구역에 포함·저촉되는지 표기입니다. 예: 포함, 저촉, 접합 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.토지이용계획[].근거법령string
'근거법령' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다.
data.토지이용계획[].기준일자string
'기준일자' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다.
data.토지이동이력[].이동일자string
이동이 일어난 날짜입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.토지이동이력[].이동사유string
이동 사유입니다. 예: 분할, 지목변경 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.토지이동이력[].기준일자string
'기준일자' 문자열 값입니다. 값이 없으면 빈 문자열이거나 필드가 생략됩니다.
입력 조건·전송 규칙
항목
설정
메서드·주소
POST https://apick.app/rest/land_info
인증 헤더
Authorization: Bearer — 내 계정의 API 인증키
본문 형식
multipart/form-data
위치 지정
pnu 또는 address 중 하나는 필요합니다. 둘 다 보내면 pnu를 씁니다.
요청 예시

지번 주소로 최근 5년 공시지가까지 받는 예입니다. 성공 시 과금되는 실제 요청입니다.

사용 예시

상황별로 보내는 값과 응답에서 확인할 값을 모았습니다. 언어 탭에서 그대로 복사해 쓸 수 있습니다.

예시 1. 주소로 필지 종합정보 조회

토지 매물 화면에 지목·면적·용도지역·공시지가를 한 번에 보여 줄 때 씁니다.

요청POST/rest/land_info
curl --fail-with-body --request POST 'https://apick.app/rest/land_info' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form-string 'year=2024' \
  --form-string 'priceYears=5' \
  --form-string 'address=서울특별시 강남구 역삼동 12' \
  --form-string 'addrType=parcel'
  • data.PNU를 저장해 두면 다음부터 주소 없이 pnu로 더 빠르게 조회할 수 있습니다.
  • 토지 전체 공시가격은 data.공시지가[0].단위면적당가격 × data.필지.면적으로 계산합니다.
예시 2. 공시지가 5년 추이

지가 변동을 그래프로 보여 줄 때 priceYears=5로 최근 5년 공시지가를 받습니다.

요청POST/rest/land_info
curl --fail-with-body --request POST 'https://apick.app/rest/land_info' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form-string 'addrType=parcel' \
  --form-string 'pnu=1168010100100120000' \
  --form-string 'year=2024' \
  --form-string 'priceYears=5'
  • data.공시지가[]는 최근 연도부터 정렬됩니다. 자료가 없는 연도는 빠지므로 개수가 5보다 적을 수 있습니다.
  • data.토지특성이 null이면 그 기준연도 자료가 없는 것입니다. year를 한 해 낮춰 다시 조회합니다.

응답 처리

HTTP 성공과 업무 결과를 구분하세요. 경로별 응답 필드와 예시는 위 요청과 응답에 함께 있습니다.

각 객체의 기준일자는 그 항목이 마지막으로 갱신된 날짜입니다. 값은 받은 표기 그대로이므로 형식이 항목마다 다를 수 있습니다.

{
  "data": {
    "PNU": "1168010100100120000",
    "소재지": "서울특별시 강남구 역삼동 12",
    "지번": "12",
    "법정동코드": "1168010100",
    "지역코드": "11680",
    "좌표": { "x": 127.0360, "y": 37.5000 },
    "기준연도": "2024",
    "필지": { "PNU": "1168010100100120000", "법정동코드": "1168010100", "법정동": "서울특별시 강남구 역삼동", "지번": "12", "지목": "대", "면적": 330.5, "필지구분": "토지대장" },
    "토지특성": { "지목": "대", "면적": 330.5, "용도지역_1": "일반상업지역", "용도지역_2": "", "토지이용상황": "상업용", "지형고저": "평지", "지형형상": "가로장방", "도로접면": "광대로한면", "기준일자": "2024-07-31" },
    "공시지가": [
      { "기준연도": "2024", "기준일자": "2024-05-31", "단위면적당가격": 52000000 },
      { "기준연도": "2023", "기준일자": "2023-05-31", "단위면적당가격": 50100000 }
    ],
    "토지이용계획": [
      { "용도지역지구구역": "일반상업지역", "저촉여부": "포함", "근거법령": "일반상업지역", "기준일자": "2024-08-01" }
    ],
    "토지이동이력": [
      { "이동일자": "1988-04-12", "이동사유": "분할", "기준일자": "2024-08-01" }
    ]
  },
  "api": { "cost": 50, "success": true, "ms": 5200 }
}
원문 응답 필드 표 보기
필드
타입
설명
data.PNU
string
확정된 필지고유번호 19자리입니다.
data.소재지
string
주소로 조회했을 때 확정된 주소입니다. pnu로 조회하면 빈 문자열입니다.
data.지번
string
주소로 조회했을 때의 지번 표기입니다. pnu로 조회하면 빈 문자열입니다.
data.법정동코드
string
법정동코드 10자리입니다.
data.지역코드
string
시군구 단위 지역코드 5자리입니다. 실거래가 조회 등에 그대로 씁니다. pnu로 조회하면 빈 문자열일 수 있습니다.
data.좌표
object
경위도 좌표(x 경도, y 위도)입니다. pnu로 조회하면 null입니다.
data.기준연도
string
실제로 적용된 기준연도입니다.
data.필지
object
필지 기본정보입니다. 가져오지 못하면 null입니다.
data.필지.지목
string
지목 이름입니다. 예: 대, 전, 임야
data.필지.면적
number
토지 면적(㎡)입니다. 값이 없으면 null입니다.
data.필지.필지구분
string
대장 구분 표기입니다. 예: 토지대장, 임야대장
data.필지.법정동
string
법정동 이름입니다.
data.필지.지번
string
본번-부번 표기입니다.
data.토지특성
object
기준연도의 토지특성입니다. 가져오지 못하거나 그해 자료가 없으면 null입니다.
data.토지특성.용도지역_1
string
첫 번째 용도지역입니다. 예: 제2종일반주거지역
data.토지특성.용도지역_2
string
두 번째 용도지역입니다. 없으면 빈 문자열입니다.
data.토지특성.토지이용상황
string
실제 이용 상황입니다. 예: 상업용, 단독
data.토지특성.지형고저
string
지형의 높낮이입니다. 예: 평지
data.토지특성.지형형상
string
필지 모양입니다. 예: 가로장방
data.토지특성.도로접면
string
도로에 닿은 형태입니다. 예: 광대로한면
data.공시지가[]
array
연도별 개별공시지가입니다. 최근 연도부터 정렬하며, 자료가 없는 연도는 빠집니다.
data.공시지가[].기준연도
string
공시 기준연도입니다.
data.공시지가[].단위면적당가격
number
㎡당 개별공시지가(원)입니다. 토지 전체 가격은 필지.면적을 곱해 구합니다.
data.토지이용계획[]
array
필지에 걸린 용도지역·지구·구역 목록입니다. 없으면 빈 배열입니다.
data.토지이용계획[].용도지역지구구역
string
지역·지구·구역 이름입니다. 예: 도시지역, 가축사육제한구역
data.토지이용계획[].저촉여부
string
필지가 그 구역에 포함·저촉되는지 표기입니다. 예: 포함, 저촉, 접합
data.토지이동이력[]
array
분할·합병·지목변경 같은 토지 이동 이력입니다. 없으면 빈 배열입니다.
data.토지이동이력[].이동일자
string
이동이 일어난 날짜입니다.
data.토지이동이력[].이동사유
string
이동 사유입니다. 예: 분할, 지목변경
success
integer
정상 분석 결과는 1, 필지·공시지가를 받지 못한 부분 결과는 0입니다. 0이면 과금되지 않습니다.
partial.missing
array
부분 결과일 때 받지 못한 항목 이름 목록입니다. 정상 응답에는 없습니다.
api.cost
integer
차감된 포인트입니다. 실패하면 0입니다.
api.ms
integer
처리 시간(밀리초)입니다.

오류 코드

응답을 아래 순서로 확인하세요. 결과 유무와 과금 여부는 서로 다릅니다.

  1. HTTP 상태전송·인증·입력 오류
  2. api.successAPI 처리 여부
  3. data · result업무 결과와 오류 문구
  4. api.cost이번 요청의 과금
업무 실패 응답 data.error
  • 입력값이 맞지 않거나 대상 자료가 없거나 일시적으로 처리하지 못하면 data.error(사유 문구)와 data.success=0을 돌려줍니다. HTTP 상태는 사유에 따라 400·404·408·424 중 하나입니다.
  • 이때 api.cost는 0이며 과금되지 않습니다. data.error 문구를 그대로 기록하고 사용자에게 보여 주세요.
  • 입력 오류(400)는 값을 고친 뒤 다시 요청하세요. 408·424는 잠시 후 한 번 다시 시도하고, 같은 입력으로 짧은 간격의 자동 반복은 하지 마세요.
{
  "data": {
    "error": "입력값을 확인해 주세요.",
    "success": 0
  },
  "api": {
    "success": true,
    "cost": 0,
    "ms": 5
  }
}
서비스 코드·조건

오류와 복구

아래 경우는 data.error로 응답하며 과금되지 않습니다(api.cost 0). 실패 응답은 HTTP 4xx 상태 코드와 함께 올 수 있으니 상태 코드만으로 판단하지 말고 본문의 data.error를 읽으세요.

data.error
원인
해결
[pnu 또는 address] 입력 항목이 잘못됐습니다.
pnu와 address가 모두 없습니다.
둘 중 하나를 보냅니다.
[pnu] 19자리 필지고유번호가 필요합니다.
pnu의 숫자가 19자리가 아닙니다.
19자리를 확인하거나 address로 조회합니다.
[address] 입력 항목이 잘못됐습니다.
주소가 200자를 넘습니다.
시·도부터 번지까지만 보냅니다.
[year] 기준연도가 잘못됐습니다. ex) 2024
4자리가 아니거나 1990년~올해 범위를 벗어났습니다.
올해 이하 4자리 연도로 보내거나 생략합니다.
[priceYears] 1~5 사이 값이 필요합니다.
이력 연수가 범위를 벗어났습니다.
1~5 사이 정수로 보냅니다.
주소 유형이 잘못됐습니다.
addrType이 허용값에 없습니다.
parcel·road 중 하나로 보내거나 생략합니다.
주소 또는 PNU(19자리)가 필요합니다.
address가 공백뿐입니다.
주소를 채우거나 pnu로 보냅니다.
해당 주소의 필지를 찾지 못했습니다.
주소에 해당하는 필지가 없습니다.
번지까지 적었는지, 지번·도로명 유형이 맞는지(addrType) 확인합니다.
주소·필지 정보를 가져오지 못했습니다.
주소를 필지로 바꾸는 단계가 일시적으로 실패했습니다.
잠시 후 다시 요청하거나 pnu로 조회합니다.
필지 정보를 가져오지 못했습니다.
모든 항목을 가져오지 못했습니다.
잠시 후 같은 요청을 다시 보냅니다.
인증·포인트 오류 result.error 문구
코드
HTTP
의미·조치
유효하지 않은 API키 입니다.
401
Authorization: Bearer 헤더의 인증키를 확인하세요.
허용되지 않은 IP주소 입니다.
401
마이페이지의 허용 IP 설정과 요청 서버 IP를 확인하세요.
비활성화된 계정입니다.
401
계정 이용 상태를 고객지원으로 문의하세요.
사용 가능한 포인트이 부족합니다.
200
HTTP 200이어도 result.error가 있으면 실패입니다. 포인트를 충전한 뒤 다시 요청하세요. 이 응답은 과금되지 않습니다.
무료 포인트로 사용할 수 없는 서비스입니다.
200
최소 1회 결제 후 이용할 수 있습니다. result.error 전체 문구를 그대로 표시하세요.
인증 정보를 확인할 수 없습니다.
424
일시적인 확인 실패입니다. 잠시 후 다시 시도하세요.
폼 입력 오류 error.code
코드
HTTP
의미·조치
FORM_DATA_INVALID
400
필드 이름·값의 타입·배열 인덱스를 확인하세요. 인덱스는 0부터 연속으로 사용합니다.
FORM_DATA_FIELD_CONFLICT
400
같은 값과 중첩 경로를 동시에 지정하지 마세요.
MULTIPART_LIMIT_OR_PARSE_ERROR
400·413
boundary·파일 크기·필드 개수를 확인하세요. 서비스별 제한이 우선 적용됩니다.

요금·이용 조건

기본 요금기본 단가 50P · 건당무료 포인트로는 이용할 수 없으며 최소 1회 결제 후 이용할 수 있습니다.

실제 차감 금액은 응답의 api.cost로 확인하세요. 상세 요금은 요금정책에서 볼 수 있습니다.

연동 팁

  • 요청 예제의 오류 처리 포함 모드는 시간 제한과 업무 실패 판정을 함께 보여줍니다.
  • 인증키는 서버 환경변수에 두고 브라우저·앱에 넣지 마세요.
  • HTTP 성공과 업무 결과를 구분하고, 실패 응답의 오류 문구를 그대로 기록하세요.
추가 예제·서비스별 연동 안내

호출 예시

같은 요청을 JavaScript와 Python으로 옮긴 예시입니다. 키는 환경변수 APICK_API_KEY 에서 읽습니다.

JavaScript 예시
Python 예시

개발가이드 검색

API 이름·경로·파라미터·오류 코드로 찾을 수 있습니다.

표시 가격은 기본 단가입니다. 상세 과금 조건은 각 가이드에서 확인하세요.