Maritime Port & Trade Route API
# Maritime Port & Trade Route API Access comprehensive maritime data for 3,800+ global ports with sea distance calculations and GeoJSON shipping routes. ## Features - **Port Search** — Search ports by name, country, or coordinates with fuzzy matching - **LOCODE/WPI Lookup** — Direct access via UN/LOCODE or World Port Index number - **Nearest Port** — Find closest ports to any lat/lng coordinate…
Maritime Port & Trade Route API endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET |
country_list_countries_get /countries |
List all countries with port counts. |
| GET |
country_ports_countries__code__ports_get /countries/{code}/ports |
List ports for a specific country, paginated. |
| GET |
port_search_ports_search_get /ports/search |
Search ports by name with fuzzy matching and optional filters. |
| GET |
nearest_ports_ports_nearest_get /ports/nearest |
Find ports nearest to a geographic point. |
| DELETE |
delete_webhook_webhooks__webhook_id__delete /webhooks/{webhook_id} |
Deactivate a webhook subscription. Enterprise tier only. |
| POST |
create_webhook_webhooks_post /webhooks |
Subscribe to port data change events. Enterprise tier only. |
| GET |
port_by_unlocode_ports_unlocode__code__get /ports/unlocode/{code} |
Get a port by its UN/LOCODE. |
| GET |
list_webhooks_webhooks_get /webhooks |
List all active webhook subscriptions for the authenticated API key. |
| GET |
port_stats_ports_stats_get /ports/stats |
Get aggregate port statistics. |
| GET |
port_by_wpi_ports_wpi__index__get /ports/wpi/{index} |
Get a port by its WPI index number. |
| GET |
health_check_health_get /health |
Check database and Redis connectivity. Returns status for each backend service. Individual service failures are reported but do not cause a 500 response -- the endpoint always… |
| GET |
port_detail_ports__port_id__get /ports/{port_id} |
Get full port profile by ID. |
| POST |
batch_routes_routes_batch_routes_post /routes/batch/routes |
Requires **Pro+** tier. Returns full RouteResponse with GeoJSON per pair. Partial success model -- each pair returns individually with status. |
| GET |
calculate_sea_route_routes_sea_get /routes/sea |
Calculate sea distance, transit time, and route geometry between two ports. **Port identification:** Provide either a UNLOCODE (`origin`/`destination`) or raw coordinates… |
| POST |
batch_distances_routes_batch_distances_post /routes/batch/distances |
Requires **Pro+** tier. Returns distance-only results (no geometry). Partial success model -- each pair returns individually with status. |
Maritime Port & Trade Route API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 2 / minute |
|
| PRO | $9.99 / month | 30 / minute |
|
| ULTRA Recommended | $29.99 / month | 60 / minute |
|
| MEGA | $79.99 / month | 120 / minute |
|