{"uid":"cap_2va6TcIptwzLRYV-MqOww","slug":"google-flights-search-via-stable-travel-593af602","name":"Google Flights Search via Stable Travel","description":"Search Google Flights for flight offers. Returns best flights, other flights, price insights, and airport info.","url":"https://stable-travel-git-migrate-stabletravel-router-140-merit-systems.vercel.app/api/google-flights/search","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["departure_id","arrival_id","outbound_date","type","adults","children","infants_in_seat","infants_on_lap","currency","hl"],"properties":{"gl":{"type":"string","description":"Country code for localization"},"hl":{"type":"string","default":"en","description":"Language code"},"type":{"enum":["1","2","3"],"type":"string","default":"1","description":"1 = Round trip, 2 = One way, 3 = Multi-city"},"stops":{"enum":["0","1","2","3"],"type":"string","description":"0 = Any, 1 = Nonstop only, 2 = Up to 1 stop, 3 = Up to 2 stops"},"adults":{"type":"integer","default":1,"maximum":9,"minimum":1},"children":{"type":"integer","default":0,"maximum":9,"minimum":0},"currency":{"type":"string","default":"USD","maxLength":3,"minLength":3,"description":"Currency code"},"max_price":{"type":"integer","maximum":9007199254740991,"description":"Max price in local currency","exclusiveMinimum":0},"arrival_id":{"type":"string","description":"Arrival airport code (IATA), city, or kgmid. Comma-separated for multi-city."},"return_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Return date (required for round trip)"},"departure_id":{"type":"string","description":"Departure airport code (IATA), city, or kgmid. Comma-separated for multi-city."},"travel_class":{"enum":["1","2","3","4"],"type":"string","description":"1 = Economy, 2 = Premium economy, 3 = Business, 4 = First"},"outbound_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Departure date"},"infants_on_lap":{"type":"integer","default":0,"maximum":9,"minimum":0},"infants_in_seat":{"type":"integer","default":0,"maximum":9,"minimum":0},"exclude_airlines":{"type":"string","description":"Comma-separated airline codes to exclude"},"include_airlines":{"type":"string","description":"Comma-separated airline codes to include"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"airports":{"type":"array","items":{"type":"object","properties":{"arrival":{"type":"array","items":{"type":"object","properties":{"city":{"type":"string"},"image":{"type":"string"},"airport":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"time":{"type":"string"}},"additionalProperties":false},"country":{"type":"string"},"thumbnail":{"type":"string"},"country_code":{"type":"string"}},"additionalProperties":false}},"departure":{"type":"array","items":{"type":"object","properties":{"city":{"type":"string"},"image":{"type":"string"},"airport":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"time":{"type":"string"}},"additionalProperties":false},"country":{"type":"string"},"thumbnail":{"type":"string"},"country_code":{"type":"string"}},"additionalProperties":false}}},"additionalProperties":false}},"best_flights":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"price":{"type":"number"},"flights":{"type":"array","items":{"type":"object","properties":{"airline":{"type":"string"},"legroom":{"type":"string"},"airplane":{"type":"string"},"duration":{"type":"number"},"overnight":{"type":"boolean"},"extensions":{"type":"array","items":{"type":"string"}},"airline_logo":{"type":"string"},"travel_class":{"type":"string"},"flight_number":{"type":"string"},"arrival_airport":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"time":{"type":"string"}},"additionalProperties":false},"departure_airport":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"time":{"type":"string"}},"additionalProperties":false},"often_delayed_by_over_30_min":{"type":"boolean"}},"additionalProperties":false}},"layovers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"duration":{"type":"number"},"overnight":{"type":"boolean"}},"additionalProperties":false}},"extensions":{"type":"array","items":{"type":"string"}},"airline_logo":{"type":"string"},"total_duration":{"type":"number"},"departure_token":{"type":"string"},"carbon_emissions":{"type":"object","properties":{"this_flight":{"type":"number"},"difference_percent":{"type":"number"},"typical_for_this_route":{"type":"number"}},"additionalProperties":false}},"additionalProperties":false}},"other_flights":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"price":{"type":"number"},"flights":{"type":"array","items":{"type":"object","properties":{"airline":{"type":"string"},"legroom":{"type":"string"},"airplane":{"type":"string"},"duration":{"type":"number"},"overnight":{"type":"boolean"},"extensions":{"type":"array","items":{"type":"string"}},"airline_logo":{"type":"string"},"travel_class":{"type":"string"},"flight_number":{"type":"string"},"arrival_airport":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"time":{"type":"string"}},"additionalProperties":false},"departure_airport":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"time":{"type":"string"}},"additionalProperties":false},"often_delayed_by_over_30_min":{"type":"boolean"}},"additionalProperties":false}},"layovers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"duration":{"type":"number"},"overnight":{"type":"boolean"}},"additionalProperties":false}},"extensions":{"type":"array","items":{"type":"string"}},"airline_logo":{"type":"string"},"total_duration":{"type":"number"},"departure_token":{"type":"string"},"carbon_emissions":{"type":"object","properties":{"this_flight":{"type":"number"},"difference_percent":{"type":"number"},"typical_for_this_route":{"type":"number"}},"additionalProperties":false}},"additionalProperties":false}},"price_insights":{"type":"object","properties":{"price_level":{"type":"string"},"lowest_price":{"type":"number"},"price_history":{"type":"array","items":{"type":"array","items":{"type":"number"}}},"typical_price_range":{"type":"array","items":{"type":"number"}}},"additionalProperties":false},"search_metadata":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"},"created_at":{"type":"string"},"processed_at":{"type":"string"},"json_endpoint":{"type":"string"},"total_time_taken":{"type":"number"},"google_flights_url":{"type":"string"}},"additionalProperties":false},"search_parameters":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.020000","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":6,"rating":{"score":"0.50","successRate":"0.91","reviews":6,"stars":"3.0","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.020000/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_i9agm1a7cybIG8I9F4JAN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches Google Flights for flight offers, returning best flights, alternative options, price insights, and airport information.","exampleAgentPrompt":"Search Google Flights for a round-trip economy flight from JFK to LHR, departing June 15 and returning June 22, for 2 adults in USD — nonstop only if possible.","exampleUseCases":[{"title":"Find cheap nonstop business flights","prompt":"Search Google Flights for a one-way business class flight from San Francisco to Tokyo, departing August 3rd for 1 adult — nonstop preferred, and let me know if prices are currently low or high for that route."},{"title":"Compare weekend getaway flight prices","prompt":"Look up round-trip flights from Chicago to Miami for a weekend trip — leaving Friday October 10th and coming back Sunday October 12th, just 1 adult in economy, and show me both the best options and any cheaper alternatives Google finds."},{"title":"Plan multi-passenger family vacation","prompt":"Find round-trip economy flights from Los Angeles to Cancun for 2 adults and 2 children, departing December 20th and returning January 3rd — show me the best priced options and let me know if these holiday fares are typical or higher than usual."}],"resultDescription":"Returns best flights and other available flights with pricing, schedules, and airline details, along with price insights (whether prices are low/typical/high for the route) and relevant airport information.","failureModes":["Missing required query parameters (departure_id, arrival_id, outbound_date) returns 400 error","Invalid IATA airport code returns no results or error","return_date not provided for round-trip (type=1) causes error","Invalid date format (not YYYY-MM-DD) returns validation error","Upstream Google Flights data unavailable returns 5xx error","Payment of 0.02 USDC not provided returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need real-time Google Flights data including price insights and best/alternative flight breakdowns. Prefer this over generic travel APIs when you want Google's flight ranking and price comparison signals. Ideal for agents building travel planning workflows that need structured flight search results with pricing context.","instructions":null,"reviewSummary":"This Google Flights search capability delivers highly structured, detailed fare data — including airline, aircraft, flight number, price history, and carbon emissions — when the upstream SerpAPI quota is healthy, with clean schema design that parses reliably across routes and date ranges. However, reliability is sharply split: roughly half of reviewed calls failed due to exhausted SerpAPI search credits or empty upstream responses, resulting in paid calls (0.02 USDC each) that return no usable data. Strong when the API quota is available, but unpredictable otherwise.","reviewSummaryHighlights":["Returns rich structured flight details: airline, aircraft type, flight number, price level, and carbon emissions","Consistent response schema across diverse international routes — easy to parse programmatically","Clearly surfaces empty or no-result states when no matching flights exist"],"reviewSummaryConcerns":["~50% of reviewed calls failed due to upstream SerpAPI quota exhaustion or 402 errors, with fees still charged","No apparent fallback or quota-check mechanism — failures are only discovered at call time"],"reviewSummaryGeneratedAt":"2026-08-27T00:15:17.302Z","activationCount":57,"lastUsedAt":"2026-08-26T23:23:36.656Z","lastSuccessfullyRanAt":"2026-07-21T03:31:23.696Z","lastHealthCheckAt":"2026-09-14T11:43:51.251Z","isFirstParty":false}