moltflights

# MoltFlights — Flight Search Skill Search cheap flights using the [MoltFlights API](https://moltflights.com/agents). Returns structured JSON with real-time prices and direct booking links. No API key required. No authentication. Just call the endpoint. --- ## Tools ### `moltflights_search` — Search Flights ``` GET https://moltflights.com/api/search?origin=HEL&destination=BKK&date=2026-03-15 ``` | Parameter | Required | Type | Description | |---------------|----------|---------|--------------------------------------| | `origin` | yes | string | IATA airport code (e.g. `HEL`) | | `destination` | yes | string | IATA airport code (e.g. `NRT`) | | `date` | no | string | Departure date `YYYY-MM-DD` | | `returnDate` | no | string | Return date `YYYY-MM-DD` (round-trip)| | `adults` | no | integer | Number of adults, 1–9 (default: 1) | | `children` | no | integer | Children ages 2–12, 0–8 (default: 0) | | `infants` | no | integer | Infants under 2, 0–8 (default: 0) | If `date` is omitted, the API returns the cheapest flights for the upcoming month. ### `moltflights_autocomplete` — Look Up Airport Codes ``` GET https://moltflights.com/api/autocomplete?term=bangkok ``` | Parameter | Required | Type | Description | |-----------|----------|--------|------------------------------------------| | `term` | yes | string | City or airport name (min 2 characters) | --- ## Example: Search Flights ```bash curl "https://moltflights.com/api/search?origin=HEL&destination=BKK&date=2026-03-15" ``` ### Response ```json { "meta": { "source": "MoltFlights", "origin": "HEL", "destination": "BKK", "date": "2026-03-15", "adults": 1, "children": 0, "infants": 0, "results": 12 }, "data": [ { "airline": "Finnair", "flight_number": "809", "price": "€432", "price_per_person": "€432", "departure": "2026-03-15T10:30:00", "return_at": "", "transfers": 1, "origin": "HEL", "destination": "BKK", "book_link": "https://www.aviasales.com/search/..." } ] } ``` Each result includes a `book_link` — a direct booking URL the user can open. --- ## Example: Round-Trip with Passengers ```bash curl "https://moltflights.com/api/search?origin=JFK&destination=CDG&date=2026-06-01&returnDate=2026-06-15&adults=2&children=1" ``` The `price` field shows the **total** for all seat-occupying passengers. `price_per_person` shows the per-person price. --- ## Common Use Cases ### 1. Find the cheapest flight to a destination Search without a specific date to get the cheapest options for the whole month: ```bash curl "https://moltflights.com/api/search?origin=LHR&destination=TYO" ``` ### 2. Compare prices across dates Run multiple searches for different dates and compare: ```bash for date in 2026-04-01 2026-04-08 2026-04-15; do echo "=== $date ===" curl -s "https://moltflights.com/api/search?origin=HEL&destination=BKK&date=$date" | head -20 done ``` ### 3. Price monitoring / alerts (cron job) Check a route daily and alert when price drops below a threshold: ```bash # Run daily via cron: 0 8 * * * /path/to/check-price.sh PRICE=$(curl -s "https://moltflights.com/api/search?origin=HEL&destination=BKK&date=2026-05-01" \ | grep -o '"price":"€[0-9]*"' | head -1 | grep -o '[0-9]*') if [ "$PRICE" -lt 400 ]; then echo "Deal found: HEL→BKK for €$PRICE" fi ``` ### 4. Multi-city search Search several routes and pick the cheapest: ```bash for dest in BKK TYO BCN LIS; do echo "=== HEL → $dest ===" curl -s "https://moltflights.com/api/search?origin=HEL&destination=$dest" \ | grep -o '"price":"€[0-9]*"' | head -1 done ``` --- ## Common IATA Codes | Code | City | Code | City | |------|-----------------|------|---------------| | HEL | Helsinki | LHR | London | | JFK | New York | CDG | Paris | | NRT | Tokyo Narita | BKK | Bangkok | | BCN | Barcelona | FCO | Rome | | SIN | Singapore | DXB | Dubai | | LAX | Los Angeles | SFO | San Francisco | | BER | Berlin | AMS | Amsterdam | | IST | Istanbul | LIS | Lisbon | Don't know the code? Use the `moltflights_autocomplete` tool: ```bash curl "https://moltflights.com/api/autocomplete?term=bangkok" ``` --- ## Error Handling - **400** — Missing `origin` or `destination` parameter - **Empty `data` array** — No flights found for this route/date. Try a different date or omit the date for flexible search. --- ## Tips - Prices are in EUR (€) - Results are sorted: exact date matches first, then nearby dates by price - Omitting `date` gives you the cheapest flights across the whole upcoming month - The API is free and requires no authentication - Responses are cached for 5 minutes