Home → Blog

Introduction

In today's fast-paced logistics environment, real-time visibility into supply chain operations is not just a luxury; it's a necessity. Logistics operators face numerous challenges, from fluctuating fuel prices to unpredictable port congestion and natural disruptions. These factors can significantly impact operational efficiency and cost management. Without access to consolidated, real-time data, logistics teams often find themselves piecing together information from multiple sources, leading to inefficiencies and increased operational costs.

This is where FreightPulse comes into play. FreightPulse is a powerful REST API that consolidates critical logistics intelligence into a single, easy-to-use interface. By leveraging FreightPulse, logistics operators can gain predictive insights that enhance decision-making and streamline operations. In this blog post, we will explore how FreightPulse can transform your logistics operations by providing real-time data on fuel prices, freight rates, port congestion, carrier information, and natural disruption alerts—all from one API.

Why FreightPulse

FreightPulse stands out in the logistics data 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 provides national diesel and gasoline prices, along with a breakdown by PADD region and historical averages.

Key Parameters: None required.

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

Sample 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, origin_zip, destination_zip.

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

Sample 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 data on port activity, allowing logistics operators to assess congestion levels at major ports.

Key Parameters: port, country, region.

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

Sample 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

FreightPulse can be leveraged in various ways to enhance logistics operations:

FAQ

How often do FreightPulse fuel prices update?

FreightPulse fuel prices are updated weekly, providing users with the most current data available. This frequency allows logistics operators to make timely decisions based on the latest market conditions.

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

Yes, FreightPulse supports lookups for both ocean carriers and trucking carriers through the /carriers endpoint. This feature allows logistics operators to verify the status and safety ratings of various carriers across different modes of transportation.

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

No, the port congestion data provided by FreightPulse is based on a 7-day average and is not real-time. The data is approximated from IMF PortWatch AIS data and reflects congestion levels compared to a 90-day baseline.

Conclusion

In an industry where every second counts, having access to real-time logistics intelligence is crucial for success. FreightPulse offers a comprehensive solution that consolidates essential data into a single API, enabling logistics operators to make informed decisions quickly and efficiently. By leveraging FreightPulse, teams can enhance their operational capabilities, reduce costs, and improve service levels.

Don't let fragmented data sources hold your logistics operations back. Try FreightPulse for free today and unlock the power of real-time supply chain monitoring. Experience firsthand how predictive insights can transform your logistics operations and drive your business forward.