Pilot Vessel Tracking API: Real-Time Maritime Data & Analytics

Pilot Vessel Tracking API: Real-Time Maritime Data & Analytics

Introduction

In the fast-paced world of maritime logistics, having access to real-time data is crucial for operational efficiency and decision-making. The Vessels API provides developers, startups, and enterprise teams with a powerful REST API that offers comprehensive maritime data, including vessel tracking, fleet operations, port intelligence, and emissions scoring. With 17 endpoints designed to meet the needs of various maritime stakeholders, this API is your go-to solution for accessing global maritime vessel tracking data powered by AIS (Automatic Identification System).

Why Choose Vessels API?

The Vessels API stands out in the maritime data landscape for several reasons:

  • 18 REST endpoints covering vessel search, live tracking, fleet operations, port intelligence, and IMO CII emissions scoring.
  • One API key and one base URL, eliminating the complexity of OAuth and per-endpoint authentication differences.
  • Consistent JSON envelope on every response, ensuring a uniform experience: {status, success, message, data}.
  • Global AIS coverage with near real-time refresh rates, providing timely and accurate data.
  • A 7-day free trial on all plans, allowing users to explore the API's capabilities before committing.
  • Target users include developers, logistics startups, fleet managers, port operators, and ESG/compliance teams.

Key Endpoints for Vessel Tracking

In this section, we will explore the most relevant endpoints for vessel tracking, providing detailed explanations, code examples, and practical use cases.

1. Vessel Search

The /vessels/search endpoint allows users to find any vessel by name, IMO, or MMSI. This is particularly useful for logistics companies that need to track specific vessels in their fleet.

Request Example:

curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/search?query=atlantic&flag=Panama"

Response Example:

{
"data": {
"vessels": [
{
"imo": "1234567",
"mmsi": "123456789",
"name": "Atlantic Voyager",
"flag": "Panama",
"vessel_type": "Cargo",
"gross_tonnage": 50000,
"deadweight_tonnage": 30000,
"year_built": 2010,
"length_m": 250,
"width_m": 40
}
],
"pagination": {
"current_page": 1,
"per_page": 1,
"total": 1,
"last_page": 1
}
}
}

Key Fields Explained:

  • imo: International Maritime Organization number, a unique identifier for the vessel.
  • mmsi: Maritime Mobile Service Identity, used for communication and tracking.
  • name: The name of the vessel.
  • flag: The country under which the vessel is registered.
  • vessel_type: The type of vessel (e.g., cargo, tanker).
  • gross_tonnage: The total internal volume of the vessel.
  • deadweight_tonnage: The maximum weight the vessel can safely carry.
  • year_built: The year the vessel was constructed.
  • length_m: The length of the vessel in meters.
  • width_m: The width of the vessel in meters.

2. Live Vessel Tracking

The /vessels/track endpoint provides live position data, including up to 168 hours of position history, active routes, predicted ETAs, and weather conditions. This endpoint is essential for fleet managers who need to monitor their vessels in real-time.

Request Example:

curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/track?mmsi=258785000&hours=48"

Response Example:

{
"data": {
"vessel": {
"imo": "1234567",
"mmsi": "258785000",
"name": "Atlantic Voyager"
},
"current_position": {
"latitude": 34.0522,
"longitude": -118.2437,
"speed_knots": 12,
"course_degrees": 90,
"heading_degrees": 90,
"navigational_status": "Underway",
"timestamp_utc": "2023-10-01T12:00:00Z",
"destination": "Los Angeles",
"eta": "2023-10-02T08:00:00Z"
},
"position_history": [...],
"route": {
"departure_port": "San Francisco",
"departure_time": "2023-10-01T10:00:00Z",
"destination_port": "Los Angeles",
"eta": "2023-10-02T08:00:00Z",
"distance_nm": 300,
"avg_speed_knots": 12
},
"last_port_visits": [...]
}
}

Key Fields Explained:

  • current_position: Contains real-time data about the vessel's current location, speed, and navigational status.
  • route: Provides information about the vessel's journey, including departure and destination ports, ETA, and distance remaining.
  • position_history: An array of historical positions for the vessel, useful for tracking its movements over time.
  • last_port_visits: Details of the vessel's recent port visits, which can be crucial for logistics planning.

3. Nearby Vessels

The /vessels/nearby endpoint allows users to retrieve all vessels within a specified radius of a given latitude and longitude. This is particularly useful for port operators and logistics teams who need to monitor vessel traffic in specific areas.

Request Example:

curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/nearby?latitude=-34.60&longitude=-58.38&radius=30"

Response Example:

{
"data": {
"center": {
"latitude": -34.60,
"longitude": -58.38
},
"radius_nm": 30,
"total": 5,
"vessels": [
{
"imo": "1234567",
"mmsi": "258785000",
"name": "Atlantic Voyager",
"ship_type": "Cargo",
"position": {
"latitude": -34.60,
"longitude": -58.38,
"timestamp_utc": "2023-10-01T12:00:00Z"
},
"distance_nm": 10,
"speed_knots": 12,
"course_degrees": 90,
"navigational_status": "Underway"
}
]
}
}

Key Fields Explained:

  • center: The geographical center point from which nearby vessels are being queried.
  • radius_nm: The radius in nautical miles within which vessels are being searched.
  • total: The total number of vessels found within the specified radius.
  • vessels: An array of vessels found, each containing details such as position, speed, and navigational status.

4. Vessel Analytics

The /vessels/analytics endpoint provides aggregated voyage statistics, allowing users to switch modes between vessel, port, or fleet analytics. This is invaluable for fleet managers and logistics teams looking to optimize operations.

Request Example:

curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/analytics?type=vessel&mmsi=258785000&period=7d"

Response Example:

{
"data": {
"type": "vessel",
"mmsi": "258785000",
"imo": "1234567",
"name": "Atlantic Voyager",
"period": "7d",
"statistics": {
"total_distance_nm": 500,
"avg_speed_knots": 12,
"max_speed_knots": 15,
"port_calls_count": 3,
"total_time_in_port_hours": 24,
"ports_visited": ["San Francisco", "Los Angeles"]
}
}
}

Key Fields Explained:

  • statistics: Contains key performance metrics for the vessel over the specified period, including total distance traveled, average speed, and port calls.
  • ports_visited: An array of ports that the vessel has visited during the specified period, useful for compliance and reporting.

5. Fleet Operations

The /vessels/fleet endpoint allows users to batch request positions, routes, and statistics for multiple vessels in one request. This is particularly beneficial for fleet managers who need to monitor several vessels simultaneously.

Request Example:

curl -X POST -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" -d '{"vessels":[{"imo":"9122556"},{"mmsi":"309374000"}],"include_positions":true,"include_routes":true}' "https://vessels-api.com/api/V1/vessels/fleet"

Response Example:

{
"data": {
"fleet": {
"total_vessels": 2,
"vessels_at_sea": 1,
"vessels_in_port": 1
},
"vessels": [
{
"imo": "9122556",
"mmsi": "258785000",
"name": "Atlantic Voyager",
"position": {
"latitude": 34.0522,
"longitude": -118.2437
},
"route": {
"departure_port": "San Francisco",
"destination_port": "Los Angeles"
}
}
]
}
}

Key Fields Explained:

  • total_vessels: The total number of vessels in the fleet.
  • vessels_at_sea: The number of vessels currently at sea.
  • vessels_in_port: The number of vessels currently docked at a port.
  • vessels: An array of vessels with their current positions and routes.

Port Intelligence

The Vessels API also provides valuable insights into port operations, which can significantly enhance logistics planning and efficiency.

1. Port Congestion

The /ports/congestion endpoint offers real-time congestion snapshots and wait-time statistics for a specific port. This is crucial for logistics teams to plan arrivals and departures effectively.

Request Example:

curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/ports/congestion?port_id=ARBUE&period=7d"

Response Example:

{
"data": {
"port_id": "ARBUE",
"port_name": "Port of Buenos Aires",
"period": "7d",
"snapshot": {
"vessels_in_anchorage": 5,
"vessels_at_berth": 3
},
"statistics": {
"avg_wait_time_hours_last_7d": 2,
"max_wait_time_hours_last_7d": 5,
"avg_berth_time_hours_last_7d": 3,
"port_calls_count": 20
}
}
}

Key Fields Explained:

  • snapshot: Provides a current overview of vessel traffic at the port.
  • statistics: Contains historical data on wait times and port calls, which can help in planning and resource allocation.

2. Port Catalog

The /ports endpoint provides a full catalog of ports, including identifiers, coordinates, and country information. This is essential for logistics teams to identify and plan for port operations.

Request Example:

curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/ports"

Response Example:

{
"data": {
"ports": [
{
"port_id": "ARBUE",
"name": "Port of Buenos Aires",
"country": "Argentina",
"latitude": -34.60,
"longitude": -58.38,
"timezone": "UTC-3"
}
],
"total": 248
}
}

Key Fields Explained:

  • port_id: Unique identifier for the port.
  • name: The name of the port.
  • country: The country where the port is located.
  • latitude: Geographical latitude of the port.
  • longitude: Geographical longitude of the port.
  • timezone: The timezone in which the port operates.

3. Expected Arrivals

The /port/expected-arrivals endpoint provides information about vessels expected to arrive at a specific port, including their ETA and origin. This is vital for port operators to manage incoming traffic effectively.

Request Example:

curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/port/expected-arrivals?port=ARBUE"

Response Example:

{
"data": {
"port_id": "ARBUE",
"port_name": "Port of Buenos Aires",
"expected_arrivals": [
{
"mmsi": "258785000",
"imo": "1234567",
"name": "Atlantic Voyager",
"vessel_type": "Cargo",
"eta": "2023-10-02T08:00:00Z",
"departure_port": "San Francisco"
}
],
"total": 1
}
}

Key Fields Explained:

  • expected_arrivals: An array of vessels expected to arrive, including their ETA and departure port.

Conclusion

The Vessels API is an indispensable tool for anyone involved in maritime logistics, offering a comprehensive suite of endpoints that provide real-time data and analytics. Whether you are a developer building a fleet management dashboard, a logistics startup optimizing ETAs, or a port operator managing vessel traffic, the Vessels API has the capabilities you need.

Don't miss out on the opportunity to enhance your maritime operations. Try Vessels API for free and discover how easy it is to integrate powerful maritime data into your applications. Get started with Vessels API today!

Keywords
Pilot Vessel Tracking API real-time maritime data maritime analytics API API for logistics vessel tracking solutions

Ready to get started?

Get your API key and start tracking vessels in minutes.

Get API Key

Related posts