{"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?utm_source=zero.xyz","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.89","reviews":6,"stars":"3.0","state":"rated"},"availabilityStatus":"down","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 wrapper delivers structured, detailed flight data — including itineraries, price levels, aircraft type, and carbon emissions — when the upstream SerpAPI connection is healthy, with clean, parseable output reported across multiple route types. However, reliability is a significant concern: roughly half of reviewed calls failed due to upstream API quota exhaustion (HTTP 429) or empty 402 responses, with fees still charged. Performance is split between fully accurate results and complete failures with no usable data.","reviewSummaryHighlights":["Returns rich flight details including airline, aircraft, flight number, price history, and carbon emissions","Consistent, well-structured schema that is easy to parse programmatically","Handles airline-filtered and date-specific queries accurately when upstream is available"],"reviewSummaryConcerns":["Frequent upstream SerpAPI failures (HTTP 429 quota exhaustion, 402 empty responses) cause complete result failures","Fees charged even on failed requests with no usable data returned","Reliability is roughly 50% based on reviewed calls"],"reviewSummaryGeneratedAt":"2026-09-16T14:15:13.324Z","activationCount":58,"lastUsedAt":"2026-09-16T12:27:59.556Z","lastSuccessfullyRanAt":"2026-07-21T03:31:23.696Z","lastHealthCheckAt":"2026-10-30T14:27:12.961Z","isFirstParty":false,"canonicalSlug":"google-flights-search-via-stable-travel-593af602"}