{"uid":"cap_JCuTzh5mej5srbPGf-dA0","slug":"stabletravel-dev-58014b4e","name":"Google Flights Search via stabletravel.dev","description":"Search Google Flights for flight offers. Returns best flights, other flights, price insights, and airport info.","url":"https://stabletravel.dev/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":{"type":"json","example":{"best_flights":[{"type":"Round trip","price":350,"flights":[{"airline":"American","duration":360,"travel_class":"Economy","flight_number":"AA 100","arrival_airport":{"id":"LAX","name":"Los Angeles International Airport","time":"2026-12-01 11:00"},"departure_airport":{"id":"JFK","name":"John F. Kennedy International Airport","time":"2026-12-01 08:00"}}],"total_duration":360}],"search_metadata":{"id":"search-123","status":"Success","created_at":"2026-04-22 12:00:00 UTC","google_flights_url":"https://www.google.com/travel/flights"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"1.00","successRate":"0.57","reviews":1,"stars":"5.0","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/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"},{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_sN3Jk0ozFJ12tcxeVJWA1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_qkvCPb3WpF57mfODt6_HV","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x20c000000000000000000000b9537d11c60e8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search 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 for 2 adults departing June 15 and returning June 22, in USD — show me the best options and price insights.","exampleUseCases":null,"resultDescription":"Returns a structured response including best flight options, other available flights, price insights (e.g. whether now is a good time to buy), and relevant airport information. Flights include carrier, duration, stops, and pricing details.","failureModes":["Missing required parameters (departure_id, arrival_id, outbound_date) returns a 400 error","Invalid IATA airport code returns no results or an error","Return date missing for round trip type causes a validation error","Date format not matching YYYY-MM-DD pattern causes a parse error","No flights found for the requested route and date returns empty results","Invalid currency code may default or error","Payment failure (x402) returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need to search and compare live Google Flights data for a specific route and date, including price insights and airport context. Prefer this over hotel or ground transport endpoints when the user's core need is finding and comparing air travel options.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":7,"lastUsedAt":"2026-06-20T23:42:46.388Z","lastSuccessfullyRanAt":"2026-06-20T23:42:46.388Z","lastHealthCheckAt":"2026-10-10T18:44:43.636Z","isFirstParty":false,"canonicalSlug":"stabletravel-dev-58014b4e"}