Home → Blog

Introduction

In the fast-paced world of logistics and supply chain management, the ability to access real-time data is crucial for making informed decisions. As businesses strive to optimize their operations, they often face the challenge of integrating multiple data sources to gain a comprehensive view of their logistics landscape. This can lead to inefficiencies, increased costs, and missed opportunities. The need for a streamlined solution that consolidates various logistics intelligence into a single platform has never been more pressing.

FreightPulse addresses this challenge by offering a powerful REST API that consolidates essential logistics data, including EIA fuel prices, live full-truckload (FTL) freight rate quotes, port congestion data, carrier lookups, and natural-disruption alerts. By replacing the need for multiple integrations and expensive paid feeds, FreightPulse empowers developers, logistics operators, and supply chain teams to enhance their fulfillment strategies and drive growth in their e-commerce operations.

Why FreightPulse

FreightPulse stands out in the crowded logistics data landscape for several compelling 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 in the header. 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, key fields include:

Core Endpoints

1. GET /fuel-prices

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

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 (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 Explanations:

3. GET /port-congestion

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

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

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

1. Fuel-Surcharge Calculator

Logistics companies can build a fuel-surcharge calculator that uses the /fuel-prices endpoint to dynamically adjust shipping costs based on current fuel prices. By integrating real-time fuel data, businesses can ensure their pricing remains competitive and reflective of market conditions.

2. Port-Congestion Dashboard

A freight forwarder can create a port-congestion dashboard using the /port-congestion endpoint to visualize congestion levels at key ports. This tool can help operators make informed decisions about routing and scheduling, ultimately improving delivery times and customer satisfaction.

3. Carrier Vetting Tool

3PL providers can develop a carrier vetting tool that leverages the /carriers endpoint to verify the safety ratings and operational status of trucking carriers. This ensures that only reliable carriers are selected for shipments, reducing the risk of delays and compliance issues.

FAQ

How often do FreightPulse fuel prices update?

Fuel prices are updated weekly, providing users with timely insights into market fluctuations. This allows logistics operators to adjust their pricing strategies accordingly.

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, providing comprehensive carrier information for various modes of transportation.

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 helps users understand congestion trends over time.

Conclusion

In an increasingly complex logistics landscape, having access to real-time data is essential for optimizing supply chain operations. FreightPulse offers a powerful solution that consolidates critical logistics intelligence into a single API, enabling developers and logistics operators to enhance their fulfillment strategies effectively.

By leveraging FreightPulse, businesses can streamline their operations, reduce costs, and improve decision-making processes. Whether you are building a fuel-surcharge calculator, a port-congestion dashboard, or a carrier vetting tool, FreightPulse provides the data you need to succeed.

Ready to transform your logistics operations? Try FreightPulse for free and unlock the potential of real-time logistics intelligence today!