moltflights

MoltFlights — Flight Search Skill

Search cheap flights using the MoltFlights API. 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

curl "https://moltflights.com/api/search?origin=HEL&destination=BKK&date=2026-03-15"

Response

{
  "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

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:

curl "https://moltflights.com/api/search?origin=LHR&destination=TYO"

2. Compare prices across dates

Run multiple searches for different dates and compare:

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:

# 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:

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:

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