Home → Blog

Introduction

In the fast-paced world of logistics, freight forwarders face numerous challenges when it comes to optimizing carrier selection and monitoring performance. With the increasing complexity of supply chains, the need for real-time data and insights has never been more critical. Traditional methods of gathering logistics intelligence often involve piecing together multiple data sources, leading to inefficiencies and potential inaccuracies. This is where FreightPulse comes into play, offering a comprehensive REST API that consolidates essential logistics data into a single, easy-to-use platform.

FreightPulse provides access to a wealth of information, including EIA fuel prices, live full-truckload (FTL) freight rate quotes, port congestion data, carrier lookups, and natural-disruption alerts. By leveraging this API, freight forwarders can streamline their operations, make informed decisions, and ultimately enhance their service offerings. In this blog post, we will explore the role of FreightPulse in optimizing carrier selection and performance monitoring, highlighting its key features, endpoints, and real-world applications.


Why FreightPulse

FreightPulse stands out in the logistics landscape for several reasons, each offering concrete benefits to developers and logistics 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 an 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
}
}
}
}
}

This response provides a comprehensive overview of current fuel prices, including regional breakdowns and historical averages, which can be invaluable for logistics planning.


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 Explanation: The response includes the national average prices for diesel and gasoline, changes over the week, and historical averages, which are essential for calculating fuel surcharges and budgeting.


2. GET /freight-rates

This endpoint provides live FTL truckload quotes for US lanes, allowing users to obtain pricing information based on specific parameters.

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: This response provides the mode of transport, service type, price, and estimated transit days, which are crucial for logistics planning and customer communication.


3. GET /port-congestion

This endpoint offers insights into port activity, helping users understand congestion levels at various ports based on historical data.

Key Parameters: port (name or LOCODE), country, region; optional congestion 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 indicates the congestion level at the port, recent and baseline port calls, and the ratio, which helps logistics teams assess potential delays in shipments.


Real-World Use Cases

FreightPulse's API capabilities can be leveraged in various practical applications:


FAQ

How often do FreightPulse fuel prices update?

Fuel prices are updated regularly, providing users with the most current data available. This ensures that logistics teams can make informed decisions based on the latest market conditions.

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

Yes, FreightPulse allows users to look up both ocean and trucking carriers. This comprehensive data access is essential for freight forwarders managing diverse shipping needs.

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

No, the port congestion data is based on historical averages 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

FreightPulse is revolutionizing the way freight forwarders and logistics operators access and utilize logistics intelligence. By consolidating critical data into a single API, it eliminates the complexities and inefficiencies associated with managing multiple data sources. With features like real-time freight rates, fuel prices, port congestion insights, and natural disruption alerts, FreightPulse empowers logistics teams to make informed decisions that enhance operational efficiency and customer satisfaction.

As the logistics landscape continues to evolve, leveraging tools like FreightPulse will be essential for staying competitive. Whether you are a developer building logistics applications or a logistics operator seeking to optimize your operations, FreightPulse offers the fastest path to integrating real-time logistics data into your workflows. Try FreightPulse for free today and experience the benefits of streamlined logistics intelligence.