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