배송 추적 API,
한 번의 연동으로 끝.
택배사마다 다른 스크래핑 로직을 직접 만들 필요 없습니다. TheTrack API 하나로 모든 택배사의 배송 상태를 조회하세요.
curl -X GET "https://api.thetrack.kr/api/v1/track\
?carrier=cjlogistics\
&tracking_number=1234567890" \
-H "X-API-Key: your_api_key"
# Response
{
"carrier": { "id": "cjlogistics", "name": "CJ대한통운" },
"trackingNumber": "1234567890",
"lastEvent": {
"status": "DELIVERED",
"statusText": "배달완료",
"time": "2026-03-25 14:30:00",
"location": "서울 강남구"
},
"events": [...],
"templateUrl": "https://www.thetrack.kr/tracking/cjlogistics/1234567890"
}개발자를 위한 배송 추적
복잡한 택배사 연동을 TheTrack이 대신합니다.
택배사 통합
CJ대한통운, 한진, 롯데, 우체국부터 DHL, FedEx까지. 국내외 주요 택배사를 단일 API로 조회합니다.
실시간 상태 추적
집하부터 배달 완료까지 모든 이벤트를 실시간으로 반환합니다. 표준화된 상태 코드로 일관된 처리가 가능합니다.
5분 만에 연동
RESTful API 한 줄이면 충분합니다. cURL, Python, Node.js 등 어떤 환경에서든 바로 사용할 수 있습니다.
안정적 인프라
TLS fingerprint 기반 크롤링으로 높은 성공률을 유지합니다. 택배사별 헬스체크를 상시 운영합니다.
지원 택배사
API 하나로 아래 모든 택배사의 배송을 조회할 수 있습니다.
3단계로 시작
회원가입
이메일로 가입하면 즉시 API 키가 발급됩니다. 무료 플랜으로 바로 시작하세요.
API 연동
발급받은 API 키를 헤더에 넣고 요청하면 됩니다. SDK 없이 HTTP 요청만으로 충분합니다.
배송 조회
택배사 ID와 운송장번호만 전달하면 표준화된 JSON 응답을 받습니다.
합리적인 요금제
월간 고유 운송장 건수 기준으로 과금합니다. 동일 운송장은 여러 번 조회해도 1건입니다.
Free
무료
100건/월
Plan 5K
59,000원
5,000건/월
Unlimited
별도 협의
무제한
배송조회 페이지를 즉시 제공하세요
별도 개발 없이 URL 하나로 고객에게 배송조회 화면을 제공합니다.
CJ대한통운
1234567890
서울 강남구
강남 배달센터
강남 집중국
대전 허브
CJ대한통운
1234567890
● 배달완료 04.01 14:30
배달완료
서울 강남구
배달출발
강남 배달센터
도착
강남 집중국
발송
대전 허브
집하
부산 해운대
CJ대한통운
1234567890
서울 강남구
강남 배달센터
강남 집중국
대전 허브
주요 특징
API 응답의 templateUrl로 바로 사용
track API 응답에 포함된 templateUrl을 그대로 사용합니다.
iframe 임베드 지원
쇼핑몰, 앱 등 어디서나 iframe 한 줄로 즉시 삽입합니다.
3가지 테마 — modern / minimal / dark
URL 파라미터 ?theme= 으로 원하는 스타일을 선택합니다.
모바일 반응형
스마트폰, 태블릿, PC 모든 화면에서 최적화된 레이아웃을 제공합니다.
별도 개발 불필요
디자인, 구현 모두 완료되어 있어 즉시 고객에게 제공할 수 있습니다.
// Step 1. API로 배송 조회
const res = await fetch(
'https://api.thetrack.kr/api/v1/track' +
'?carrier=cjlogistics' +
'&tracking_number=1234567890',
{ headers: { 'X-API-Key': 'your_key' } }
);
const data = await res.json();
// data.templateUrl
// → "https://www.thetrack.kr/tracking/
// cjlogistics/1234567890"
// Step 2. 고객에게 보여주기
// 방법 1: iframe 임베드
<iframe
src={`${data.templateUrl}?theme=modern`}
width="100%" height="600"
frameborder="0" />
// 방법 2: 새 창으로 열기
<a href={data.templateUrl}
target="_blank">배송조회</a>
// 방법 3: 카카오톡/SMS 알림 링크
`고객님의 택배가 발송되었습니다.
배송조회: ${data.templateUrl}`?theme= 파라미터 값