Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt

Use this file to discover all available pages before exploring further.

$0.1 / 1k flights Search Google Flights for one-way, round-trip, and multi-city flights, including prices, stops, airlines, and passenger counts

Endpoint

POST /api/v1/agents/google/flights/run

Parameters

departure
array
required
List · Departure airport codes (e.g. LAX, JFK). One per line.
arrival
array
required
List · Arrival airport codes (e.g. JFK, SFO). One per line.
outboundDate
date
required
Date picker · Date of departure flight.
returnDate
date
Date picker · Date of return flight. Leave blank for one-way.
adults
integer
default:1
Number · Number of adult passengers.
children
integer
default:0
Number · Number of children (ages 2-11).
infants
integer
default:0
Number · Number of infants (under 2).
currency
string
default:"USD"
Dropdown · Currency for prices.View all 32 options →
country
string
default:"us"
Dropdown · Country to search Google Flights from.View all 37 options →
language
string
default:"en"
Dropdown · Language for results.
en, es, fr, de, it, pt, nl, sv, tr, ru, pl, el, he, ar, hi, zh, ja, ko, th, vi, id, msLegend: en = English, es = Spanish, fr = French, de = German, it = Italian, pt = Portuguese, nl = Dutch, sv = Swedish, tr = Turkish, ru = Russian, pl = Polish, el = Greek, he = Hebrew, ar = Arabic, hi = Hindi, zh = Chinese, ja = Japanese, ko = Korean, th = Thai, vi = Vietnamese, id = Indonesian, ms = MalayView all 22 as a structured list →
maxPrice
integer
Number · Cap results below this price (in selected currency).
maxStops
string
Dropdown · Maximum number of stops. Leave blank for any.Options: 0, 1, 2Legend: 0 = Direct only, 1 = Up to 1 stop, 2 = Up to 2 stops
airlines
array
List · Airline IATA codes (e.g. UA, AA, DL). One per line.
excludeBasic
boolean
default:false
Toggle · Filter out Basic Economy fares (no carry-on, no seat selection).

Response columns

FieldDisplay nameType
originOrigintext
destinationDestinationtext
outboundDateOutbound Datedate
returnDateReturn Datedate
tierTiertext
tripTypeTrip Typetext
priceUsdPrice (USD)number
durationMinDuration (min)number
stopsStopsnumber
airlineAirlinetext
airlineLogoAirline Logourl
airplaneAirplanetext
travelClassTravel Classtext
flightNumberFlight Numbertext
legroomLegroomtext
departureAirportDeparture Airporttext
departureTimeDeparture Timetext
arrivalAirportArrival Airporttext
arrivalTimeArrival Timetext
carbonKgCarbon (kg)number
carbonVsTypicalCarbon vs Typicalpercentage
extensionsExtensionsarray
allFlightsAll Flightsarray

Example

curl -X POST https://api.mindcase.co/api/v1/agents/google/flights/run \
  -H "Authorization: Bearer mk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "departure": [
      "LAX"
    ],
    "arrival": [
      "JFK"
    ],
    "outboundDate": "2026-06-15",
    "returnDate": "2026-06-22",
    "currency": "USD",
    "language": "en",
    "country": "us",
    "adults": 1,
    "maxPages": 5,
    "output_file": "google_flights_results.json"
  }
}'

Example response

Response
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "origin": "LAX",
      "destination": "JFK",
      "outboundDate": "2026-06-15",
      "returnDate": "2026-06-22",
      "tier": "Best",
      "tripType": "Round trip",
      "priceUsd": 512,
      "durationMin": 337,
      "stops": 0,
      "airline": "JetBlue",
      "airlineLogo": "https://www.gstatic.com/flights/airline_logos/70px/B6.png",
      "airplane": "Airbus A320",
      "travelClass": "Economy",
      "flightNumber": "B6 824",
      "legroom": "33 in",
      "departureAirport": "LAX",
      "departureTime": "2026-06-15 16:20",
      "arrivalAirport": "JFK",
      "arrivalTime": "2026-06-16 00:57",
      "carbonKg": 409000,
      "carbonVsTypical": 20,
      "extensions": [
        "Checked baggage for a fee",
        "Bag and fare conditions depend on the return flight"
      ],
      "allFlights": [
        {
          "departure_airport": {
            "name": "Los Angeles International Airport",
            "id": "LAX",
            "time": "2026-06-15 16:20"
          },
          "arrival_airport": {
            "name": "John F. Kennedy International Airport",
            "id": "JFK",
            "time": "2026-06-16 00:57"
          },
          "duration": 337,
          "airplane": "Airbus A320",
          "airline": "JetBlue",
          "airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/B6.png",
          "travel_class": "Economy",
          "flight_number": "B6 824",
          "legroom": "33 in",
          "extensions": [
            "Above average legroom (33 in)",
            "Free Wi-Fi",
            "In-seat power & USB outlets",
            "Live TV",
            "Carbon emissions estimate: 409 kg"
          ]
        }
      ]
    }
  ]
}