Home → Blog

Introduction

In the fast-paced world of logistics, freight forwarders and supply chain operators face numerous challenges in managing shipments, tracking costs, and ensuring timely deliveries. With the increasing complexity of global supply chains, the need for real-time data has never been more critical. Traditional methods of tracking shipments and managing logistics often rely on disparate systems and outdated information, leading to inefficiencies and customer dissatisfaction.

Real-time freight tracking is essential for enhancing customer satisfaction and operational efficiency. By leveraging modern technology, logistics providers can gain access to consolidated data that informs decision-making and improves service delivery. This is where FreightPulse comes into play, offering a REST API that consolidates real-time logistics intelligence into a single, easy-to-use platform. In this blog post, we will explore how FreightPulse can help freight forwarders and logistics operators improve customer satisfaction through real-time freight tracking.

Why FreightPulse

FreightPulse stands out in the logistics technology landscape for several reasons:

Quick Start

Getting started with FreightPulse is straightforward. The base URL for the API is:

https://freightpulsehq.com/api/v1

To make your first request, you will need to include the X-API-Key header in your cURL command. Here’s an example of how to retrieve national diesel and gasoline prices:

curl -H "X-API-Key: YOUR_API_KEY" "https://freightpulsehq.com/api/v1/fuel-prices"

The expected JSON response will look like this:

{
"success": true,
"data": {
"timestamp": "2026-07-30T12:00:00Z",
"source": "EIA (U.S. Energy Information Administration)",
"currency": "USD",
"unit": "gallon",
"data": {
"diesel": {
"national_average": 3.847,
"change_week": -0.023,
"change_percent": -0.6,
"regions": {
"east_coast": 3.912,
"midwest": 3.756,
"gulf_coast": 3.623,
"rocky_mountain": 3.891,
"west_coast": 4.456,
"california": 4.892
},
"historical": {
"30d_avg": 3.82,
"90d_avg": 3.75,
"yoy_change_percent": -8.2
}
},
"gasoline": {
"national_average": 3.156,
"historical": {
"30d_avg": 3.1,
"90d_avg": 3.05,
"yoy_change_percent": 1.1
}
}
}
}
}

In this response, the key fields include:

Core Endpoints

1. GET /fuel-prices

This endpoint retrieves national diesel and gasoline prices along with a breakdown by PADD region. It provides insights into weekly changes and historical averages.

Key Parameters: None required.

curl -H "X-API-Key: YOUR_API_KEY" "https://freightpulsehq.com/api/v1/fuel-prices"

Example JSON Response:

{
"success": true,
"data": {
"timestamp": "2026-07-30T12:00:00Z",
"source": "EIA (U.S. Energy Information Administration)",
"currency": "USD",
"unit": "gallon",
"data": {
"diesel": {
"national_average": 3.847,
"change_week": -0.023,
"change_percent": -0.6,
"regions": {
"east_coast": 3.912,
"midwest": 3.756,
"gulf_coast": 3.623,
"rocky_mountain": 3.891,
"west_coast": 4.456,
"california": 4.892
},
"historical": {
"30d_avg": 3.82,
"90d_avg": 3.75,
"yoy_change_percent": -8.2
}
},
"gasoline": {
"national_average": 3.156,
"historical": {
"30d_avg": 3.1,
"90d_avg": 3.05,
"yoy_change_percent": 1.1
}
}
}
}
}

Field Explanations:

2. GET /freight-rates

This endpoint provides live FTL truckload quotes for US lanes, enabling logistics operators to quickly assess shipping costs.

Key Parameters: mode (trucking, ocean, air), origin_zip, destination_zip, pickup_date, qty, total_weight_lb, container_size (for ocean).

curl -H "X-API-Key: YOUR_API_KEY" "https://freightpulsehq.com/api/v1/freight-rates?mode=trucking&origin_zip=10001&destination_zip=90210"

Example JSON Response:

{
"success": true,
"data": {
"mode": "trucking",
"service": "FTL (53' dry van)",
"source": "Warp",
"price_usd": 7207.92,
"transit_days": 4,
"pickup_date": "2026-08-24",
"delivery_date": "2026-08-28"
}
}

Field Explanations:

3. GET /port-congestion

This endpoint provides insights into port activity, allowing users to assess congestion levels at major ports.

Key Parameters: port (name or LOCODE), country, region, congestion (optional filter).

curl -H "X-API-Key: YOUR_API_KEY" "https://freightpulsehq.com/api/v1/port-congestion?port=USLAX"

Example JSON Response:

{
"success": true,
"data": {
"results": [
{
"port": "Los Angeles-Long Beach",
"locode": "US LAX",
"country": "United States",
"congestion": "moderate",
"as_of": "2026-08-14",
"metrics": {
"recent_avg_portcalls_per_day": 8.7,
"baseline_avg_portcalls_per_day": 10.2,
"ratio_vs_baseline": 0.85
}
}
]
}
}

Field Explanations:

Real-World Use Cases

1. Fuel-Surcharge Calculator

Logistics teams can build a fuel-surcharge calculator that uses the /fuel-prices endpoint to retrieve current diesel prices. By integrating this data with their shipping rates, they can automatically calculate surcharges based on fluctuating fuel costs, ensuring accurate pricing for customers.

2. Port-Congestion Dashboard

A freight forwarder can create a port-congestion dashboard using the /port-congestion endpoint. This dashboard can display real-time congestion levels at major ports, allowing operators to make informed decisions about routing and scheduling shipments to avoid delays.

3. Carrier Vetting Tool

3PL providers can develop a carrier vetting tool that utilizes the /carriers endpoint to verify the status and safety ratings of trucking carriers. This tool can help logistics teams ensure they are partnering with reliable carriers, ultimately improving service quality and customer satisfaction.

FAQ

How often do FreightPulse fuel prices update?

FreightPulse fuel prices are updated weekly, providing users with the most current information to make informed decisions regarding shipping costs.

Can I look up ocean carriers as well as trucking carriers?

Yes, FreightPulse allows users to look up both ocean carriers and trucking carriers using the /carriers endpoint, making it a versatile tool for logistics operators.

Does the port congestion data reflect real-time vessel wait times?

No, the port congestion data from FreightPulse is based on a 7-day average and is not real-time. It provides a lagged approximation of port activity, which helps users understand congestion trends over time.

Conclusion

In today's logistics landscape, real-time data is essential for maintaining efficiency and customer satisfaction. FreightPulse offers a powerful solution for freight forwarders and logistics operators by consolidating critical logistics intelligence into a single API. With features like live freight rate quotes, fuel price updates, port congestion insights, and natural disruption alerts, FreightPulse empowers teams to make informed decisions and respond proactively to challenges.

By leveraging the capabilities of FreightPulse, logistics providers can enhance their operational efficiency, reduce costs, and ultimately improve customer satisfaction. If you're ready to take your logistics operations to the next level, try FreightPulse for free and discover the benefits of real-time freight tracking today.