Home → Blog

Introduction

In the fast-paced world of logistics and supply chain management, timely and accurate data is crucial for making informed decisions. Market analysts, logistics operators, and freight forwarders often face the challenge of piecing together information from multiple sources, which can lead to inefficiencies and missed opportunities. With the increasing complexity of global supply chains, the need for a consolidated solution that provides real-time logistics intelligence has never been more pressing.

This is where FreightPulse comes into play. By offering a single REST API that consolidates various data points—such as EIA fuel prices, live full-truckload (FTL) freight rate quotes, port congestion data, carrier lookups, and natural-disruption alerts—FreightPulse empowers market analysts and logistics professionals to make data-driven decisions quickly and effectively. In this blog post, we will explore how FreightPulse can streamline your operations and enhance your decision-making capabilities.

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

This endpoint is essential for market analysts who need to monitor fuel price trends and make informed decisions regarding fuel surcharges and budgeting.

2. GET /freight-rates

This endpoint provides live FTL truckload quotes for US lanes, allowing users to obtain real-time pricing information.

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

This endpoint is particularly useful for freight forwarders and logistics operators who need to quickly assess shipping costs and transit times for their clients.

3. GET /port-congestion

This endpoint provides data on port activity, including congestion levels based on IMF PortWatch data.

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

This endpoint is crucial for logistics teams that need to monitor port congestion and adjust their shipping schedules accordingly. It’s important to note that the congestion figures are approximations based on a 7-day average and a 90-day baseline, rather than real-time AIS tracking.

Real-World Use Cases

FreightPulse's API 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 for making 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, making it a versatile tool for logistics professionals.

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 a 90-day baseline, which means it is not real-time. Users should consider this when planning shipments and scheduling deliveries.

Conclusion

In an industry where data-driven decision-making is paramount, FreightPulse offers a powerful solution for logistics professionals. By consolidating various data points into a single REST API, FreightPulse eliminates the need for multiple integrations and provides real-time insights that can significantly enhance operational efficiency.

Whether you are a market analyst, logistics operator, or freight forwarder, leveraging the FreightPulse API can streamline your processes and empower you to make informed decisions quickly. Don’t miss out on the opportunity to transform your logistics operations—Try FreightPulse for free today and experience the benefits of consolidated logistics intelligence.