Stored in your browser only. Required only for the TripWeaver — the Travel Budget Estimator is free and works without a key.

What would you like to do?

Two AI-powered tools for your next trip.

TripWeaver

Personalised itinerary based on your mood, climate and pace.

Start planning

Travel Budget Estimator

Free, no API key — estimate trip cost with full breakdown and per-person totals.

Calculate budget
API Documentation

TripWeaver

Home

Generating your trip plan…

Home New query
Your match

Location

Suggestions
    Daily plan

    Travel Budget Estimator

    Home

    Fill the form and press Calculate to see your estimate.

    Classifying flight & calculating…

    Estimated total
    — USD
    — USD per person
    Breakdown
    Daily costs (—) — USD
    Flight (—) — USD
    Insurance (—) — USD
    Service fee (—) — USD
    Total — USD

    API Documentation

    Home
    Quickstart

    Two independent surfaces:

    • TripWeaver (/evaluate) — requires the X-API-Key header, consumes 1 quota unit per call.
    • Travel Budget Estimator (/calculate-budget) — fully public. No API key, no quota, no external calls.

    Full interactive docs: Swagger UI · ReDoc

    POST/evaluate 1 unit
    TripWeaver

    Generate a JSON itinerary tailored to mood, climate, activity, budget, region. Requires X-API-Key; consumes 1 quota unit per call. Powered by OpenAI.

    POST/calculate-budget free · public 0 units
    Travel Budget Estimator

    Compute total + breakdown + per-person cost. No X-API-Key required, no quota consumed, no OpenAI calls. The flight_category is resolved locally from origin / destination using offline geographic data.

    How classification works. Inputs are mapped to ISO-3166 alpha-2 country codes using two pure-Python libraries bundled with the service:

    • pycountry — country names, ISO codes and common aliases (USA, UK, Czechia, …).
    • geonamescache — ~25k cities (population > 15k) → ISO country code, plus continent codes used for the Europe check.

    Decision: same country → domestic; two different countries both with continent EU → europe; anything else (or unrecognized input) → international. You can pass flight_category explicitly to skip the lookup; the cost is zero either way.

    Reference
    • POST /evaluate — Trip Planner (X-API-Key required, 1 unit)
    • POST /calculate-budget — Travel Budget Estimator (free, public, no auth)
    • GET /questions — Trip Planner form schema (no auth)
    • GET /trip-cities?q=&limit= — autocomplete suggestions for the TripWeaver Preferred region field (no auth)
    • GET /budget-questions — Budget Estimator form schema (no auth)
    • GET /budget-cities?q=&limit= — autocomplete suggestions for the Estimator Origin / Destination fields (no auth)
    • GET /budget-constants — pricing constants (no auth)
    • GET /usage — remaining quota for X-API-Key
    • GET /health — service health