Flight Search
2 creditsSearch and filter one-way, round-trip, and multi-city itineraries.
/api/v1/tools/google-flights/searchParameters
Departure airport IATA code for one-way or round-trip searches.
Arrival airport IATA code for one-way or round-trip searches.
Departure date for one-way or round-trip searches, in YYYY-MM-DD format.
Return date in YYYY-MM-DD format. Supplying it infers a round trip unless tripType is set.
"one-way", "round-trip", or "multi-city". Inferred from returnDate for a single route.
Two to five chronological { origin, destination, departureDate } legs. Required when tripType is "multi-city"; replaces the top-level route fields.
"economy", "premium-economy", "business", or "first". Defaults to "economy".
Currency used for returned prices. Defaults to "USD". Supported values: ALL, DZD, ARS, AMD, AWG, AUD, AZN, BSD, BHD, BYN, BMD, BAM, BRL, GBP, CAD, XPF, CLP, CNY, COP, CRC, CUP, CZK, DKK, DOP, EGP, EUR, GEL, HKD, HUF, ISK, INR, IDR, IRR, ILS, JMD, JPY, JOD, KZT, KWD, LBP, MKD, MYR, MXN, MDL, MAD, TWD, NZD, NGN, NOK, OMR, PKR, PAB, PEN, PHP, PLN, QAR, RON, RUB, SAR, RSD, SGD, ZAR, KRW, SEK, CHF, THB, TRY, UAH, AED, USD, VND.
Number of adults (1-9). Defaults to 1; total passengers cannot exceed 9.
Number of children (0-9). Defaults to 0.
Number of lap infants (0-9). Defaults to 0; each lap infant requires an adult.
Number of infants in seats (0-9). Defaults to 0.
Maximum stops: 0 (nonstop), 1, or 2.
Maximum total itinerary price as a positive whole amount in the requested currency.
Maximum duration of each flight leg in minutes.
Up to 20 airline IATA codes or ONEWORLD, STAR_ALLIANCE, and SKYTEAM.
Earliest local departure time (0-23 or HH:MM).
Latest local departure time (0-23 or HH:MM). A bound earlier than the earliest time selects an overnight range.
Earliest local arrival time (0-23 or HH:MM).
Latest local arrival time (0-23 or HH:MM). A bound earlier than the earliest time selects an overnight range.
"best", "cheapest", "fastest", "departure-time", or "arrival-time". Defaults to "best". For round-trip and multi-city results, departure-time and arrival-time sort the varying final-leg alternatives.
Request a broader set of flight choices. Defaults to false.
Add provider choices, booking handoffs, and baggage-policy links per itinerary. Defaults to false; a failed lookup returns an upstream error instead of a partial response.
Fields to include per result. Omit or pass ["*"] for all.
Response Schema
Google Flights search result
Matching itineraries
Number of filtered itineraries in the response
Request metadata
Tool name (google-flights-search)
Credits consumed (2)
Unique request ID
Request
curl -X POST https://scraper.run/api/v1/tools/google-flights/search \-H "Authorization: Bearer sc_live_..." \-H "Content-Type: application/json" \-d '{"origin": "SFO","destination": "NRT","departureDate": "2026-10-01","returnDate": "2026-10-15","currency": "EUR","showAllResults": true,"includeBookingDetails": true}'
Response Example
{"data": {"results": [{"origin": "SFO","destination": "LAX","departureDate": "2026-09-17","returnDate": null,"tripType": "one-way","cabinClass": "economy","price": 23,"currency": "USD","pricePerPassenger": null,"totalDuration": 96,"stops": 0,"airlines": ["Frontier"],"airlineCodes": ["F9"],"outbound": {"duration": 96,"stops": 0,"segments": [{"airline": "Frontier","airlineCode": "F9","flightNumber": "F92858","aircraft": "Airbus A320neo","departureAirport": "SFO","arrivalAirport": "LAX","departureTime": "2026-09-17T12:07:00-07:00","arrivalTime": "2026-09-17T13:43:00-07:00","duration": 96,"layover": null}]},"return": null,"co2Emissions": 59599,"co2EmissionsLabel": null,"fareClass": null,"bookingDetails": null}],"count": 1},"meta": {"tool": "google-flights-search","creditsUsed": 2,"requestId": "req_abc123"}}