hasdata-flights

hasdata Google Flights API

Real-time flight search via Google Flights.

When to use

• User wants flight prices for specific dates and routes
• They want to compare airlines, stops, or travel classes
• They want to filter by max price, max duration, layover length, or emissions
• They want round-trip, one-way, or multi-city itineraries

API in this group

Command	Purpose	Cost
google-flights	Search Google Flights with full filter support	15

Quick start

# One-way SFO → JFK on a specific date
hasdata google-flights \
  --departure-id "SFO" --arrival-id "JFK" \
  --outbound-date "2026-06-15" \
  --type "oneWay" \
  --pretty -o .hasdata/sfo-jfk.json

# Round-trip with return
hasdata google-flights \
  --departure-id "JFK" --arrival-id "LHR" \
  --outbound-date "2026-07-10" --return-date "2026-07-20" \
  --type "roundTrip" \
  --adults 2 \
  --pretty -o .hasdata/jfk-lhr-rt.json

# Non-stop, max $800, sorted by price
hasdata google-flights \
  --departure-id "LAX" --arrival-id "NRT" \
  --outbound-date "2026-09-05" --return-date "2026-09-15" \
  --stops "0" --max-price 800 --sort-by "price" \
  --pretty -o .hasdata/lax-nrt-nonstop.json

# Business class, prefer fewer emissions
hasdata google-flights \
  --departure-id "JFK" --arrival-id "CDG" \
  --outbound-date "2026-08-01" --return-date "2026-08-08" \
  --travel-class "Business" --less-emissions \
  --pretty -o .hasdata/jfk-cdg-biz.json

# Specific airlines only
hasdata google-flights \
  --departure-id "SEA" --arrival-id "HND" \
  --outbound-date "2026-10-01" \
  --include-airlines "DL,JL" \
  --pretty -o .hasdata/sea-hnd-dljl.json

Common flags

Flag	Purpose
--departure-id <code>	IATA airport code or location kgmid (e.g., SFO, /m/0d6lp)
--arrival-id <code>	IATA airport code or location kgmid
--outbound-date YYYY-MM-DD	Outbound date (required)
--return-date YYYY-MM-DD	Return date (required for roundTrip)
--type	oneWay, roundTrip, multiCity
--adults <n>	Adult passengers
--children / --bags / --infants-in-seat / --infants-on-lap	Party composition
--travel-class	Economy, Premium Economy, Business, First
--stops	Restrict stops (0 = nonstop, 1, 2)
--currency <code>	Result currency (default USD)
--max-price <n>	Max price (in selected currency)
--max-duration <minutes>	Max total flight duration
--layover-duration "min,max"	Layover range in minutes (e.g. 45,180)
--include-airlines <codes>	Comma-separated IATA airline codes (e.g., UA,DL)
--exclude-airlines <codes>	Exclude airlines
--include-connections <codes>	Allowed connection airports
--exclude-connections <codes>	Forbidden connection airports
--outbound-times "from,to"	Departure window (hours, e.g., 6,20)
--return-times "from,to"	Return-leg time window
--less-emissions	Prefer flights with lower CO₂
--sort-by	price, departureTime, arrivalTime, duration, emissions
--deep-search	Slower but matches what google.com/flights shows
--show-hidden	Include hidden / cheaper-when-booked-as-pieces fares
--departure-token <token>	Select a specific outbound to get matching returns
--booking-token <token>	Get final booking options for a selected itinerary
--multi-city-json <json>	Multi-city JSON (array of leg objects with departureId, arrivalId, date)

Tips

• Round-trip selection is two-step: the first call returns outbound options each with a departureToken. To get matching return flights, call again with --departure-token "<token>". To finalize and see booking options, call with --booking-token.
• --deep-search reproduces what you see in a browser at google.com/flights but takes longer. Use only when initial results seem incomplete.
• For price tracking (e.g. monitor a route over weeks), schedule the same query and jq the cheapest result:

  jq '.bestFlights | min_by(.price)' .hasdata/route.json
  

• Carbon-aware travel: combine --less-emissions --sort-by emissions for the lowest-CO₂ options.

Working with results

# All flights → airline, price, duration, stops
jq -r '.bestFlights[] | "\(.airlines[0])\t$\(.price)\t\(.totalDuration)min\t\(.layovers | length) stops"' .hasdata/flights.json

# Cheapest non-stop
jq '[.bestFlights[] | select((.layovers | length) == 0)] | min_by(.price)' .hasdata/flights.json

# Sort by emissions
jq '.bestFlights | sort_by(.carbonEmissions.thisFlight)' .hasdata/flights.json

See also

• hasdata-search — google-events for non-flight travel events
• hasdata-realestate — airbnb-listing for accommodation