{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Flights Fare Monitor: Cheapest Price & Drop Alerts",
    "description": "Google Flights price tracker: the cheapest fare for a route and date, Google's own low / typical / high verdict and typical band, as one answer row per check. Monitor fares and get drop alerts in Slack, Discord or Telegram. No login or API key; checks that find nothing are free.",
    "version": "1.0",
    "x-build-id": "USgQTHQe2Z2Jeb9rp"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/accountable_eel~google-flights-fare-lookup/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-accountable_eel-google-flights-fare-lookup",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/accountable_eel~google-flights-fare-lookup/runs": {
      "post": {
        "operationId": "runs-sync-accountable_eel-google-flights-fare-lookup",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/accountable_eel~google-flights-fare-lookup/run-sync": {
      "post": {
        "operationId": "run-sync-accountable_eel-google-flights-fare-lookup",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "required": [
          "routes"
        ],
        "properties": {
          "routes": {
            "title": "Routes and dates to check",
            "type": "array",
            "description": "One check per line: LHR-JFK 2026-12-10 for one way, LHR-JFK 2026-12-10 2026-12-17 for a return. +60d instead of a date means 60 days from today. A pasted google.com/travel/flights link is read as text for its route and dates (it is never opened). Accepted formats: LHR-JFK 2026-12-10, LHR-JFK 2026-12-10 2026-12-17, LHR-JFK +60d, https://www.google.com/travel/flights?q=Flights+to+JFK+from+LHR+on+2026-12-10+one+way. You're only charged for the ones we actually find — a miss costs nothing.",
            "items": {
              "type": "string"
            }
          },
          "currency": {
            "title": "Currency",
            "enum": [
              "USD",
              "EUR",
              "GBP"
            ],
            "type": "string",
            "description": "Currency of the prices. USD, EUR and GBP are supported.",
            "default": "USD"
          },
          "cabin": {
            "title": "Cabin",
            "enum": [
              "economy",
              "business",
              "first"
            ],
            "type": "string",
            "description": "Economy is Google's default. Business and first class change the fares Google shows (premium economy is not offered: Google did not understand it in testing).",
            "default": "economy"
          },
          "nonstopOnly": {
            "title": "Nonstop flights only",
            "type": "boolean",
            "description": "Keeps only itineraries with no stop before picking the cheapest fare. Applied after the fetch, so Google's price verdict still describes the whole search. A route with no nonstop flight comes back as not found and is not charged.",
            "default": false
          },
          "maxItineraries": {
            "title": "Itinerary rows to add per check",
            "type": "integer",
            "description": "0 returns only the answer row. Above 0, the cheapest N itineraries are added as extra rows (airline, flight numbers, times, stops, layovers, price). Up to 50. Each itinerary row is billed at the itinerary price.",
            "default": 0
          },
          "dateWindowDays": {
            "title": "Check this many consecutive days",
            "type": "integer",
            "description": "1 checks only the date you wrote. 7 checks that date and the next 6 as separate checks (a return trip keeps its length of stay). At most 31 checks per run in total, so a long list plus a wide window is cut off, and the cut-off lines come back as free not-checked rows.",
            "default": 1
          },
          "deltaMode": {
            "title": "Track fares across runs",
            "type": "boolean",
            "description": "Turns the actor into a fare monitor. Each run compares the cheapest fare of every route and date with the previous run's, and fills in 'Change since last check', previous fare, change % and the lowest fare seen so far. Schedule it daily and combine with 'Only return rows that changed' and 'Send alerts to'.",
            "default": false
          },
          "deltaName": {
            "title": "Watchlist name (optional)",
            "type": "string",
            "description": "Leave empty and one is derived from the currency, cabin and nonstop setting. Type your own name to keep one memory across changes, or to run several independent watchlists.",
            "default": ""
          },
          "alertOnDropPct": {
            "title": "Alert when the fare drops by at least (%)",
            "type": "integer",
            "description": "A drop (or rise) smaller than this counts as unchanged.",
            "default": 5
          },
          "alertOnLevelLow": {
            "title": "Also alert when Google's verdict turns 'low'",
            "type": "boolean",
            "description": "Sends an alert the first time Google's price verdict for a route and date turns low, even when the drop is smaller than the percentage above.",
            "default": true
          },
          "alertOnChangeOnly": {
            "title": "Only return rows that changed",
            "type": "boolean",
            "description": "With monitoring on, a check whose fare did not move (changeType unchanged) writes no row and is not billed. New, drop, rise and level-low checks are returned.",
            "default": false
          },
          "skipFirstRun": {
            "title": "Seed silently (no rows on the first check)",
            "type": "boolean",
            "description": "The first check of a route and date has nothing to compare with. Turn this on to remember it without returning or billing it, so alerts start from the second check.",
            "default": false
          },
          "notifyUrl": {
            "title": "Send alerts to (Discord or Slack webhook, Telegram bot link, or any URL)",
            "type": "string",
            "description": "Optional. After a check is billed, each fare drop and each 'verdict turned low' is posted here as one message with route, dates, price, previous price and a Google Flights link. Discord or Slack: paste the channel's webhook URL. Telegram: https://api.telegram.org/bot<token>/sendMessage?chat_id=<chat id>. Any other URL receives JSON. Messages are free, and a failed message never fails the run (the row's notifyErrors says why). Stored encrypted, never logged or written to the results."
          },
          "notifyFormat": {
            "title": "Message format",
            "enum": [
              "auto",
              "discord",
              "slack",
              "telegram",
              "json"
            ],
            "type": "string",
            "description": "Leave on 'Detect from the link': discord.com links get Discord messages, hooks.slack.com Slack, api.telegram.org Telegram, anything else JSON. Pick one only to override that.",
            "default": "auto"
          },
          "maxNotificationsPerRun": {
            "title": "Most alert messages per run",
            "type": "integer",
            "description": "Up to 100. After this, one 'more alerts' message says the rest are in the run's dataset. 0 sends only that one message.",
            "default": 20
          },
          "testRun": {
            "title": "Try it first — only process the first 5",
            "type": "boolean",
            "description": "Turn this on to test your input on a small sample before running the full list. Turn it off to process everything.",
            "default": false
          },
          "onlyFound": {
            "title": "Hide rows with no result",
            "type": "boolean",
            "description": "Only keep rows where something was actually found. Misses are always free, whether or not you show them here.",
            "default": false
          },
          "includeKeywords": {
            "title": "Only keep rows containing",
            "type": "array",
            "description": "Optional. Only keep results that mention at least one of these words (e.g. a job title, a city, a product name). Leave empty to keep everything.",
            "items": {
              "type": "string"
            }
          },
          "excludeKeywords": {
            "title": "Skip rows containing",
            "type": "array",
            "description": "Optional. Drop any result that mentions one of these words. Leave empty to skip nothing.",
            "items": {
              "type": "string"
            }
          },
          "maxResults": {
            "title": "Stop after this many results",
            "minimum": 1,
            "type": "integer",
            "description": "Optional. Stop the run once this many results have been found — useful for a quick, cheap sample. Leave blank for no limit."
          },
          "columns": {
            "title": "Which columns do you want?",
            "type": "array",
            "description": "Choose which pieces of information to include in each result row. All are included by default.",
            "items": {
              "type": "string",
              "enum": [
                "rowType",
                "origin",
                "destination",
                "departDate",
                "returnDate",
                "currency",
                "cheapestPrice",
                "cheapestAirlines",
                "cheapestStops",
                "cheapestDurationMin",
                "cheapestNonstopPrice",
                "bestPrice",
                "itineraryCount",
                "priceLevel",
                "typicalLow",
                "typicalHigh",
                "googleFlightsUrl",
                "checkedAt",
                "changeType",
                "previousCheapest",
                "changePct",
                "lowestEverSeen",
                "daysSincePrevious"
              ],
              "enumTitles": [
                "Row type",
                "From",
                "To",
                "Departure date",
                "Return date",
                "Currency",
                "Cheapest fare",
                "Cheapest fare: airlines",
                "Cheapest fare: stops",
                "Cheapest fare: duration (min)",
                "Cheapest nonstop fare",
                "Cheapest 'best' fare",
                "Itineraries listed",
                "Google's price verdict",
                "Typical price: low end",
                "Typical price: high end",
                "Google Flights link",
                "Checked at",
                "Change since last check",
                "Previous cheapest fare",
                "Change (%)",
                "Lowest fare seen so far",
                "Days since previous check"
              ]
            },
            "default": [
              "rowType",
              "origin",
              "destination",
              "departDate",
              "returnDate",
              "currency",
              "cheapestPrice",
              "cheapestAirlines",
              "cheapestStops",
              "cheapestDurationMin",
              "cheapestNonstopPrice",
              "bestPrice",
              "itineraryCount",
              "priceLevel",
              "typicalLow",
              "typicalHigh",
              "googleFlightsUrl",
              "checkedAt",
              "changeType",
              "previousCheapest",
              "changePct",
              "lowestEverSeen",
              "daysSincePrevious"
            ]
          },
          "maxConcurrency": {
            "title": "Max concurrency",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "Parallel requests. Keep conservative — this target has no browser fallback, so getting blocked costs more than slow-and-steady.",
            "default": 2
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Apify Proxy config. Residential recommended for anti-bot-sensitive targets.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ]
            }
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}