# Google API: Get cheapest flight dates in a month

> Finds the lowest Google Flights fare for each departure date in a month between two places, for one-way trips or a fixed trip length, with the cheapest option and any price insight shown.

Unofficial. Not affiliated with or endorsed by Google.

- Page: https://fous.com/methods/google.com/get-cheapest-dates
- Method: `google.com/get_cheapest_dates`, version 1
- Website: google.com
- Returns: dates with lowest prices and links, cheapest option, price insight, Google Flights link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `cabin` | string | no |  | Travel cabin, such as business. One of "economy", "premium_economy", "business", "first". Default "economy". |
| `month` | string | yes | `"2026-11"` | Departure month in YYYY-MM, such as 2026-11. |
| `adults` | integer | no |  | Number of adults, such as 2. Default 1. |
| `origin` | string | yes | `"New York"` | Departure city or airport, such as New York or JFK. |
| `currency` | string | no |  | Three-letter currency code, such as USD. Default "USD". |
| `destination` | string | yes | `"London"` | Arrival city or airport, such as London or BCN. |
| `trip_length_days` | integer | no | `7` | Days between departure and return, such as 7. Omit for one-way. |

## Output

From a run on Oct 31, 2026, shortened. Its input:

```json
{
  "month": "2026-11",
  "origin": "New York",
  "destination": "London",
  "trip_length_days": 7
}
```

Its output:

```json
{
  "dates": [
    {
      "currency": "USD",
      "return_date": "2026-11-08",
      "lowest_price": 645,
      "departure_date": "2026-11-01",
      "google_flights_link": "https://www.google.com/travel/flights/search?tfs=CBwQAhopEgoyMDI2LTExLTAxag0IAxIJL20vMDJfMjg2cgwIAxIIL20vMDRqcGwaKRIKMjAyNi0xMS0wOGoMCAMSCC9tLzA0anBscg0IAxIJL20vMDJfMjg2QAFIAXABggELCP___________wGYAQE&hl=en&curr=USD"
    },
    {
      "currency": "USD",
      "return_date": "2026-11-09",
      "lowest_price": 687,
      "departure_date": "2026-11-02",
      "google_flights_link": "https://www.google.com/travel/flights/search?tfs=CBwQAhopEgoyMDI2LTExLTAyag0IAxIJL20vMDJfMjg2cgwIAxIIL20vMDRqcGwaKRIKMjAyNi0xMS0wOWoMCAMSCC9tLzA0anBscg0IAxIJL20vMDJfMjg2QAFIAXABggELCP___________wGYAQE&hl=en&curr=USD"
    },
    {
      "currency": "USD",
      "return_date": "2026-11-10",
      "lowest_price": 476,
      "departure_date": "2026-11-03",
      "google_flights_link": "https://www.google.com/travel/flights/search?tfs=CBwQAhopEgoyMDI2LTExLTAzag0IAxIJL20vMDJfMjg2cgwIAxIIL20vMDRqcGwaKRIKMjAyNi0xMS0xMGoMCAMSCC9tLzA0anBscg0IAxIJL20vMDJfMjg2QAFIAXABggELCP___________wGYAQE&hl=en&curr=USD"
    }
  ],
  "price_insight": "Prices are currently typical",
  "cheapest_option": {
    "currency": "USD",
    "return_date": "2026-11-12",
    "lowest_price": 428,
    "departure_date": "2026-11-05",
    "google_flights_link": "https://www.google.com/travel/flights/search?tfs=CBwQAhopEgoyMDI2LTExLTA1ag0IAxIJL20vMDJfMjg2cgwIAxIIL20vMDRqcGwaKRIKMjAyNi0xMS0xMmoMCAMSCC9tLzA0anBscg0IAxIJL20vMDJfMjg2QAFIAXABggELCP___________wGYAQE&hl=en&curr=USD"
  },
  "google_flights_link": "https://www.google.com/travel/flights/search?tfs=CBwQAhopEgoyMDI2LTExLTA1ag0IAxIJL20vMDJfMjg2cgwIAxIIL20vMDRqcGwaKRIKMjAyNi0xMS0xMmoMCAMSCC9tLzA0anBscg0IAxIJL20vMDJfMjg2QAFIAXABggELCP___________wGYAQE&hl=en&curr=USD"
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"google.com/get_cheapest_dates","input":{"month":"2026-11","origin":"New York","destination":"London","trip_length_days":7}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What's the cheapest day to fly one-way from Chicago to Denver in March 2026?
- Show me the lowest Google Flights fares for each departure date in October 2026 from SFO to Tokyo, round trip for 10 days, 2 adults.
- I want to fly business class from London to Dubai sometime in December 2026 for a one-week trip — which departure dates are cheapest? Prices in GBP please.
- Find the cheapest dates in July 2026 for a one-way flight from Toronto to Mexico City, and tell me if prices are currently low or high.
- Using Google, check day-by-day fares from Sydney to Bali for a 5-day trip departing in May 2026, premium economy, in AUD.

## Input schema

```json
{
  "type": "object",
  "required": [
    "origin",
    "destination",
    "month"
  ],
  "properties": {
    "cabin": {
      "enum": [
        "economy",
        "premium_economy",
        "business",
        "first"
      ],
      "type": "string",
      "default": "economy",
      "description": "Travel cabin, such as business."
    },
    "month": {
      "type": "string",
      "description": "Departure month in YYYY-MM, such as 2026-11."
    },
    "adults": {
      "type": "integer",
      "default": 1,
      "maximum": 9,
      "minimum": 1,
      "description": "Number of adults, such as 2."
    },
    "origin": {
      "type": "string",
      "description": "Departure city or airport, such as New York or JFK."
    },
    "currency": {
      "type": "string",
      "default": "USD",
      "description": "Three-letter currency code, such as USD."
    },
    "destination": {
      "type": "string",
      "description": "Arrival city or airport, such as London or BCN."
    },
    "trip_length_days": {
      "type": "integer",
      "minimum": 1,
      "description": "Days between departure and return, such as 7. Omit for one-way."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "dates",
    "cheapest_option",
    "price_insight",
    "google_flights_link"
  ],
  "properties": {
    "dates": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "departure_date",
          "return_date",
          "lowest_price",
          "currency",
          "google_flights_link"
        ],
        "properties": {
          "currency": {
            "type": "string"
          },
          "return_date": {
            "type": [
              "string",
              "null"
            ],
            "format": "date"
          },
          "lowest_price": {
            "type": "number"
          },
          "departure_date": {
            "type": "string",
            "format": "date"
          },
          "google_flights_link": {
            "type": "string"
          }
        }
      }
    },
    "price_insight": {
      "type": [
        "string",
        "null"
      ]
    },
    "cheapest_option": {
      "type": [
        "object",
        "null"
      ],
      "required": [
        "departure_date",
        "return_date",
        "lowest_price",
        "currency",
        "google_flights_link"
      ],
      "properties": {
        "currency": {
          "type": "string"
        },
        "return_date": {
          "type": [
            "string",
            "null"
          ],
          "format": "date"
        },
        "lowest_price": {
          "type": "number"
        },
        "departure_date": {
          "type": "string",
          "format": "date"
        },
        "google_flights_link": {
          "type": "string"
        }
      }
    },
    "google_flights_link": {
      "type": [
        "string",
        "null"
      ]
    }
  }
}
```

## See more

- [Google API: Search Google Flights](https://fous.com/methods/google.com/search-flights.md): Finds Google Flights options for a route and date with prices, local times, stops and emissions. Round-trip searches list outbound choices with their displayed round-trip fares.
- [Google API: List cheap flight destinations](https://fous.com/methods/google.com/list-cheap-destinations.md): Lists cheap round-trip destinations from a city on Google Travel Explore, sorted by fare, optionally within a region, travel month, trip length and nonstop only. Links search Google Flights for the shown dates.
- [Google API: Search Google Hotels](https://fous.com/methods/google.com/search-hotels.md): Finds places to stay in a city or area for given dates on Google Hotels, with nightly and total prices, hotel class, guest ratings, amenities, address and cheapest booking site. Optional filters for price, stars and rating; vacation rentals are left out. Prices and availability can change.
- [Google API: Get directions](https://fous.com/methods/google.com/get-directions.md): Gets up to three Google Maps routes between two places, with distances, travel times and step-by-step directions.
- [Google API: Get hotel reviews from Google Hotels](https://fous.com/methods/google.com/get-hotel-reviews.md): Finds a hotel on Google Hotels by name and city and returns its guest reviews in the chosen order, its Google rating and review count, and topic ratings averaged from the returned reviews that rate each topic.
- [Google API: Get company ads](https://fous.com/methods/adstransparency.google.com/get-company-ads.md): Finds a verified advertiser in the Google Ads Transparency Center by company name or website domain and returns its Google ads with dates, regions, previews and ad pages. Counts may be approximate; regions and media previews are read for the first 40 ads.
- [Google API: Search Google Books](https://fous.com/methods/books.google.com/search-books.md): Searches Google Books by words, author, subject or ISBN, with language, free-ebook and newest-first options. Ratings counts are not shown by the public book feed; newest sorts the available matches by publication date.
- [Google API: Get interest over time](https://fous.com/methods/trends.google.com/get-interest-over-time.md): Compares Google Trends search interest for one to five terms over a time range, with average scores and a dated timeline. Scores are relative within the comparison.
- [All Google methods](https://fous.com/methods/google.com.md)
