Home → Blog

Introduction

In the fast-paced world of logistics and supply chain management, market analysts and operators face a myriad of challenges. From fluctuating fuel prices to unpredictable port congestion, the need for real-time data has never been more critical. Traditional methods of gathering this information often involve stitching together multiple data sources, leading to inefficiencies and increased costs. This is where FreightPulse comes into play, offering a comprehensive REST API that consolidates essential logistics intelligence into a single, easy-to-use platform.

FreightPulse provides access to a wealth of data, including EIA fuel prices, live full-truckload (FTL) freight rate quotes, port congestion data, carrier lookups, and natural disruption alerts. By leveraging this API, developers and logistics operators can create custom dashboards that provide actionable insights, streamline operations, and ultimately enhance decision-making processes. In this blog post, we will explore how FreightPulse can be tailored to meet the specific needs of market analysts through innovative dashboard solutions.


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

FreightPulse offers several core endpoints that are particularly relevant for market analysts. Below, we will cover three key endpoints in detail:

1. GET /fuel-prices

This endpoint retrieves national diesel and gasoline prices, along with a breakdown by PADD region.

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 U.S. lanes, allowing users to compare rates across different modes of transport.

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 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 (optional filter).

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

FreightPulse's API can be leveraged in various ways to create innovative solutions for logistics challenges. Here are three concrete examples:


FAQ

How often do FreightPulse fuel prices update?

Fuel prices are updated weekly, providing users with timely information to make informed decisions regarding shipping costs and budgeting.

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

Yes, FreightPulse 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, FreightPulse offers a powerful solution for market analysts and logistics operators seeking to harness real-time logistics intelligence. By consolidating critical data into a single API, FreightPulse eliminates the complexities associated with managing multiple data sources. Whether you are building a custom dashboard for fuel pricing, port congestion, or carrier vetting, FreightPulse provides the tools necessary to enhance operational efficiency and decision-making.

Ready to transform your logistics operations? Try FreightPulse for free today and discover how our API can streamline your data integration and empower your business with actionable insights.