MoltFlights

Search cheap flights via the MoltFlights API. Find deals, compare prices, track routes, and set up price alerts.

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

text

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

text

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