airports-search
Search for flight information and pricing between airports using Google Flights data. Find available flights, compare prices, and get travel options for one-way, round-trip, or multi-city journeys.
Instructions
Search for airport and flight information using Google Flights
Input Schema
Name | Required | Description | Default |
---|---|---|---|
arrival_id | Yes | Arrival airport code (e.g., 'NRT', 'LAX', 'JFK', 'LHR'). Use 3-letter IATA codes. | |
departure_id | Yes | Departure airport code (e.g., 'CDG', 'AUS', 'LAX', 'SFO'). Use 3-letter IATA codes. | |
include_airports | No | Include airport information | |
include_links | No | Include booking links for each flight (off by default) | |
include_price_insights | No | Include price insights and history | |
max_best_flights | No | Maximum number of best flights to return | |
max_other_flights | No | Maximum number of other flights to return | |
multi_city_json | No | JSON string for multi-city trips with multiple legs (required when type=3) | |
outbound_date | No | Outbound date in YYYY-MM-DD format | |
return_date | No | Return date in YYYY-MM-DD format for round-trip (REQUIRED when type=1) | |
summary_only | No | Return only essential flight information | |
type | No | Trip type: 1=Round-trip (requires return_date), 2=One-way (default), 3=Multi-city (requires multi_city_json). Use type=2 for one-way trips to avoid errors. |
Input Schema (JSON Schema)
{
"properties": {
"arrival_id": {
"description": "Arrival airport code (e.g., 'NRT', 'LAX', 'JFK', 'LHR'). Use 3-letter IATA codes.",
"type": "string"
},
"departure_id": {
"description": "Departure airport code (e.g., 'CDG', 'AUS', 'LAX', 'SFO'). Use 3-letter IATA codes.",
"type": "string"
},
"include_airports": {
"default": false,
"description": "Include airport information",
"type": "boolean"
},
"include_links": {
"default": false,
"description": "Include booking links for each flight (off by default)",
"type": "boolean"
},
"include_price_insights": {
"default": true,
"description": "Include price insights and history",
"type": "boolean"
},
"max_best_flights": {
"default": 3,
"description": "Maximum number of best flights to return",
"type": "number"
},
"max_other_flights": {
"default": 5,
"description": "Maximum number of other flights to return",
"type": "number"
},
"multi_city_json": {
"description": "JSON string for multi-city trips with multiple legs (required when type=3)",
"type": "string"
},
"outbound_date": {
"description": "Outbound date in YYYY-MM-DD format",
"type": "string"
},
"return_date": {
"description": "Return date in YYYY-MM-DD format for round-trip (REQUIRED when type=1)",
"type": "string"
},
"summary_only": {
"default": true,
"description": "Return only essential flight information",
"type": "boolean"
},
"type": {
"default": 2,
"description": "Trip type: 1=Round-trip (requires return_date), 2=One-way (default), 3=Multi-city (requires multi_city_json). Use type=2 for one-way trips to avoid errors.",
"type": "number"
}
},
"required": [
"departure_id",
"arrival_id"
],
"type": "object"
}