sorted-travel

Official Python SDK and CLI for the Sorted Travel REST API.

This is a stdlib-only client for the public endpoints at https://sorted.travel. Destination ranking, facts, weather, and visa tools are a free tier with zero-auth access. An API key is optional.

• Homepage: https://sorted.travel
• Developer portal: https://sorted.travel/developers
• SDK guide: https://sorted.travel/sdks.md
• OpenAPI: https://sorted.travel/openapi.json
• MCP: https://sorted.travel/mcp
• PyPI: https://pypi.org/project/sorted-travel/

Install

pip install sorted-travel

Quickstart

from sorted_travel import Client

client = Client()
print(client.status())
page = client.list_destinations(limit=20)
print(page["data"][0]["handle"], page["has_more"])

Destination tools need no key. If a host still requires one:

client = Client(api_key="st_sandbox_...")  # or set SORTED_TRAVEL_API_KEY

Self-serve sandbox keys:

payload = client.create_api_key()

CLI

sorted-travel status
sorted-travel destinations --limit 5
sorted-travel sandbox
sorted-travel api-key

Configuration

Surface

• status() — GET /api/v1/status
• list_destinations(cursor=, limit=) — GET /api/v1/destinations
• create_api_key() — POST /api/v1/api-keys
• sandbox() — GET /sandbox
• create_job(operation, **body) — POST /api/v1/jobs
• get_job(job_id) — GET /api/v1/jobs/{job_id}
• get(path, params=) / post(path, body=) — raw REST escape hatch

Interactive ranking, weather, and visa still go through MCP at https://sorted.travel/mcp. This package does not wrap JSON-RPC.

License

MIT. The Sorted Travel product remains under its own terms at https://sorted.travel/terms.