Maritime Analytics API
# Maritime Analytics API — Indonesia Import/Export Data Access real-time Indonesia import and export intelligence sourced directly manifest data. This API gives you structured, queryable access to shipment manifests, Bills of Lading, container tracking, company profiles, HS code analysis, and advanced trade analytics — all in one place. Built for trade analysts, logistics companies, market…
10 subscribers
9.4/10 popularity
243 ms avg latency
44% success rate
73 endpoints
The in-depth APIMemo review for this API hasn't been published yet —
the data below comes straight from the public marketplace listing.
Maritime Analytics API endpoints
| Method | Endpoint | Description |
|---|---|---|
| Health | ||
| GET |
readinessProbe /health/ready |
Returns HTTP 200 only when the database connection is ready. Use this for Kubernetes readiness probes or pre-query health checks. |
| GET |
livenessProbe /health/live |
Always returns HTTP 200 as long as the API process is running. Designed for Kubernetes liveness probes. |
| GET |
fullHealthCheck /health |
Returns full health status: database and Redis connectivity with latency metrics. Use this to verify the API is fully operational before running queries. |
| Search | ||
| GET |
globalSearch /v1/search/global |
Cross-entity full-text search across shipments (Header), containers (Petikemas), and Bills of Lading. Returns matching records from all three entity types in one call. **Use… |
| Shipments | ||
| GET |
listShipments /v1/shipments |
Returns a paginated list of import shipment manifests (Header records). Supports multiple optional filters. **Tip:** Combine `start_date` + `end_date` for period analysis, or use… |
| GET |
shipmentDetailById /v1/shipments/{shipment_id} |
Returns full detail of a single shipment (manifest header) by its shipment id. Includes all containers and Bills of Lading associated with this shipment. **Example ID:**… |
| Containers | ||
| GET |
listContainers /v1/containers |
Returns a paginated list of containers with their current status, linked shipment, vessel, and port information. **Status values:** `Carried` (terangkut) or `Left Behind`… |
| GET |
trackContainerByNumber /v1/containers/{container_number} |
Returns the full movement history of a container identified by its container number. Shows all shipments the container was used in, including vessel, port pair, and shipper info.… |
| Companies | ||
| GET |
listImportersIndonesian /v1/companies/importers |
Returns a list of Indonesian importers sorted by shipment count. Includes company name, NPWP, total shipments, and cargo weight. |
| GET |
importerProfileByTaxId /v1/companies/importer/{tax_id} |
Returns detailed profile of an Indonesian importer identified by NPWP (tax ID). Includes trade history summary, top suppliers, and ports used. **Example tax_id:** `012345678901000` |
| GET |
listExportersIndonesian /v1/companies/exporters |
Returns a list of Indonesian exporters (consignees in outbound BLs) sorted by shipment count. |
| GET |
listShippersForeignExporters /v1/companies/shipping |
Returns a ranked list of foreign shippers (overseas exporters) sorted by total cargo weight shipped to Indonesia. Useful for identifying dominant overseas suppliers. |
| GET |
exporterProfileByTaxId /v1/companies/exporter/{tax_id} |
Returns detailed profile of an Indonesian exporter identified by NPWP. Includes export history, top buyers, and destination ports. **Example tax_id:** `012345678901000` |
| Vessels | ||
| GET |
topVesselsByCargoVolume /v1/vessels |
Returns vessels ranked by total cargo weight handled. Useful for identifying dominant carriers and fleet composition. **Mode filter:** `Sea` | `Air` | `Land` | `Rail` |
| GET |
vesselPortCallHistory /v1/vessels/{vessel_name}/history |
Returns the full port call history of a vessel by name (partial match supported). Shows arrival dates, cargo volume, routes, and voyage numbers. **Example:** `MAERSK SENTOSA` |
| GET |
vesselLookupByImoNumber /v1/vessels/imo/{imo_number} |
Returns vessel details and port call history for a vessel identified by its IMO number — the globally unique permanent vessel identifier. **Example IMO:** `9234567` |
| GET |
fleetAnalysisByOperator /v1/vessels/fleet-analysis |
Returns fleet composition and performance metrics grouped by shipper/operator. Includes unique vessel count, total voyages, and cargo volume per operator. |
| Ports | ||
| GET |
portTrafficDetail /v1/ports/{port_code}/traffic |
Returns detailed traffic breakdown for a specific port — top origin countries, top vessels, and aggregate shipment stats. **Example port_code:** `IDTPP` (Tanjung Priok),… |
| GET |
portListWithTrafficVolume /v1/ports |
Returns a list of ports with their total traffic volume. Filter by role: - `discharge`: ports of destination in Indonesia - `loading`: ports of origin overseas |
| HS Codes | ||
| GET |
hsCodeTradeFlow /v1/hs-codes/{hs_code}/trade-flow |
Returns detailed trade flow for a specific HS code — top importers, top foreign suppliers, and volume breakdown. **Examples:** - `8471` → computers & laptops importers - `2709` →… |
| GET |
hsCodeStatistics /v1/hs-codes |
Returns HS code statistics ranked by import frequency. Use `search` to find HS codes by keyword (e.g. `plastic`, `8471` for computers). **Use this as the starting point before… |
| Analytics | ||
| GET |
containerUtilization /v1/analytics/container-utilization |
Returns container utilization breakdown by size (20ft/40ft), type (dry/reefer), and load type (FCL/LCL). Includes count and percentage distribution. |
| GET |
topShippersByCargoWeight /v1/analytics/top-shipping |
Returns top foreign shippers ranked by total cargo weight shipped to Indonesia. Supports optional date range filtering. |
| GET |
portDwellTime /v1/analytics/port-dwell-time |
Returns average container dwell time at ports — the duration between vessel arrival and cargo clearance, in hours. Ports with longer dwell times may indicate congestion or… |
| GET |
monthlyShipmentTrend /v1/analytics/monthly-trend |
Returns monthly shipment volume trends — shipment count and total cargo weight per month, ordered most recent first. |
| GET |
topImportersByCargoWeight /v1/analytics/top-importers |
Returns top Indonesian importers ranked by total cargo weight received. Supports optional date range filtering. |
| GET |
topHsCodes /v1/analytics/top-hs-codes |
Returns the most frequently imported HS codes ranked by shipment count. Useful for commodity market overview. |
| GET |
mostActiveTradeRoutes /v1/analytics/trade-routes |
Returns the most active trade routes ranked by shipment count. Each route represents a port-of-loading → port-of-discharge pair. |
| GET |
weeklyVolumeDistribution /v1/analytics/weekly-volume |
Returns shipment volume distribution by day of week (Monday–Sunday). Useful for identifying peak processing days at customs. |
| GET |
seasonalTrends /v1/analytics/seasonal-trends |
Returns month-over-month seasonal import patterns — which months have peak and low trade activity across all years or a specific year. |
| Statistics & Dashboard | ||
| GET |
top10Dashboard /v1/statistics/top-10-dashboard |
Returns a combined dashboard of top-10 rankings across multiple dimensions in a single call: importers, exporters, vessels, discharge ports, origin countries, and HS codes. Ideal… |
| GET |
kpiScorecard /v1/statistics/kpi-scorecard |
Returns key performance indicators for a specific year: total manifests, on-time manifest registration rate, container mix (20ft vs 40ft), LCL/FCL ratio, and B3 (hazardous) cargo… |
| GET |
statisticsOverview /v1/statistics/overview |
Returns a high-level summary of the entire dataset: total manifests, BLs, containers, HS codes, unique importers, vessels, countries, and data date coverage. Ideal as an API… |
| GET |
periodComparisonYoYMoM /v1/statistics/period-comparison |
Compares trade volume between two user-defined time periods. Returns absolute and percentage changes in shipment count, cargo weight, containers, and unique importers. Supports… |
| Cargo Intelligence | ||
| GET |
packagingDistribution /v1/cargo/packaging-distribution |
Returns breakdown of packaging types used across all shipments (cartons, bags, pallets, drums, etc.). Includes shipment count, total packages, and average weight per package. |
| GET |
oversizedShipments /v1/cargo/oversized-shipments |
Returns shipments exceeding a minimum weight threshold. Useful for identifying heavy industrial cargo, potential data entry errors, or under-declaration risk. **Default… |
| GET |
weightSegmentation /v1/cargo/weight-segmentation |
Segments shipments into weight brackets and returns count and percentage per band: - micro: 100t |
| GET |
partialShipments /v1/cargo/partial-shipments |
Returns shipments with `flag_parsial = Y` — shipments where not all containers or packages have been delivered. Useful for partial delivery tracking and customs partial release… |
| GET |
containerPerBlDistribution /v1/cargo/containers-per-bl |
Returns a frequency distribution of how many containers are assigned per Bill of Lading (1, 2–5, 6–10, 11–20, 21+). Helps identify LCL consolidation patterns vs FCL. |
| GET |
densityAnalysis /v1/cargo/density-analysis |
Analyzes cargo density (kg/CBM) by trade lane. Identifies heavy cargo (metals, machinery) vs bulky/light cargo (furniture, plastics) per route. **Density thresholds:** - >1000… |
| Market | ||
| GET |
newImporters /v1/market/new-importers |
Returns companies that recorded their **first ever import** in the specified year (and optionally month). These are potential new leads for freight forwarders, banks, and customs… |
| GET |
commodityDemand /v1/market/commodity-demand |
Returns commodity demand rankings by import volume (HS code level). Shows which commodities are most actively imported, with shipment count, total weight, and container count. |
| GET |
competitorAnalysis /v1/market/competitor-analysis/{tax_id_importer} |
Returns competitor intelligence for a specific importer: other Indonesian importers buying the same HS code commodities. Ranked by shared shipment count. **Example… |
| GET |
consolidationAnalysisLclVsFcl /v1/market/consolidation-analysis |
Returns breakdown of LCL (Less-than-Container-Load) vs FCL (Full Container Load) shipments by volume, plus top importers using LCL consolidation. |
| GET |
importerSupplierNetwork /v1/market/supplier-network/{tax_id_importer} |
Returns the full supplier network for a specific Indonesian importer — every foreign shipper that has sent goods to this company, with shipment frequency, volume, and BL… |
| Market Intelligence | ||
| GET |
commoditySeasonality /v1/market-intelligence/commodity-seasonality/{hs_code} |
Returns monthly seasonality patterns for a specific HS code — peak and low import months, with year-by-year raw data. **Examples:** - `8415` → air conditioners (peak mid-year) -… |
| GET |
hsCodeCommodityTrends /v1/market-intelligence/commodity-trends |
Returns monthly volume trends for commodity categories in a given year. Data includes shipment count, cargo weight, and unique importers per month per HS code. **Note:** `year`… |
| GET |
countryMarketShare /v1/market-intelligence/country-market-share |
Returns market share of origin countries in Indonesian imports, ranked by cargo weight. Includes shipment count, total weight, and percentage share. Useful for detecting supply… |
| GET |
emergingCommodities /v1/market-intelligence/emerging-commodities |
Identifies HS codes with significant import growth over recent months vs the prior equivalent period. **Categories:** - `new`: never seen before - `surging`: volume grew above… |
| GET |
importerCommodityBasket /v1/market-intelligence/commodity-basket/{tax_id_importer} |
Returns the full commodity basket of an importer — all HS codes they import with frequency. Also classifies the importer as Specialist, Multi-product, or General Trader based on… |
+ 23 more endpoints on the provider's documentation.
Maritime Analytics API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $99 / month | 5 / second |
|
| ULTRA Recommended | $199 / month | 10 / second |
|
| MEGA | $299 / month | — |
|
