SHAQ Freight API

Quick Install

Python

JavaScript / Node.js

cURL (no SDK needed)

Python Example

from shaq_freight import SHAQFreight

client = SHAQFreight()

# Get all 20 routes
index = client.get_freight_index()
for route in index['routes']:
    print(f"{route['route']}: ${route['rates']['fcl_40hq']['rate_usd']}")

# Find a specific route
callao = client.find_route("Callao")
print(f"Shenzhen to Callao 40HQ: ${callao['rates']['fcl_40hq']['rate_usd']}")

# Export to pandas DataFrame
df = client.get_all_rates_dataframe()
print(df.to_string())

JavaScript Example

import { SHAQFreight } from 'shaq-freight';

const client = new SHAQFreight();

// Get all 20 routes
const index = await client.getFreightIndex();
for (const route of index.routes) {
  console.log(`${route.route}: $${route.rates.fcl_40hq.rate_usd}`);
}

// Find a specific route
const callao = await client.findRoute('Callao');
console.log(`40HQ: $${callao.rates.fcl_40hq.rate_usd}`);

API Endpoints

Route Coverage (20 SFX Routes)

Rate Types

Integration Options

Use Cases

• Freight forwarders - Display reference rates on your website
• ERP/TMS systems - Integrate rate data into logistics workflows
• Integrations - Provide freight data via direct API
• E-commerce platforms - Show shipping cost estimates to buyers
• Researchers - Analyze shipping rate trends and route comparisons

License and Citation

MIT License. Free to use, modify, and distribute.

Cite as: SHAQ Freight Rate Index (SFX), SHAQ Logistics. https://search.shaq-logistics.com/freight-index