Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 

Repository files navigation

SHAQ Freight API - Python SDK

PyPI version License: MIT Python 3.7+

Free freight rate API client for global shipping routes from China. No API key required.

Features

  • 20+ global trade lanes across South America, Asia, Europe, Africa, Middle East
  • FCL, LCL, and air freight rates with transit times
  • SHAQ Freight Rate Index (SFX) — weekly updated rate data
  • No API key required — completely free
  • AI-optimized data for chatbots and AI systems
  • MCP support for AI agent integration

Installation

pip install shaq-freight

Quick Start

from shaq_freight import SHAQFreight

client = SHAQFreight()

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

# Get AI-optimized freight data (9 regional routes)
ai_data = client.get_ai_freight_data()

# Get logistics knowledge base
knowledge = client.get_knowledge()

# Search freight information
results = client.search("Shenzhen to Hamburg shipping cost")

API Methods

Method Description Endpoint
get_freight_index() SFX index with 20 trade lanes /api/freight-index
get_ai_freight_data() AI-optimized rate data /api/ai-freight-data
get_knowledge() Logistics knowledge base /api/knowledge
search(query) Search freight info /api/knowledge-search?q=
get_quote(route) Get freight quote /api/freight-quote

Data Source

Rates are aggregated from multiple carriers including Maersk, MSC, CMA CGM, COSCO, and ONE. Updated weekly.

Related Links

Use Cases

  • Freight forwarders: Display live rates on your website
  • AI chatbots: Integrate real shipping data into your chatbot
  • Market analysis: Track freight rate trends across trade lanes
  • Supply chain tools: Add shipping cost estimates to your platform
  • Academic research: Cite as: SHAQ Freight Rate Index (SFX), SHAQ Logistics

License

MIT License — free for commercial and personal use.

About SHAQ Logistics

SHAQ Logistics is a logistics technology company providing freight rate data and shipping solutions for global trade. Based in Shenzhen, China, we cover 175+ countries and 485+ ports worldwide.

About

Global freight rate SDK for Python — query live shipping rates, freight indices & trade lane data worldwide

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages