Home → Blog

Introduction

In the fast-paced world of logistics, freight forwarders and supply chain operators face numerous challenges when it comes to negotiating freight rates. The complexity of real-time data, fluctuating fuel prices, and port congestion can make it difficult to make informed decisions. Without access to consolidated, real-time logistics intelligence, teams often find themselves relying on outdated information or piecing together data from multiple sources, which can lead to inefficiencies and increased costs.

This is where FreightPulse comes into play. By providing a single REST API that consolidates critical logistics data, FreightPulse empowers freight forwarders and logistics operators to engage in data-driven discussions, optimize their negotiations, and ultimately enhance their operational efficiency. In this blog post, we will explore how FreightPulse supports these objectives and provide a comprehensive guide to getting started with the API.

Why FreightPulse

FreightPulse stands out in the logistics data landscape for several reasons:

Quick Start

To get started with the FreightPulse API, you will need to familiarize yourself with the base URL and the authentication method. The base URL for the API is:

https://freightpulsehq.com/api/v1

For authentication, you will need to include the X-API-Key header in your requests. Here’s an example of how to make your first request 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. It is essential for understanding fuel costs, which directly impact freight rates.

Key Parameters: None required.

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

Example 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, which is crucial for freight forwarders looking to negotiate rates effectively.

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"

Example 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, which is essential for understanding potential delays in shipments due to congestion.

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"

Example 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 teams can build a fuel-surcharge calculator that dynamically adjusts based on real-time fuel prices. By utilizing the /fuel-prices endpoint, teams can ensure that their surcharge calculations reflect the most current data, allowing for more accurate pricing and improved customer satisfaction.

2. Port-Congestion Dashboard

A freight forwarder can create a port-congestion dashboard using the /port-congestion endpoint. This dashboard can provide real-time insights into congestion levels at key ports, enabling operators to make informed decisions about routing and scheduling to avoid delays.

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 tool can help ensure compliance and enhance the reliability of the carriers they work with.

FAQ

How often do FreightPulse fuel prices update?

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

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 operators.

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 useful for trend analysis but should not be relied upon for immediate operational decisions.

Conclusion

In conclusion, optimizing freight rate negotiation is crucial for logistics operators and freight forwarders looking to enhance their operational efficiency and reduce costs. By leveraging the comprehensive data provided by FreightPulse, teams can engage in data-driven discussions that lead to better decision-making and improved outcomes.

With a single API that consolidates real-time logistics intelligence, FreightPulse eliminates the need for scattered integrations and expensive paid feeds. Whether you are looking to calculate fuel surcharges, monitor port congestion, or vet carriers, FreightPulse provides the tools you need to succeed in today's competitive logistics landscape.

Ready to take your logistics operations to the next level? Try FreightPulse for free and discover how our API can transform your approach to freight rate negotiation and logistics management.