Container port throughput by country: one number per economy, delivered

One number per economy-year that answers the first question of any port-market study: how many containers did this country move? The record that answers it at national grain is World Bank – Container Port Traffic (TEU) — UNCTAD's compilation, published through the World Development Indicators as series IS.SHP.GOOD.TU, scored 9 out of 10 on Datadory's quality rubric. A full pull verifies 2,793 non-null observations across 207 distinct economies and aggregates out of roughly 217 listed, spanning 2005–2024, one TEU total per economy-year.

Three neighbors extend the same question. UNCTADstat Maritime Transport Data Centre is the compiling agency's own shelf, where containerized throughput sits among 150+ indicators beside fleet, seaborne trade and quarterly connectivity. Eurostat Maritime Transport Statistics resolves EU volumes down to single ports such as Antwerp-Bruges. BTS Maritime Data and Port Performance Freight Statistics ranks America's Top 25 container ports by TEU. Between them, the same box-count reads at world, continental and berth grain.

Every figure in the panel obeys one definition, and three clauses of it change how the numbers should be read. The measure counts containers flowing between land and sea in twenty-foot equivalent units; it includes coastal shipping alongside international journeys; and — the clause that matters most — transshipment is booked as two lifts at the intermediate port, once offloaded and once loaded outbound. Empty units are counted with loaded ones.

Consequences follow mechanically. A relay hub whose berths shuffle boxes between deep-sea loops accumulates lifts faster than an economy of identical consumption that only lands its own imports, so national TEU rewards gateway geography, not domestic demand alone. A surge in cheap empties moves the line as surely as full exports. And because each value sums every port in the economy, the national total is the floor of resolution, not the ceiling.

The standard correction is to read volume beside network position: World Bank – Liner Shipping Connectivity Index scores how plugged into liner networks each economy is, so a throughput spike backed by rising connectivity reads as structural growth and one without it reads as relay traffic passing through.

Nine flat fields, no nesting, one economy-year per row — identity codes, the year, the count, and two display hints:

# one row = economy x year
indicator.id       IS.SHP.GOOD.TU      # WDI series code
country.id         NL                  # two-letter economy code
countryiso3code    NLD                 # ISO 3166-1 alpha-3 - the join key
date               2024                # reference year
value              14517179            # TEU lifted
decimal            0                   # recommended display precision

The Netherlands' verified run shows the shape of a mature gateway: 14,757,227 TEU in 2020, a 2021 peak of 15,781,756, then 14,929,333 in 2022, 14,111,298 in 2023 and 14,517,179 in 2024. The pandemic high-water mark stayed unreached through 2024 even as the 2023-to-2024 recovery added 405,881 TEU. That kind of arc — plateau, trough, partial rebound — is exactly what a clean economy-year panel makes visible without anyone reshaping a spreadsheet.

Coverage is broad but not uniform. Of roughly 217 listed economies and aggregates, 207 carry actual figures; the remaining slots stay null where a state never reported. Nulls mean not reported, never zero activity — average across them unfiltered and the missing economies silently drag the panel toward nothing.

The second trap is structural: World Bank regional and income aggregates such as East Asia & Pacific sit in the same table as sovereign states. Any ranking that fails to tag them ranks the Netherlands against an entire region. Both country code systems travel on every row precisely so this filter is one predicate long.

Vintages deserve one habit: pin them. Recent years arrive provisional until UNCTAD's revisions settle, and sibling panels shift their rosters between releases — the connectivity panel holds 169 economies against this one's 207. Freeze the vintage a model trained on, and label blended cuts with the mix rather than letting a single 'latest' claim cover three different reference years.

Five cataloged records publish container volumes, and they separate cleanly by geography and grain. The choice among them decides how far down from the national total your analysis can reach.

Market researchers & consultants start market sizing from a ranked list of economies that actually move boxes — one comparable metric across 207 beats assembling per-port statistics by hand. Competitive intelligence teams read trajectories to see which national gateway markets are absorbing cargo and which are leaking share, the backdrop behind every expansion announcement. Investors & quants take containerization intensity as a regressable column rather than a research project, often beside the connectivity index on the same grain. Policy analysts and development banks benchmark a corridor or customs reform against peer economies, using the infrastructure-quality perception scores to explain gaps that throughput alone cannot. Journalists quote national figures because each traces to a named compiler with a stable methodology.

Two records deepen the picture below the national line. Natural Earth – World Ports contributes 1,081 worldwide port points for basemaps, BTS Principal Ports adds 150 U.S. port polygons carrying CY 2023 tonnage, and USACE Waterborne Commerce supplies cargo statistics for 1,381 locations across 2002–2024. For the macro slide, AAPA's 2024 economic contribution report values U.S. ports near $2.89 trillion of GDP supporting one in eight American jobs.

The panel is unusually cooperative downstream: dual country keys plus a plain year column join to the Liner Shipping Connectivity Index, the port directories and freight-flow tables on exact matches rather than name matching. Aggregate rows arrive pre-tagged so the nulls and regional rollups never reach your ranking logic. Most teams take throughput beside connectivity so volume and network position land on one economy-year grain, and switching frequency later is a settings conversation, not a re-integration project.

Start with a sample: name the economies and years and the extract comes back shaped like your question.

National throughput is one thread in a wider maritime stack. The marine-ports-services data hub keeps the industry's records ranked, and best marine ports services datasets puts the scorecard in one view. For the competitiveness benchmark that explains why throughput concentrates where it does, see liner shipping connectivity index data; for the builder's view of the whole slice, how developers use marine ports & services data; for the federal side of the U.S. ledger, US port tonnage by commodity.

Product pages with complete field dictionaries and samples: World Bank – Container Port Traffic (TEU), UNCTADstat Maritime Transport Data Centre and World Bank – Liner Shipping Connectivity Index.