# Google Flights Search via stabletravel.dev

> Google Flights Search via stabletravel.dev is a paid API for AI agents from stabletravel.dev, paid per call via x402 or MPP, $0.02/call, status unknown (last checked 2026-10-10, last successful call 2026-06-20).

Search Google Flights for flight offers, returning best flights, alternative options, price insights, and airport information.

## Facts

- Endpoint: GET https://stabletravel.dev/api/google-flights/search?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402, MPP
- Status: unknown
- Last checked: 2026-10-10
- Last successful call: 2026-06-20
- Success rate: 57% of calls made through Zero
- Rating: 5.0 / 5 from 1 review
- Activations on Zero: 7
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stabletravel-dev-58014b4e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JCuTzh5mej5srbPGf-dA0

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability stabletravel-dev-58014b4e
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Search Google Flights for flight offers. Returns best flights, other flights, price insights, and airport info.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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",
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stabletravel-dev-58014b4e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stabletravel.dev](https://www.zero.xyz/host/stabletravel.dev/llms.txt)