HMM Cargo Tracking Scraper

What does HMM Cargo Tracking Scraper do?

HMM Cargo Tracking Scraper is an Apify actor that extracts real-time shipment tracking data from HMM (Hyundai Merchant Marine), one of the world's largest container shipping carriers. Simply enter your tracking numbers — container numbers, B/L (Bill of Lading) numbers, or booking numbers — and the scraper automatically detects the type, queries the HMM e-Service tracking system, and returns structured shipment data ready for analysis or integration.

No coding experience is needed. Paste your numbers, click Start, and download the results in JSON, CSV, Excel, or other formats.

Why scrape HMM shipment data?

Manually checking the HMM website for container tracking updates is time-consuming, especially when managing multiple shipments across different trade lanes. This actor automates HMM cargo tracking so you can:

• 📦 Monitor shipment status — Get real-time container milestones, vessel names, voyage numbers, ports and status updates
• 🔄 Track in bulk — Track hundreds of container, B/L, or booking numbers in a single run
• 📊 Feed data into dashboards — Export structured tracking data to Google Sheets, Slack, email, or your own systems via Apify integrations
• ⏰ Set up automated tracking — Schedule periodic runs to monitor shipment progress without manual checks
• 🚨 Catch exceptions early — Track discharge, customs clearance, and empty-return / last-free-day events as they happen
• 🔗 Build logistics pipelines — Use the Apify API to integrate HMM tracking data into your supply chain management tools

What data can you extract from HMM?

The scraper extracts the following data points from HMM's tracking system:

Data Field	Description
Tracking Number	The number you submitted
Type	Detected number type (cntr, bl, or bkg)
Shipment Progress	Full milestone timeline — activity name, date/time, location, and transporting vessel/voyage for every step
Vessel Movements	Vessel name and voyage per leg, port of loading, port of discharge, with estimated departure/arrival dates
Current Location	Latest known location and status of the shipment
Customs Status	Customs clearance state at destination
Container Details	Container no, type/size, gross weight, seal no, cargo type, B/L no, booking no, service term (e.g. CY-CY), B/L type
Empty Container Return	Empty-return depot, depot address, and demurrage/detention expiry (last free day)
B/L Information	B/L status, original B/L status, and delivery-order status

Ready-to-Run Examples

Get started in seconds — open the example in the Apify Console and click Run:

• Track HMM Containers by Container Number — enter a container number and get its full milestone timeline, vessel movements, current location, container details, and empty-return info.

How to track HMM shipments step by step

1. Go to the HMM Cargo Tracking Scraper on Apify Store
2. Click Try for free to open the actor in the Apify Console
3. Enter your tracking numbers in the Tracking Numbers field — one per line. Container numbers (e.g., HMMU2001789), B/L numbers, and booking numbers are all accepted; the type is detected automatically
4. Click Start to run the scraper
5. When the run finishes, preview the results in the Output tab, or download them as JSON, CSV, Excel, XML, HTML, or RSS

Example input

{
  "trackingNumbers": [
    "HMMU2001789"
  ]
}

HMM tracking input parameters

Parameter	Type	Required	Description
trackingNumbers	Array of strings	✅ Yes	The numbers to track — one per line. Container numbers, B/L numbers, and booking numbers are all accepted; the type is detected automatically.

HMM Cargo Tracking Scraper output example

Each tracked number produces one structured item in the dataset. Here is a shortened example of the output when tracking a container number:

{
  "tracking_number": "HMMU2001789",
  "tracking_type": "cntr",
  "data": {
    "result_code": "0000",
    "trackingInfomationresult_title": "Original B/L",
    "trackingInfomationresult_statusName": "Not yet recovered",
    "trackingInfomationresult_deliveryOrder": "Not Applicable",
    "cntrList": [
      {
        "cntrNo": "HMMU2001789",
        "cntrTpszCd": "DC/20",
        "cntrWgt": "25200",
        "cntrSealNo": "25H1489961",
        "cgoTp": "DG",
        "blNo": "TSNM80961500",
        "bkgNo": "TSNM80961500",
        "blType": "O.B/L",
        "svcTerm": "CY-CY",
        "finishedActNm": "Vessel Discharged at POD",
        "finishedActDt": "2026-07-16 23:44"
      }
    ],
    "shipmentProgressResult": [
      {
        "actNm": "Vessel Discharged at POD",
        "actStusCd": "F",
        "actlYmd": "16-Jul-2026",
        "actlTm": "11:44 PM",
        "locNm": "CALLAO, PERU",
        "trsptnMod": "HYUNDAI FORCE 0117E",
        "trsptnModeTpCd": "Mother VSL"
      }
    ],
    "vesselMovementResult": [
      {
        "vslNm": "HMM LIME",
        "vvdNm": "HMM LIME 0001W",
        "polNm": "XINGANG, TIANJIN, CHINA",
        "podNm": "BUSAN, KOREA",
        "cstEtdDt": "202605040800",
        "cstEtaDt": "202605061510"
      }
    ],
    "currentLocationResult": [
      {
        "actNm": "Vessel Discharged at POD",
        "locNm": "CALLAO, PERU",
        "actlYmd": "16-Jul-2026",
        "actlTm": "11:44 PM"
      }
    ],
    "emptyContainerReturnLocationResult": [
      {
        "cntrNo": "HMMU2001789",
        "ctpMtyRtnDptCd": "DP WORLD",
        "ctpMtyRtnDptAddr": "MANCO CÁPAC S/N CALLAO, PERÚ",
        "dndExpDt": "02-AUG-2026"
      }
    ]
  }
}

The actual output includes the full milestone timeline and every vessel movement. The example above is shortened for clarity. You can download the complete dataset in JSON, CSV, Excel, and other formats from the Output tab.

Integrations and HMM tracking API

HMM Cargo Tracking Scraper is built on the Apify platform, which gives you powerful options to automate and integrate your cargo tracking workflow:

• API access — Call the actor programmatically via the Apify API to track shipments from your own applications
• Scheduled runs — Set up scheduled recurring runs to monitor shipment progress daily, hourly, or at any interval
• Webhooks — Receive notifications when a tracking run finishes so you can trigger downstream processes
• Integrations — Connect tracking results to Google Sheets, Slack, Zapier, Make, and many more
• Data formats — Download results in JSON, CSV, Excel, XML, HTML, or RSS

This makes HMM Cargo Tracking Scraper a drop-in solution for supply chain management systems, logistics dashboards, and automated shipping notifications.

Frequently asked questions

Is it legal to scrape HMM?

Our scrapers are ethical and do not extract any private user data. They only extract publicly available shipment tracking information that any visitor can access on the HMM website with a tracking number. We therefore believe that our scrapers, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain data related to commercial shipments. If you're unsure about your use case, consult your legal team.

Can I track multiple shipments at once?

Yes. Enter as many tracking numbers as you need in the Tracking Numbers field — one per line. The scraper processes them in parallel batches for maximum speed and uses automatic IP rotation to handle rate limits.

What types of tracking numbers are supported?

The scraper accepts three types of numbers and detects the type automatically — no manual selection needed:

• Container numbers — ISO 6346 format (4 letters + 7 digits, e.g., HMMU2001789 or HDMU2447290)
• B/L (Bill of Lading) numbers — HMM B/L reference numbers (prefix HDMU)
• Booking numbers — HMM booking reference numbers

What if a tracking number is not found?

If a number returns no tracking data from HMM's system, the scraper logs a warning and skips it. You are not charged for numbers that return no results.

How do I get support or report issues?

If you encounter any issues or have questions about the HMM Cargo Tracking Scraper, you can:

• Open an issue on the Issues tab of the actor page
• Reach out to the developer for a custom solution based on your specific tracking needs

We welcome all feedback and feature requests!