Maersk APImaersk.com ↗
Access Maersk fleet data, active ports, container tracking, and 200+ shipping routes via a single API. Covers vessel IMO numbers, UN location codes, and transit times.
What is the Maersk API?
This API exposes 10 endpoints covering Maersk's global fleet, port network, and shipping route catalog. You can retrieve the full list of active vessels with IMO numbers and flag countries via list_active_vessels, search 200+ routes across 25 categories, resolve port identifiers including UN location codes and Maersk-internal port codes, and track containers by number or Bill of Lading. Response fields span geographic coordinates, call signs, route slugs, and port sequences with transit times.
curl -X GET 'https://api.parse.bot/scraper/0bef50e0-3839-4914-bb15-ebb7793a5b7d/get_container_tracking?tracking_number=MSKU0123456' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace maersk-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Maersk Shipping SDK — fleet vessels, ports, and location search."""
from parse_apis.maersk_shipping_api import Maersk, LocationNotFound
client = Maersk()
# List active fleet vessels — each has IMO number, flag country, call sign.
for vessel in client.vessels.list(limit=5):
print(vessel.name, vessel.imo_number, vessel.flag_country_code)
# List active ports worldwide — UN location codes and country info.
for port in client.ports.list(limit=5):
print(port.port_name, port.un_location_code, port.country_name)
# Search locations by city name — returns geo-identifiers and coordinates.
location = client.locations.search(city_name="Rotterdam", limit=1).first()
if location:
print(location.city_name, location.country_name, location.latitude, location.longitude)
# Typed error handling: catch when a city search yields nothing.
try:
results = client.locations.search(city_name="Shanghai", limit=3)
for loc in results:
print(loc.city_name, loc.geo_location_id, loc.un_loc_code)
except LocationNotFound as exc:
print(f"No locations found for: {exc.city_name}")
print("exercised: vessels.list / ports.list / locations.search")
Retrieve container tracking information by container number. Note: This endpoint is subject to strict Akamai protection and may be intermittently unavailable.
| Param | Type | Description |
|---|---|---|
| tracking_numberrequired | string | Container number or Bill of Lading number |
{
"type": "object",
"fields": {
"containers": "array"
},
"sample": {
"status": "blocked",
"message": "Blocked by ip_ban",
"block_type": "ip_ban"
}
}About the Maersk API
Fleet and Port Data
list_active_vessels returns every vessel currently active in the Maersk fleet. Each object includes vesselMaerskCode, vesselName, vesselIMONumber, flagISOCountryCode, and callSign — enough to cross-reference against AIS feeds or build vessel directories. list_active_ports covers all ports Maersk serves worldwide, with isoCountryCode, countryName, unLocationCode, cityName, portName, portCode, and regionCode per port entry.
Location Search and Geo Identifiers
search_locations accepts a city_name string and returns up to 25 matching results sorted alphabetically. Each result includes latitude, longitude, unLocCode (may be null for some entries), countryCode, countryName, and the Maersk-specific maerskGeoLocationId. This identifier is useful for correlating locations with route and port data elsewhere in the API.
Route Discovery and Detail
The routing surface has four complementary endpoints. list_all_routes returns 200+ routes with names, slugs, and categories in a single call, along with a category_summary array. list_route_categories enumerates all 25 categories — feeder, intra-regional, and cross-regional — and provides category_slug values for use with list_routes_by_category. get_route_details takes a route_code slug (for example cae-eastbound) and returns the full ordered port sequence with transit times and a port_count. For country-level queries, get_country_routes accepts a region slug (e.g. europe) and a country name (e.g. germany) and returns matching routes with their full port sequences.
Container Tracking
get_container_tracking accepts a tracking_number — either a container number or Bill of Lading number — and returns a containers array with tracking events and status data. This endpoint is subject to stricter protection than the others and may be intermittently unavailable; applications that depend on it should implement retry logic and handle failure states gracefully.
The Maersk API is a managed, monitored endpoint for maersk.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when maersk.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official maersk.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a shipment status dashboard by polling
get_container_trackingwith Bill of Lading numbers from an order management system. - Populate a port directory with UN location codes and region data from
list_active_ports. - Resolve city names to Maersk geo location IDs using
search_locationsbefore querying route data. - Generate a map of all active Maersk vessels with flag country filtering using data from
list_active_vessels. - Enumerate all routes touching a specific country by calling
get_country_routeswith the relevant region and country slug. - Build a route search feature for a logistics tool using
search_routesto match against route names, slugs, and category keywords. - Cross-reference Maersk port codes against internal warehouse location tables using
portCodeandunLocationCodefromlist_active_ports.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Maersk have an official developer API?+
What does `get_container_tracking` actually return, and how reliable is it?+
containers array containing tracking events and status information for a given container number or Bill of Lading. It is explicitly noted as subject to strict Akamai protection, meaning responses can be intermittently unavailable regardless of valid input. Applications should treat a failed response as retriable rather than terminal.Does `search_locations` always return a UN location code?+
unLocCode field in search results may be null for some locations. The maerskGeoLocationId and countryCode fields are consistently populated and can serve as fallback identifiers when unLocCode is absent.Does the API expose vessel schedules or port ETAs?+
Can I filter `list_all_routes` by region or port?+
list_all_routes endpoint returns all routes in one payload without server-side filtering parameters. For region-scoped results, use get_country_routes with a region and country input, or use list_routes_by_category with a category slug from list_route_categories. You can also fork the API on Parse and add a filter layer over the full route list.