Introduction
In the fast-paced world of logistics, 3PL (third-party logistics) providers face numerous challenges in managing supply chains efficiently. With the increasing complexity of global trade, the need for real-time data has never been more critical. Traditional methods of gathering logistics intelligence often involve piecing together multiple data sources, leading to inefficiencies and potential errors. 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 real-time insights into various aspects of logistics, including fuel prices, freight rates, port congestion, carrier information, and natural disruption alerts. By leveraging this API, 3PL providers can streamline their operations, reduce costs, and enhance decision-making processes. In this blog post, we will explore the key features of FreightPulse, how to get started, and real-world applications that demonstrate its value for logistics professionals.
Why FreightPulse
FreightPulse stands out in the logistics data landscape for several reasons:
- Unified Data Source: Instead of relying on multiple integrations for different data types, FreightPulse consolidates everything into one API. This eliminates the need for stitching together disparate feeds, saving developers time and reducing the risk of errors.
- Real-Time Insights: With live freight rate quotes and up-to-date fuel prices, 3PL providers can make informed decisions quickly. This is particularly beneficial for calculating fuel surcharges and optimizing routes based on current market conditions.
- Comprehensive Coverage: FreightPulse offers a wide range of data, including FMCSA carrier lookups and natural disruption alerts. This allows logistics operators to vet carriers effectively and stay informed about potential disruptions that could impact shipments.
- Ease of Use: The API is designed with developers in mind, featuring a straightforward authentication process and clear response structures. This means teams can integrate FreightPulse into their systems with minimal friction.
Quick Start
Getting started with FreightPulse is simple. 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:
- timestamp: The date and time when the data was retrieved.
- source: The source of the data, in this case, the EIA.
- currency: The currency in which prices are quoted.
- data: Contains detailed information about diesel and gasoline prices, including national averages and regional breakdowns.
Core Endpoints
1. GET /fuel-prices
This endpoint provides national diesel and gasoline prices along with a breakdown by PADD region.
- Key Params: None required.
- cURL Example:
curl -H "X-API-Key: YOUR_API_KEY" "https://freightpulsehq.com/api/v1/fuel-prices"
{
"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 endpoint is crucial for logistics operators who need to calculate fuel surcharges accurately and monitor fuel price trends over time.
2. GET /freight-rates
This endpoint provides live FTL truckload quotes for US lanes, allowing logistics providers to obtain current pricing information.
- Key Params: mode (trucking, ocean, air), origin_zip, destination_zip (required for trucking).
- cURL Example:
curl -H "X-API-Key: YOUR_API_KEY" "https://freightpulsehq.com/api/v1/freight-rates?mode=trucking&origin_zip=10001&destination_zip=90210"
{
"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"
}
}
Key fields in this response include:
- mode: The mode of transportation (e.g., trucking).
- service: The type of service provided (e.g., FTL).
- price_usd: The quoted price for the shipment.
- transit_days: Estimated number of days for transit.
- pickup_date: The date when the shipment will be picked up.
- delivery_date: The expected delivery date.
This endpoint is essential for 3PL providers to provide accurate quotes to their customers and optimize their pricing strategies.
3. GET /port-congestion
This endpoint provides insights into port activity, helping logistics operators understand congestion levels at major ports.
- Key Params: port (name or LOCODE), country, region; congestion (optional).
- cURL Example:
curl -H "X-API-Key: YOUR_API_KEY" "https://freightpulsehq.com/api/v1/port-congestion?port=USLAX"
{
"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
}
}
]
}
}
Key fields include:
- port: The name of the port.
- congestion: The current congestion level (e.g., low, moderate, high).
- metrics: Contains metrics such as recent average port calls per day and baseline averages.
This endpoint is particularly useful for freight forwarders who need to assess port conditions and plan shipments accordingly.
Real-World Use Cases
1. Fuel-Surcharge Calculator
3PL providers can build a fuel-surcharge calculator that uses the /fuel-prices endpoint to retrieve current diesel prices. By integrating this data with shipment details, they can automatically calculate fuel surcharges based on real-time fuel costs.
2. Port-Congestion Dashboard
A freight forwarder can create a port-congestion dashboard using the /port-congestion endpoint. This dashboard can display real-time congestion levels at various ports, helping operators make informed decisions about routing and scheduling shipments.
3. Carrier Vetting Tool
Using the /carriers endpoint, logistics teams can develop a carrier vetting tool that allows them to verify the status and safety ratings of trucking carriers. This ensures that they are partnering with reliable carriers, reducing the risk of delays and compliance issues.
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 budgeting.
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 using the /carriers endpoint, making it a versatile tool for logistics professionals.
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 vessel wait times.
Conclusion
In conclusion, FreightPulse offers a powerful solution for 3PL providers looking to streamline their operations and enhance their logistics intelligence. By consolidating multiple data sources into a single API, FreightPulse eliminates the complexities associated with managing disparate feeds. With real-time insights into fuel prices, freight rates, port congestion, and carrier information, logistics teams can make informed decisions that drive efficiency and reduce costs.
Whether you are a developer building logistics applications or a logistics operator seeking to optimize your supply chain, FreightPulse provides the tools you need to succeed. Start leveraging the power of real-time logistics intelligence today and Try FreightPulse for free to see how it can transform your operations.