Delivery Tracking Actor

This Apify Actor tracks package delivery information. It supports an extensive list of Korean and international shipping companies.

Supported Courier Companies

The courier_company input accepts the following case-insensitive English codes.

Code Input	Company Name (Korean)	Company Name (English/Transliterated)
CJ	CJ대한통운	CJ Logistics
POST	우체국택배	Korea Post
HANJIN	한진택배	Hanjin Shipping
LOTTE	롯데택배	Lotte Global Logistics
LOGEN	로젠택배	Logen
HOMEPICK	홈픽	Homepick
GS25	GS25편의점택배	GS25 Convenience Store
CU	CU 편의점택배	CU Convenience Store
KYUNGDONG	경동택배	Kyungdong Courier
DAESHIN	대신택배	Daeshin Courier
ILYANG	일양로지스	Ilyang Logis
HAPDON	합동택배	Hapdon Courier
KUNYOUNG	건영택배	Kunyoung Courier
CHUNIL	천일택배	Chunil Courier
HANDEX	한덱스	Handex
HANYI	한의사랑택배	Hanyi Sarang
EMS	EMS	EMS
TNT	TNT Express	TNT Express
UPS	UPS	UPS
FEDEX	Fedex	FedEx
USPS	USPS	USPS
LX_PANTOS	LX판토스	LX Pantos
GSMNTON	GSMNtoN	GSMNtoN
ECMS	ECMS Express	ECMS Express
KGL_NETWORKS	KGL네트웍스	KGL Networks
WOORI	우리택배(구호남택배)	Woori Courier
GSI	GSI Express	GSI Express
SLX	SLX택배	SLX Courier
WOORI_HANBANG	우리한방택배	Woori Hanbang
SEBANG	세방	Sebang
YJS_GLOBAL_UK	YJS글로벌(영국)	YJS Global (UK)
SUNGWON	성원글로벌카고	Sungwon Global Cargo
HOME_INNOVATION	홈이노베이션로지스	Home Innovation Logis
EUNHA	은하쉬핑	Eunha Shipping
GIANT	Giant Network Group	Giant Network Group
FLF	FLF퍼레버택배	FLF Perever
NONGHYUP	농협택배	Nonghyup Courier
YJS_GLOBAL	YJS글로벌(월드)	YJS Global (World)
DAELIM	대림통운	Daelim Transport
LOTOS	LOTOS CORPORATION	LOTOS Corporation
ANYTRACK	애니트랙	Anytrack
SUNGHUN	성훈물류	Sunghun Logistics
IK	IK물류	IK Logistics
ZENIEL	제니엘시스템	Zeniel System
SMART_LOGIS	스마트로지스	Smart Logis
ETOMARS	이투마스(ETOMARS)	Etomars
PULL_AT_HOME	풀앳홈	Pull at Home
KURLY_NEXTMILE	컬리넥스트마일	Kurly Nextmile
DOOBAL	두발히어로	Doobal Hero
HIVE_CITY	하이브시티	Hive City
KAKAO	카카오	Kakao
PAN_WORLD	판월드로지스틱㈜	Pan World Logistics
TRAX	트랙스로지스	Trax Logis
LOGIS_PARTNER	로지스파트너	Logis Partner
DILY_RABBIT	딜리래빗	Dily Rabbit
GOP	지오피	GOP
HK_HOLDINGS	에이치케이홀딩스	HK Holdings
HTNS	HTNS	HTNS
DHL	DHL	DHL
LAST_MILE	라스트마일	Last Mile
INTER_LOGIS	인터로지스	Inter Logis
TODAY_DELIVERY	당일배송	Today Delivery
PANSTAR	팬스타국제특송(PIEX)	Panstar Express (PIEX)
JINIGO	지니고 당일배송	Jinigo Today Delivery
LOTTE_GLOBAL	롯데글로벌로지스	Lotte Global Logistics (Intl)
NAEUN	나은물류	Naeun Logistics
HANSEM	한샘서비스 택배	Hansem Service
SHIPNERGY	SHIPNERGY	Shipnergy
DODOFLEX	도도플렉스(dodoflex)	Dodoflex
BRIDGE_LOGIS	브릿지로지스㈜	Bridge Logis
HUBNET	허브넷로지스틱스	Hubnet Logistics
MEXGLOBAL	MEXGLOBAL	Mexglobal
ACE_EXPRESS	A.C.E EXPRESS INC	A.C.E Express
THUNDER_HERO	썬더히어로	Thunder Hero
1004_HOME	1004홈	1004 Home
CANADA_SHIPPING	㈜캐나다쉬핑	Canada Shipping
VROONG	부릉	Vroong
YUNDA	YUNDA EXPRESS	Yunda Express
VALEX	발렉스 특수물류	Valex Special Logistics
PATECH	파테크해운항공	Patech
PINGPONG	핑퐁	Pingpong
BABABA	바바바(bababa)	Bababa
BAIMA	BAIMA EXPRESS	Baima Express
NTLPS	엔티엘피스	NTLPS
LTL	LTL	LTL
GK_GLOBAL	지케이글로벌	GK Global
TANGO_GO	탱고앤고	Tango & Go
JIKGUMUN	직구문	Jikgumun
TODAY	투데이	Today
CUBEFLOW	큐브플로우(CUBEFLOW)	Cubeflow
KSE	국제로지스틱(KSE)	International Logistics (KSE)
ESTHER	에스더쉬핑	Esther Shipping
ARGO	ARGO	Argo
GOLD_SNEPS	골드스넵스	Gold Sneps
GNG	GNG(자이언트)	GNG (Giant)
MT_INTL	(주)엠티인터내셔널	MT International
EASY_LOGIS	(주)이지로지스틱	Easy Logistic
KT	KT EXPRESS	KT Express
HY	hy	hy
BANYAN	반얀로지스틱스	Banyan Logistics
WIDE_TECH	와이드테크	Wide Tech
DILYBOX	딜리박스	Dilybox
ESTRA	이스트라	Estra
SEORIM	서림물류	Seorim Logistics
WINION	위니온	Winion
ALLIN	올인닷컴	Allin.com
LCS	물류대장(LCS)	Logistics King (LCS)
SLO	SLO(모든)	SLO
GCS	지씨에스	GCS
BAROS	바로스	Baros
LETTERS	레터스	Letters
SEVEN_ELEVEN	세븐일레븐 착한택배	7-Eleven
LOGIS_KING	물류대장	Logis King

Input Schema

The Actor accepts a JSON input with the following fields:

{
    "courier_company": "CJ",
    "tracking_number": "1234567890",
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": []
    }
}

• courier_company (String, required): The English code of the courier company (see list above).
• tracking_number (String, required): The tracking number of the package.
• proxyConfiguration (Object, optional): The proxy configuration for the crawler.

Output

The Actor pushes the tracking results to the default dataset.

Success Response Example

{
    "success": true,
    "data": {
        "result": "Y",
        "senderName": "Sender Name",
        "receiverName": "Receiver Name",
        "itemName": "Item Name",
        "invoiceNo": "1234567890",
        "orderLevel": 5,
        "parcelLevel": 5,
        "deliveryStatus": "UNKNOWN",
        "trackingDetails": [
            {
                "time": 1672322400000,
                "timeString": "2024.12.29 18:00",
                "kind": "Delivered",
                "where": "Seoul",
                "telno": "",
                "telno2": "",
                "level": 6,
                "manName": "",
                "manPic": ""
            }
        ]
    }
}

Error Response Example

{
    "success": false,
    "error": "Tracking information not found. Please check the tracking number and courier.",
    "raw_response": { ... }
}

API Usage

You can run this Actor programmatically using the Apify API. The following example shows how to run the Actor and retrieve the results synchronously.

# Set your Apify API token
# Find this in your Apify Console -> Settings -> Integrations
API_TOKEN=<YOUR_API_TOKEN>

# Prepare Actor input
cat > input.json << 'EOF'
{
  "courier_company": "cj",
  "tracking_number": "123456789012",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": []
  }
}
EOF

# Run the Actor and fetch results
curl "https://api.apify.com/v2/acts/valiant_socks~delivery-tracking/run-sync-get-dataset-items?token=$API_TOKEN" \
  -X POST \
  -d @input.json \
  -H 'Content-Type: application/json'

This request will start the Actor, wait for it to finish, and return the items from the default dataset.