Home → Blog

Introduction

In today's fast-paced logistics environment, supply chain professionals face numerous challenges, from fluctuating fuel prices to unpredictable port congestion. These issues can lead to increased operational costs, delayed shipments, and ultimately, dissatisfied customers. As logistics operators, freight forwarders, and supply chain teams strive to optimize their operations, they require access to real-time data that can inform their decision-making processes. This is where API-driven solutions come into play, offering a streamlined approach to accessing critical logistics intelligence.

FreightPulse provides a comprehensive REST API that consolidates essential logistics data into a single, easy-to-use interface. By replacing scattered integrations and expensive paid feeds, FreightPulse empowers developers and logistics operators to access real-time information on fuel prices, freight rates, port congestion, carrier data, and natural disruptions—all from one API. In this blog post, we will explore the innovative capabilities of FreightPulse and how leading third-party logistics (3PL) providers are leveraging this technology to enhance their operations.

Why FreightPulse

FreightPulse stands out in the logistics API landscape for several reasons, each offering concrete benefits to developers and operators:

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
}
}
}
}
}

This response provides a wealth of information, including the national average fuel prices, weekly changes, and regional breakdowns, all of which can be leveraged for better decision-making in logistics operations.

Core Endpoints

1. GET /fuel-prices

This endpoint retrieves national diesel and gasoline prices, along with a breakdown by PADD regions 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 Explanation: The response includes the national average prices for diesel and gasoline, changes over the week, and historical averages, which are crucial for calculating fuel surcharges and budgeting.

2. GET /freight-rates

This endpoint provides live FTL truckload quotes for US lanes, enabling logistics operators to obtain accurate pricing for their shipments.

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 provides the mode of transport, service type, price in USD, estimated transit days, and pickup/delivery dates, allowing operators to plan their logistics effectively.

3. GET /port-congestion

This endpoint offers insights into port activity, providing a 7-day average of port calls compared to a 90-day baseline.

Key Parameters: port (name or LOCODE), country (name or ISO3), region (continent).

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 includes the port name, congestion level, and metrics comparing recent port calls to historical averages. This data is vital for managing shipment schedules and anticipating delays.

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 shipment details, they can calculate accurate surcharges based on fluctuating fuel costs.

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 tool helps them make informed decisions about routing and scheduling, ultimately improving service levels for their clients.

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 ensures compliance and reduces the risk of partnering with unreliable carriers.

FAQ

How often do FreightPulse fuel prices update?

Fuel prices are updated weekly, providing logistics operators with timely information to make informed decisions regarding fuel surcharges and budgeting.

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

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

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

No, the port congestion data is based on a 7-day average and is not real-time. It provides a lagged approximation of port activity, which is essential for planning but should not be relied upon for immediate vessel tracking.

Conclusion

In an increasingly complex logistics landscape, having access to real-time data is crucial for optimizing supply chain operations. FreightPulse offers a powerful API that consolidates essential logistics intelligence into a single platform, enabling developers and logistics operators to make informed decisions quickly and efficiently. By leveraging FreightPulse, teams can reduce operational costs, enhance service levels, and ultimately drive greater customer satisfaction.

Ready to transform your logistics operations? Try FreightPulse for free and discover how our API can streamline your access to critical logistics data.