Home → Blog

Introduction

In today's fast-paced logistics environment, sustainability is no longer just a buzzword; it's a necessity. As supply chains become more complex, the need for real-time data to drive eco-friendly decisions has never been more critical. Companies are increasingly looking for ways to reduce their carbon footprint while maintaining efficiency and profitability. 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 developers, logistics operators, and supply chain teams with access to vital data such as EIA fuel prices, live full-truckload (FTL) freight rate quotes, port congestion data, carrier lookups, and natural-disruption alerts. By leveraging this data, organizations can make informed decisions that not only enhance operational efficiency but also contribute to sustainability initiatives. In this blog post, we will explore how FreightPulse can help drive eco-friendly supply chains and provide practical insights into its API capabilities.


Why FreightPulse

FreightPulse stands out in the logistics data landscape for several reasons, each offering concrete benefits to developers and 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 the X-API-Key header in your cURL command. Here’s an example of how to fetch 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 sustainability initiatives. Below, we will cover three key endpoints: fuel prices, freight rates, and port congestion.

1. GET /fuel-prices

This endpoint provides 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"

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 U.S. lanes, enabling logistics teams to optimize their 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 data on port activity, helping logistics operators understand congestion levels at key ports.

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"

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

FreightPulse's API capabilities can be leveraged in various ways to enhance sustainability initiatives. Here are three concrete examples:


FAQ

How often do FreightPulse fuel prices update?

Fuel prices are updated weekly, providing logistics operators with timely information to make informed decisions regarding fuel surcharges and route 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 operations.

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

In conclusion, FreightPulse is a powerful tool for organizations looking to enhance their sustainability initiatives within the logistics sector. By providing a unified API that consolidates critical data such as fuel prices, freight rates, port congestion, and carrier information, FreightPulse enables developers and logistics operators to make informed decisions that positively impact both their bottom line and the environment.

As the demand for eco-friendly supply chains continues to grow, leveraging real-time data becomes essential. With FreightPulse, you can streamline your logistics operations and contribute to a more sustainable future. Try FreightPulse for free today and discover how you can transform your supply chain with actionable insights.