whereparcel

궁금한 게 있으세요? 편하게 물어보세요. WhereParcel을 만든 개발자가 직접 읽고 답장드립니다.

택배조회 API · 39개+ 운영 중 택배사 · 통합 JSON 응답

택배조회 인프라, 3개월 무료로 구축하세요

†

서비스 초기에 택배조회 인프라에 비용을 쏟지 마세요. USPS · UPS · FedEx · DHL 등 글로벌 39개+ 택배사를 월 1만건 × 3개월 무료로 — WhereParcel을 소개하는 짧은 글 하나면 됩니다.

  • USPS · UPS · FedEx · DHL · 글로벌 39개+ 택배사
  • 언어/플랫폼/분량 자유

†앰배서더 프로그램 신청 자격: 결제를 최소 1개월 하셨고, 신청 시점에 구독이 유지 중이며 해지 예약도 걸려 있지 않은 고객. 무료 트라이얼은 제공하지 않으며, 플랜 결제와 함께 시작합니다.

bash
curl -X POST https://api.whereparcel.com/v2/track \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY:YOUR_SECRET_KEY" \
  -d '{"trackingItems":[{"carrier":"us.usps","trackingNumber":"9400111899562537866361"}]}'

또는 지금 바로 택배 조회를 —

POST/v2/track200 OK
{
  "success": true,
  "data": [{
    "carrier": "us.usps",
    "trackingNumber": "9400111899562537866361",
    "status": "success",
    "data": {
      "deliveryStatus": "in_transit",
      "estimatedDelivery": "2026-10-02T00:00:00.000Z",
      "events": [ {…}, {…}, {…}, {…}, {
        "timestamp": "2026-09-29T10:12:00.000Z",
        "status": "in_transit",
        "location": "ATLANTA GA NETWORK DISTRIBUTION CENTER",
        "rawStatus": "Arrived at USPS Regional Facility",
        "rawDescription": "Arrived at USPS Regional Facility"
      }]
    },
    "billable": true,
    "cached": false
  }],
  "results": […],
  "summary": {
    "total": 1, "success": 1, "failed": 0,
    "usageIncremented": 1
  },
  "requestLimit": {…}, "trackingQuota": {…}
}

왜 더 비싼 돈을 내시나요?

UPS, USPS, FedEx, DHL 등 주요 택배사는 이미 안정적으로 조회 가능합니다. 아직 없는 택배사가 있다면, 요청만 해주세요.

AfterShip, Ship24에 더 비싼 돈을 낼 이유가 없습니다.

연동 요청만 넣어주시면 빠르게 추가해드립니다. 언제든 취소 가능.

요청 후 보통 며칠 안에 연동 완료

미국 5 us.usps us.fedex us.ups us.ontrac us.ca.ontrac
캐나다 5 ca.post ca.canpar ca.intelcom ca.loomis ca.ics
영국 1 gb.fedex
독일 4 de.hermes de.gls de.post de.fedex
이탈리아 3 it.tnt it.brt it.poste
스페인 2 es.fedex es.cttExpress
일본 2 jp.yamato jp.post
한국 7 kr.post kr.cj kr.lotte kr.hanjin kr.logen kr.kdexp kr.daesin
터키 2 tr.yurtici tr.ptt
국제 8 intl.dhl intl.cainiao intl.yunexpress intl.deutsche-post intl.tnt intl.chronopost intl.yanwen intl.canada-post
요청 시 추가 0 택배사 요청하기 →
39 개 택배사 · 9개국 + 국제

개발자들이 WhereParcel 택배API를 선택하는 이유

배송 상태 웹훅 자동 알림

송장을 한 번 등록하면 배송 완료까지 약 12시간마다 다시 조회해 엔드포인트로 상태를 보냅니다. 직접 폴링할 필요가 없습니다.

POST https://yourapp.com/webhooks/tracking
X-WhereParcel-Event: tracking.updated
X-WhereParcel-Timestamp: 2026-09-29T10:20:41.000Z
X-WhereParcel-Signature: 9f2c41…e07b

엔터프라이즈급 보안

API 키 인증, HMAC 서명, 요청 제한, TLS 암호화. 안전하게 택배 데이터를 관리하세요.

Authorization: Bearer KEY:SECRET

개발자 친화적 문서

OpenAPI 3.0 스펙, 5개 언어 코드 예제, 인터랙티브 플레이그라운드. 1시간 안에 연동 완료.

POST /v2/track     GET /v2/carriers
POST /v2/detect    GET /v2/countries

고정 월 요금

USPS, UPS, FedEx, DHL 등을 월 요청 한도 하나로 — 건당 요금 · 숨은 비용 · 장기 약정 없음. 언제든 취소 가능.

어떤 언어든 몇 분이면 연동 완료

몇 줄의 코드만으로 택배 조회를 시작하세요. 언어를 선택하고 예제를 복사하세요.

전체 문서 보기 →

API를 직접 체험해보세요

운송장 번호를 입력하면 API 요청 코드가 실시간으로 생성됩니다.

// npm install whereparcel
import { WhereParcel } from 'whereparcel';

const wp = new WhereParcel('YOUR_API_KEY', 'YOUR_SECRET_KEY');

const res = await wp.track([
  { carrier: 'us.usps', trackingNumber: '9400111899562537866361' },
]);

const item = res.data[0];
if (item.status === 'success') {
  console.log(item.data.deliveryStatus);
  console.log(item.data.events);
}
curl -X POST https://api.whereparcel.com/v2/track \
  -H "Authorization: Bearer YOUR_API_KEY:YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"trackingItems":[{"carrier":"us.usps","trackingNumber":"9400111899562537866361"}]}'
const res = await fetch('https://api.whereparcel.com/v2/track', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY:YOUR_SECRET_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    trackingItems: [{ carrier: 'us.usps', trackingNumber: '9400111899562537866361' }],
  }),
});
const { data } = await res.json();
console.log(data[0].data.deliveryStatus);
import requests

res = requests.post(
    "https://api.whereparcel.com/v2/track",
    headers={"Authorization": "Bearer YOUR_API_KEY:YOUR_SECRET_KEY"},
    json={"trackingItems": [{"carrier": "us.usps", "trackingNumber": "9400111899562537866361"}]},
)
print(res.json()["data"][0]["data"]["deliveryStatus"])
$ch = curl_init('https://api.whereparcel.com/v2/track');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer YOUR_API_KEY:YOUR_SECRET_KEY',
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS => json_encode(['trackingItems' => [
    ['carrier' => 'us.usps', 'trackingNumber' => '9400111899562537866361'],
  ]]),
]);
$res = json_decode(curl_exec($ch), true);
echo $res['data'][0]['data']['deliveryStatus'];
body := strings.NewReader(`{"trackingItems":[{"carrier":"us.usps","trackingNumber":"9400111899562537866361"}]}`)
req, _ := http.NewRequest("POST", "https://api.whereparcel.com/v2/track", body)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY:YOUR_SECRET_KEY")
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)

3단계로 간단하게 시작하세요

가입부터 실시간 배송 추적까지 5분이면 충분합니다.

시작하기
  1. 시작하기

    플랜을 선택하고 시작하세요. 언제든 취소할 수 있습니다. 대시보드에서 API 키를 즉시 발급받으세요.

  2. 첫 번째 API 호출

    코드 예제를 활용하여 택배 조회 요청을 보내세요. 하나의 JSON 응답으로 실시간 배송 상태를 확인할 수 있습니다.

  3. 웹훅으로 자동 알림 설정

    웹훅 엔드포인트를 설정하면 배송 상태를 자동으로 받습니다. 폴링 불필요 — 약 12시간마다 다시 조회해 보내 드립니다.

왜 직접 연동 대신 WhereParcel인가요?

택배사별 개별 연동에 몇 달을 낭비하지 마세요. 통합 API로 더 빠르게 출시하세요.

직접 구축하면WhereParcel을 쓰면
택배사마다 별도 API 연동 필요하나의 저렴한 API로 모든 택배사 통합
수많은 서로 다른 데이터 형식 관리정규화된 일관적인 JSON 응답
배송 상태 정규화 직접 구현통일된 배송 상태 코드
요청 제한 및 IP 차단 대응택배사 차단은 저희가 대응
수개월의 개발 기간 소요5분 안에 연동 완료
지속적인 유지보수 부담택배사 변경 사항 자동 반영

간단하고 투명한 가격

필요에 맞는 플랜을 선택하세요. 숨겨진 비용 없이, 언제든 취소 가능.

체크하셔도 의무는 없어요 — 나중에 글을 안 쓰셔도 불이익 없습니다. WhereParcel 에 대한 짧은 글을 발행해 주시면 내용에 따라 3개월 이상 플랜을 무료로 드립니다.

스타터사이드 프로젝트와 소규모 앱에 적합 $49 월 10K건 요청 이메일 지원 시작하기 구독하고 이벤트 참여
프로최고 혜택성장하는 비즈니스를 위한 플랜 $99 월 30K건 요청 우선 지원 시작하기 구독하고 이벤트 참여
그로스확장 중인 팀을 위한 플랜 $250 월 100K건 요청 우선 지원 시작하기 구독하고 이벤트 참여
스케일대용량 운영을 위한 플랜 $450 월 200K건 요청 전담 지원 시작하기 구독하고 이벤트 참여
비즈니스엔터프라이즈 전용 — 전담 지원 + 99.95% SLA $650 월 300K건 요청 전담 지원 99.95% 가동 시간 SLA 시작하기 구독하고 이벤트 참여

웹훅 알림 · 언제든 취소 가능

언제든 취소 가능대시보드에서 언제든 취소할 수 있습니다. 취소해도 현재 결제 기간이 끝날 때까지 이용할 수 있습니다. 장기 계약 없음.대시보드에서 언제든 취소할 수 있으며, 취소해도 결제 기간이 끝날 때까지 이용할 수 있습니다. 그리고 WhereParcel 에 대한 글을 발행해 주시면 내용에 따라 3개월 이상 플랜을 무료로 드립니다.

택배조회API란 무엇인가요?
택배조회API는 CJ대한통운, 한진택배, 롯데택배 등 여러 택배사의 실시간 배송 상태를 하나의 API로 조회할 수 있는 서비스입니다. 각 택배사별로 따로 연동할 필요 없이 WhereParcel API 하나로 모든 택배를 추적할 수 있습니다.
WhereParcel은 몇 개의 택배사를 지원하나요?
WhereParcel은 현재 39개 이상의 운영 중인 택배사를 지원합니다. 한국(CJ대한통운, 한진, 롯데, 로젠, 우체국 등), 미국(USPS, UPS, FedEx, OnTrac), 일본(야마토, 일본우편), 국제택배(DHL, FedEx International) 등을 포함합니다. 원하는 택배사가 없으면 커뮤니티에 요청해주세요 — 빠르게 추가해드립니다.
무료로 써볼 수 있나요?
무료 트라이얼은 제공하지 않으며, 플랜 결제와 함께 시작합니다. 언제든 취소할 수 있고, 취소해도 결제 기간이 끝날 때까지 이용할 수 있습니다. 구독을 시작하신 뒤 WhereParcel을 소개하는 글을 써주시면 앰배서더 프로그램으로 3개월을 무료로 더 드립니다. 요금제 보기
연동은 어떻게 하나요?
가입 후 플랜을 선택하고 API 키를 발급받아 5분 안에 첫 번째 택배 조회를 할 수 있습니다. cURL, Node.js, Python, PHP, Go 코드 예제를 제공합니다. 빠른 시작 가이드 | API 플레이그라운드
어떤 나라와 택배사를 지원하나요?
WhereParcel은 한국, 미국, 일본, 독일, 영국, 캐나다, 이탈리아, 스페인, 터키 등 9개국 + 국제의 택배사를 지원합니다. DHL, FedEx, UPS, TNT 등 국제택배도 지원하여 해외직구 및 역직구 배송 추적이 가능합니다.
웹훅(Webhook) 추적은 어떻게 작동하나요?
웹훅을 사용하면 WhereParcel이 구독한 택배를 배송 완료까지 약 12시간마다 다시 조회하고, 조회할 때마다 최신 상태를 서버로 보냅니다. API를 반복해서 호출할 필요 없이 웹훅 URL을 한 번 등록하면 되므로 API 호출 수를 줄일 수 있습니다. 웹훅 모범 사례 가이드
API 평균 응답 시간은 얼마나 되나요?
WhereParcel API는 캐시된 결과의 경우 500ms 이내, 실시간 택배사 조회의 경우 2-3초 내에 응답합니다. API는 미국 동부(us-east1) 리전에서 제공됩니다.
국제배송(해외직구) 추적이 가능한가요?
네, DHL, FedEx International, UPS Worldwide, TNT 등 국제택배사를 지원합니다. 하나의 API 호출로 택배사 코드와 운송장 번호만으로 국가 간 이동하는 택배를 추적할 수 있습니다.
다른 택배조회 API와 비교했을 때 장점은 무엇인가요?
WhereParcel은 39개 이상의 운영 중인 택배사(원하는 캐리어 빠른 추가)를 지원하는 통합 REST API, 웹훅 알림, 언제든 취소 가능한 구독 등의 장점이 있습니다. 캐시된 결과의 빠른 응답, 다국어 지원, 투명한 건당 과금 방식으로 숨겨진 비용이 없습니다. 5사 2026 비교를 확인하세요.
이커머스(쇼핑몰)에 적합한가요?
물론입니다. WhereParcel은 이커머스, 물류, 배송 플랫폼을 위해 설계되었습니다. 대량 추적, 주문 상태 페이지용 웹훅, 멀티 택배사 지원, 브랜딩 추적 페이지 등 온라인 쇼핑몰에 필요한 모든 기능을 제공합니다.

직접 대화하세요 — 진짜 답장합니다

궁금한 점이 있으신가요? 택배사 추가가 필요하신가요? 그냥 인사만 하셔도 좋습니다. 저희는 모든 메시지를 직접 읽는 소규모 팀입니다. 아무리 사소한 질문이라도 환영합니다.