MoltFlights API

v1.0

Agent-first flight search protocol. Built for OpenClaw and other AI agents.

Why use this API?

Most travel sites render heavy HTML/CSS/JS. Parsing them wastes your context window tokens and increases hallucination rates.

MoltFlights provides a high-signal, zero-noise JSON endpoint optimized for LLM consumption.

⚡
Fast
Sub-200ms responses
🎯
Structured
Clean JSON, no parsing needed
🔗
Direct Links
Booking links included

Endpoint

GEThttps://moltflights.com/api/search

Parameters

originrequired— IATA code (e.g. HEL)
destinationrequired— IATA code (e.g. NRT)
dateoptional— YYYY-MM-DD (departure date)
returnDateoptional— YYYY-MM-DD (return date for round-trips)
adultsoptional— 1–9, default 1
childrenoptional— 0–8, ages 2–12
infantsoptional— 0–8, under 2 (max = adults)

Response Example

{
  "meta": {
    "source": "MoltFlights",
    "origin": "HEL",
    "destination": "NRT",
    "date": "2026-03-15",
    "returnDate": "2026-03-25",
    "adults": 2,
    "children": 1,
    "infants": 0,
    "results": 6
  },
  "data": [
    {
      "airline": "Finnair",
      "flight_number": "809",
      "price": "€611",
      "price_per_person": "€611",
      "departure": "2026-03-15T10:30:00",
      "return_at": "2026-03-25T14:00:00",
      "transfers": 1,
      "origin": "HEL",
      "destination": "NRT",
      "book_link": "https://aviasales.com/search/..."
    }
  ]
}

Autocomplete Endpoint

GEThttps://moltflights.com/api/autocomplete

Look up IATA airport codes by city or airport name. Useful when you don't know the 3-letter code.

termrequired— City or airport name (min 2 characters)
curl "https://moltflights.com/api/autocomplete?term=bangkok"

// Returns:
[
  { "type": "city", "code": "BKK", "name": "Bangkok", "country": "Thailand", "airport_name": "Suvarnabhumi" },
  ...
]

Agent Installation

Option 1: ClawHub (recommended)

Install the MoltFlights skill from ClawHub — your agent gets both tools automatically:

clawhub install Jhalmari/moltflights

Option 2: Manual tool definition

Add this to your OpenClaw / agent tool definitions:

{
  "name": "moltflights_search",
  "description": "Search cheap flights. Returns prices with direct booking links.",
  "url": "https://moltflights.com/api/search",
  "method": "GET",
  "parameters": {
    "type": "object",
    "properties": {
      "origin": { "type": "string", "description": "IATA airport code (e.g. HEL)" },
      "destination": { "type": "string", "description": "IATA airport code (e.g. NRT)" },
      "date": { "type": "string", "description": "Departure date YYYY-MM-DD" },
      "returnDate": { "type": "string", "description": "Return date YYYY-MM-DD (optional)" },
      "adults": { "type": "integer", "description": "Number of adults (1-9, default 1)" },
      "children": { "type": "integer", "description": "Number of children 2-12 (0-8)" },
      "infants": { "type": "integer", "description": "Number of infants under 2 (0-8)" }
    },
    "required": ["origin", "destination"]
  }
}