In the fast-paced world of maritime logistics, having access to real-time data is crucial for optimizing operations, ensuring compliance, and enhancing decision-making. Tugboats, as essential vessels in port operations and maritime logistics, require precise tracking and analytics to improve efficiency and safety. The Vessels API provides a comprehensive solution for developers, startups, and enterprise teams looking to harness the power of maritime data through its robust REST API. With 17 endpoints covering vessel search, live AIS tracking, fleet operations, port intelligence, and IMO CII emissions scoring, the Vessels API is the go-to maritime data API.
Why Choose Vessels API?
The Vessels API stands out for several reasons:
- 18 REST endpoints covering a wide range of maritime data.
- One API key and a single base URL for seamless integration.
- Consistent JSON response structure for easy parsing.
- Global AIS coverage with near real-time refresh rates.
- Scalable solutions suitable for indie developers to enterprise fleets.
- 7-day free trial available for all plans.
With these features, the Vessels API is designed to meet the needs of developers, logistics startups, fleet managers, port operators, and ESG/compliance teams.
Key Endpoints for Tugboat Tracking
To effectively track tugboats and optimize their operations, the following endpoints are particularly relevant:
- Vessel Search:
GET /vessels/search - Live Tracking:
GET /vessels/track - Nearby Vessels:
GET /vessels/nearby - Fleet Operations:
POST /vessels/fleet - Port Congestion:
GET /ports/congestion - Expected Arrivals:
GET /port/expected-arrivals
1. Vessel Search
The GET /vessels/search endpoint allows you to find any vessel by name, IMO, or MMSI. This is particularly useful for identifying tugboats operating in specific regions or under certain flags.
Example Request:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/search?query=tugboat&flag=Panama"Example Response:
{
"data": {
"vessels": [
{
"imo": "1234567",
"mmsi": "123456789",
"name": "Tugboat Alpha",
"flag": "Panama",
"vessel_type": "Tug",
"gross_tonnage": 500,
"deadweight_tonnage": 300,
"year_built": 2010,
"length_m": 30,
"width_m": 10
}
],
"pagination": {
"current_page": 1,
"per_page": 1,
"total": 1,
"last_page": 1
}
}
}This response provides essential details about the tugboat, including its IMO number, MMSI, name, flag, and physical characteristics. Such information is vital for fleet managers and logistics teams to track and manage their operations effectively.
2. Live Tracking
The GET /vessels/track endpoint provides live position data, including up to 168 hours of position history, active routes, predicted ETAs, and weather conditions. This is crucial for real-time decision-making in tugboat operations.
Example Request:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/track?mmsi=123456789&hours=48"Example Response:
{
"data": {
"vessel": {
"imo": "1234567",
"mmsi": "123456789",
"name": "Tugboat Alpha"
},
"current_position": {
"latitude": 34.0522,
"longitude": -118.2437,
"speed_knots": 5,
"course_degrees": 90,
"heading_degrees": 90,
"navigational_status": "Underway",
"timestamp_utc": "2023-10-01T12:00:00Z",
"destination": "Port B",
"eta": "2023-10-01T14:00:00Z"
},
"position_history": [...],
"route": {
"departure_port": "Port A",
"departure_time": "2023-10-01T10:00:00Z",
"destination_port": "Port B",
"eta": "2023-10-01T14:00:00Z",
"distance_nm": 20,
"avg_speed_knots": 5
},
"last_port_visits": [...]
}
}This response includes the current position of the tugboat, its speed, course, navigational status, and ETA. Fleet managers can use this data to optimize tugboat deployment and ensure timely arrivals at ports.
3. Nearby Vessels
The GET /vessels/nearby endpoint allows users to find all vessels within a specified radius of a given latitude and longitude. This is particularly useful for tugboat operators who need to coordinate with other vessels in the vicinity.
Example Request:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/nearby?latitude=34.0522&longitude=-118.2437&radius=30"Example Response:
{
"data": {
"center": {
"latitude": 34.0522,
"longitude": -118.2437
},
"radius_nm": 30,
"total": 5,
"vessels": [
{
"imo": "1234567",
"mmsi": "123456789",
"name": "Tugboat Alpha",
"ship_type": "Tug",
"position": {
"latitude": 34.0522,
"longitude": -118.2437,
"timestamp_utc": "2023-10-01T12:00:00Z"
},
"distance_nm": 0,
"speed_knots": 5,
"course_degrees": 90,
"navigational_status": "Underway"
},
...
]
}
}This response provides a list of nearby vessels, including their positions and navigational statuses. Tugboat operators can use this information to enhance situational awareness and improve coordination with other vessels.
4. Fleet Operations
The POST /vessels/fleet endpoint allows users to batch request positions, routes, and statistics for multiple vessels in one go. This is particularly beneficial for fleet managers overseeing multiple tugboats.
Example Request:
curl -X POST -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" -d '{"vessels":[{"imo":"1234567"},{"mmsi":"123456789"}],"include_positions":true,"include_routes":true}' "https://vessels-api.com/api/V1/vessels/fleet"Example Response:
{
"data": {
"fleet": {
"total_vessels": 2,
"vessels_at_sea": 1,
"vessels_in_port": 1
},
"vessels": [
{
"imo": "1234567",
"mmsi": "123456789",
"name": "Tugboat Alpha",
"position": {
"latitude": 34.0522,
"longitude": -118.2437
},
"route": {
"departure_port": "Port A",
"destination_port": "Port B"
}
},
...
]
}
}This response provides a comprehensive overview of the fleet's status, including the number of vessels at sea and in port. Fleet managers can leverage this data to make informed decisions about resource allocation and operational efficiency.
5. Port Congestion
The GET /ports/congestion endpoint provides real-time congestion snapshots and wait-time statistics for a specific port. This is essential for tugboat operators to plan their operations effectively.
Example Request:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/ports/congestion?port_id=ARBUE&period=7d"Example Response:
{
"data": {
"port_id": "ARBUE",
"port_name": "Port of Buenos Aires",
"period": "7d",
"snapshot": {
"vessels_in_anchorage": 10,
"vessels_at_berth": 5
},
"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": 50
}
}
}This response provides valuable insights into port congestion, helping tugboat operators anticipate delays and optimize their schedules accordingly.
6. Expected Arrivals
The GET /port/expected-arrivals endpoint lists vessels expected to arrive at a specific port, including their ETA and origin. This information is crucial for tugboat operators coordinating arrivals and departures.
Example Request:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/port/expected-arrivals?port=ARBUE"Example Response:
{
"data": {
"port_id": "ARBUE",
"port_name": "Port of Buenos Aires",
"expected_arrivals": [
{
"mmsi": "123456789",
"imo": "1234567",
"name": "Tugboat Alpha",
"vessel_type": "Tug",
"eta": "2023-10-01T14:00:00Z",
"departure_port": "Port A"
},
...
],
"total": 1
}
}This response provides a list of expected arrivals, allowing tugboat operators to prepare for incoming vessels and coordinate their operations effectively.
Conclusion
The Vessels API offers a powerful suite of tools for tracking tugboats and optimizing maritime operations. With endpoints designed for vessel search, live tracking, fleet operations, port intelligence, and more, developers can easily integrate real-time maritime data into their applications. By leveraging the Vessels API, businesses can enhance their operational efficiency, improve compliance, and make data-driven decisions.
Don't miss out on the opportunity to transform your maritime operations. Get started with Vessels API today and unlock the potential of real-time maritime data!
For more information, visit Vessels API and Try Vessels API for free.
