Home → Blog

Introduction

In today's fast-paced global economy, freight forwarders and logistics operators face a myriad of challenges when it comes to navigating complex trade regulations and ensuring compliance. With the ever-changing landscape of international trade, staying updated on fuel prices, freight rates, port congestion, and natural disruptions is crucial for maintaining operational efficiency and cost-effectiveness. However, the traditional methods of gathering this information often involve piecing together multiple data sources, leading to inefficiencies and increased operational costs.

This is where FreightPulse comes into play. By offering a comprehensive REST API that consolidates real-time logistics intelligence, FreightPulse empowers freight forwarders and logistics operators to streamline their operations and make informed decisions. In this blog post, we will explore how FreightPulse can help you navigate global trade regulations effectively, ensuring compliance and enhancing your logistics operations.


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 retrieves national diesel and gasoline prices along with a breakdown by PADD regions.

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 Explanation: The response provides a comprehensive overview of current fuel prices, including changes over the past week and historical averages, which are essential for calculating fuel surcharges and budgeting logistics costs.


2. GET /freight-rates

This endpoint provides live FTL truckload quotes for US lanes, allowing logistics operators to compare rates quickly.

Key Parameters: mode (trucking, ocean, air), origin_zip, destination_zip (required for trucking).

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 Explanation: The response includes the mode of transport, service type, price in USD, estimated transit days, and pickup/delivery dates, which are critical for planning and budgeting shipments.


3. GET /port-congestion

This endpoint provides insights into port activity, helping logistics operators understand congestion levels at major ports.

Key Parameters: port (name or LOCODE), country (name or ISO3), region (continent); congestion (low|moderate|high) optional filter.

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 Explanation: The response provides the port name, congestion level, and metrics comparing recent port calls to a baseline, which is crucial for assessing potential delays in shipments.


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 and historical averages. This tool can help shippers calculate additional charges 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 to monitor congestion levels at key ports. This dashboard can provide real-time insights into port activity, allowing operators to adjust shipping schedules proactively and avoid delays.

3. Carrier Vetting Tool

3PL providers can develop a carrier vetting tool that leverages the /carriers endpoint to verify the status and safety ratings of trucking and ocean carriers. This tool can help logistics operators ensure compliance with regulations and select reliable partners for their shipments.


FAQ

How often do FreightPulse fuel prices update?

FreightPulse fuel prices are updated weekly, providing logistics operators with the most current data to make informed decisions regarding fuel surcharges and budgeting.

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

Yes, FreightPulse allows users to look up both ocean carriers and trucking carriers through the /carriers endpoint, enabling comprehensive carrier vetting.

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. It serves as an approximation of port activity compared to a 90-day baseline.


Conclusion

In conclusion, navigating global trade regulations and ensuring compliance is a complex challenge for freight forwarders and logistics operators. However, with the powerful capabilities of FreightPulse, teams can streamline their operations and access critical logistics intelligence from a single API. By leveraging real-time data on fuel prices, freight rates, port congestion, and natural disruptions, logistics operators can make informed decisions that enhance efficiency and reduce costs.

Don't let scattered data sources hinder your logistics operations. Try FreightPulse for free today and experience the benefits of consolidated logistics intelligence for your supply chain.