web-search

Web search — Google, Amazon, YouTube, flights, hotels, news, academic, and more

Server path: /web-search | Type: Embedded | PCID required: No

Tools

Tool	Description
search_amazon	Search for products on Amazon with comprehensive filtering options including category, price sorting, delivery options, and pagination. Returns product listings with ASINs that can be used with search_amazon_product to get detailed information.
search_amazon_product	Get detailed product information from Amazon using the ASIN (Amazon Standard Identification Number). Returns comprehensive product details including specifications, pricing, reviews, related products, and availability. Use this after search_amazon to get full details on specific products.
search_youtube	Search for videos on YouTube. Returns video results, playlist results, channel results and more. Useful for finding tutorials, reviews, entertainment content, music videos, and any video content.
search_shopping	Search for products on Google Shopping with price comparison, filtering by price range, shipping options, and sale items. Lighter and faster than competitive_prices for quick product searches.
search_competitive_prices	Search for competitive prices of products across multiple retailers and marketplaces to find the best deals and compare pricing strategies. Returns product listings with product IDs that can be used with search_product to get detailed information about specific products.
search_flights	Search for flight options between airports with comprehensive filtering, pricing comparison, and booking capabilities including multi-city and recurring flight support
search_hotels	Search for hotel accommodations and vacation rentals with comprehensive filtering options including price range, amenities, ratings, and location preferences
search_news	Search for current news articles and stories from various sources with filtering by date range, category, and geographic location for comprehensive news research
search_academic	Search academic and scholarly resources including research papers, journals, patents, and legal documents with advanced filtering by publication date, source type, and citation metrics
search_restaurants	Search for restaurants and dining establishments with detailed information including ratings, cuisine types, pricing, hours, and reservation options for comprehensive dining research
search_local_events	Discover local events, activities, and happenings in a specific area including concerts, exhibitions, festivals, workshops, and community gatherings with detailed event information
search_googlesearch	Perform comprehensive Google web searches with advanced filtering options including safe search, language preferences, date ranges, and site-specific searches for thorough web research

---

search_amazon

Search for products on Amazon with comprehensive filtering options including category, price sorting, delivery options, and pagination. Returns product listings with ASINs that can be used with search_amazon_product to get detailed information.

Parameters:

Parameter	Type	Required	Default	Description
k	string	Yes	—	Product search query - use anything you would use in a regular Amazon search (e.g., “wireless headphones”, “coffee maker”, “laptop stand”)
amazon_domain	string	No	—	Amazon domain to search (e.g., “amazon.com” (default), “amazon.co.uk”, “amazon.de”, “amazon.co.jp”, “amazon.fr”, “amazon.ca”)
language	string	No	—	Language for search results as locale name (e.g., “en_US” for English on amazon.com, “es_US” for Spanish, “ja_JP” for Japanese on amazon.co.jp)
delivery_zip	string	No	—	ZIP/Postal code to filter products by shipping availability to a specific area
shipping_location	string	No	—	Country code to filter products by shipping country
s	string	No	—	Sort order: “relevanceblender” (Featured, default), “price-asc-rank” (Price: Low to High), “price-desc-rank” (Price: High to Low), “review-rank” (Avg. Customer Review), “date-desc-rank” (Newest Arrivals), “exact-aware-popularity-rank” (Best Sellers)
node	string	No	—	Amazon category node ID to filter by category. Find node IDs by browsing Amazon categories - the ID appears in URLs as node=[NODE ID]. Example: “6563140011” for Smart Home on amazon.com
rh	string	No	—	Attribute filtering as comma-separated key:value pairs. Example: “n:16318031,p_72:1248897011” filters for Coffee department with 4+ star rating
dc	boolean	No	true	Enable spelling correction. Set to false to search without spelling fix. Default is true
page	number	No	1	Page number for pagination (1 = first page, 2 = second page, etc.). Default is 1
device	string	No	—	Device type for search: “desktop” (default), “tablet” (iPad), or “mobile”
no_cache	boolean	No	false	Set to true to force fresh results and bypass cache. Default is false

Show inputSchema

{
  "type": "object",
  "properties": {
    "k": {
      "type": "string",
      "description": "Product search query - use anything you would use in a regular Amazon search (e.g., \"wireless headphones\", \"coffee maker\", \"laptop stand\")"
    },
    "amazon_domain": {
      "type": "string",
      "description": "Amazon domain to search (e.g., \"amazon.com\" (default), \"amazon.co.uk\", \"amazon.de\", \"amazon.co.jp\", \"amazon.fr\", \"amazon.ca\")"
    },
    "language": {
      "type": "string",
      "description": "Language for search results as locale name (e.g., \"en_US\" for English on amazon.com, \"es_US\" for Spanish, \"ja_JP\" for Japanese on amazon.co.jp)"
    },
    "delivery_zip": {
      "type": "string",
      "description": "ZIP/Postal code to filter products by shipping availability to a specific area"
    },
    "shipping_location": {
      "type": "string",
      "description": "Country code to filter products by shipping country"
    },
    "s": {
      "type": "string",
      "enum": [
        "relevanceblender",
        "price-asc-rank",
        "price-desc-rank",
        "review-rank",
        "date-desc-rank",
        "exact-aware-popularity-rank"
      ],
      "description": "Sort order: \"relevanceblender\" (Featured, default), \"price-asc-rank\" (Price: Low to High), \"price-desc-rank\" (Price: High to Low), \"review-rank\" (Avg. Customer Review), \"date-desc-rank\" (Newest Arrivals), \"exact-aware-popularity-rank\" (Best Sellers)"
    },
    "node": {
      "type": "string",
      "description": "Amazon category node ID to filter by category. Find node IDs by browsing Amazon categories - the ID appears in URLs as node=[NODE ID]. Example: \"6563140011\" for Smart Home on amazon.com"
    },
    "rh": {
      "type": "string",
      "description": "Attribute filtering as comma-separated key:value pairs. Example: \"n:16318031,p_72:1248897011\" filters for Coffee department with 4+ star rating"
    },
    "dc": {
      "type": "boolean",
      "default": true,
      "description": "Enable spelling correction. Set to false to search without spelling fix. Default is true"
    },
    "page": {
      "type": "number",
      "default": 1,
      "description": "Page number for pagination (1 = first page, 2 = second page, etc.). Default is 1"
    },
    "device": {
      "type": "string",
      "description": "Device type for search: \"desktop\" (default), \"tablet\" (iPad), or \"mobile\""
    },
    "no_cache": {
      "type": "boolean",
      "default": false,
      "description": "Set to true to force fresh results and bypass cache. Default is false"
    }
  },
  "required": [
    "k"
  ]
}

---

search_amazon_product

Get detailed product information from Amazon using the ASIN (Amazon Standard Identification Number). Returns comprehensive product details including specifications, pricing, reviews, related products, and availability. Use this after search_amazon to get full details on specific products.

Parameters:

Parameter	Type	Required	Default	Description
asin	string	Yes	—	Amazon Standard Identification Number (ASIN) - the unique 10-character product identifier (e.g., “B09V3KXJPB”). Get ASINs from search_amazon results
amazon_domain	string	No	—	Amazon domain to use (e.g., “amazon.com” (default), “amazon.co.uk”, “amazon.de”, “amazon.co.jp”)
language	string	No	—	Language for product details as locale name (e.g., “en_US” for English, “es_US” for Spanish)
delivery_zip	string	No	—	ZIP/Postal code to show delivery options and pricing for a specific area
shipping_location	string	No	—	Country code to show shipping options for a specific country
other_sellers	boolean	No	—	Set to true to include pricing and offers from other sellers
device	string	No	—	Device type for product view: “desktop” (default), “tablet” (iPad), or “mobile”
no_cache	boolean	No	false	Set to true to force fresh results and bypass cache. Default is false

Show inputSchema

{
  "type": "object",
  "properties": {
    "asin": {
      "type": "string",
      "description": "Amazon Standard Identification Number (ASIN) - the unique 10-character product identifier (e.g., \"B09V3KXJPB\"). Get ASINs from search_amazon results"
    },
    "amazon_domain": {
      "type": "string",
      "description": "Amazon domain to use (e.g., \"amazon.com\" (default), \"amazon.co.uk\", \"amazon.de\", \"amazon.co.jp\")"
    },
    "language": {
      "type": "string",
      "description": "Language for product details as locale name (e.g., \"en_US\" for English, \"es_US\" for Spanish)"
    },
    "delivery_zip": {
      "type": "string",
      "description": "ZIP/Postal code to show delivery options and pricing for a specific area"
    },
    "shipping_location": {
      "type": "string",
      "description": "Country code to show shipping options for a specific country"
    },
    "other_sellers": {
      "type": "boolean",
      "description": "Set to true to include pricing and offers from other sellers"
    },
    "device": {
      "type": "string",
      "description": "Device type for product view: \"desktop\" (default), \"tablet\" (iPad), or \"mobile\""
    },
    "no_cache": {
      "type": "boolean",
      "default": false,
      "description": "Set to true to force fresh results and bypass cache. Default is false"
    }
  },
  "required": [
    "asin"
  ]
}

---

search_youtube

Search for videos on YouTube. Returns video results, playlist results, channel results and more. Useful for finding tutorials, reviews, entertainment content, music videos, and any video content.

Parameters:

Parameter	Type	Required	Default	Description
search_query	string	Yes	—	YouTube search query - use anything you would use in a regular YouTube search (e.g., “how to cook pasta”, “python tutorial”, “music videos 2024”)
gl	string	No	—	Country code for search results (e.g., “us” for United States, “uk” for United Kingdom, “fr” for France)
hl	string	No	—	Language code for search results (e.g., “en” for English, “es” for Spanish, “fr” for French)
sp	string	No	—	Pagination token or filter parameter. For pagination, use the next_page_token from previous results. For filters: “CAI%3D” (Upload date), “EgJwAQ%3D%3D” (4K), “QgIIAQ%3D%3D” (exact spelling). Copy sp values from YouTube URLs after applying filters.
no_cache	boolean	No	false	Set to true to force fresh results and bypass cache. Default is false

Show inputSchema

{
  "type": "object",
  "properties": {
    "search_query": {
      "type": "string",
      "description": "YouTube search query - use anything you would use in a regular YouTube search (e.g., \"how to cook pasta\", \"python tutorial\", \"music videos 2024\")"
    },
    "gl": {
      "type": "string",
      "description": "Country code for search results (e.g., \"us\" for United States, \"uk\" for United Kingdom, \"fr\" for France)"
    },
    "hl": {
      "type": "string",
      "description": "Language code for search results (e.g., \"en\" for English, \"es\" for Spanish, \"fr\" for French)"
    },
    "sp": {
      "type": "string",
      "description": "Pagination token or filter parameter. For pagination, use the next_page_token from previous results. For filters: \"CAI%3D\" (Upload date), \"EgJwAQ%3D%3D\" (4K), \"QgIIAQ%3D%3D\" (exact spelling). Copy sp values from YouTube URLs after applying filters."
    },
    "no_cache": {
      "type": "boolean",
      "default": false,
      "description": "Set to true to force fresh results and bypass cache. Default is false"
    }
  },
  "required": [
    "search_query"
  ]
}

---

search_shopping

Search for products on Google Shopping with price comparison, filtering by price range, shipping options, and sale items. Lighter and faster than competitive_prices for quick product searches.

Parameters:

Parameter	Type	Required	Default	Description
q	string	Yes	—	Product search query (e.g., “wireless headphones”, “running shoes”, “laptop”)
location	string	No	—	Location to search from (e.g., “New York, NY”, “Los Angeles, California”). Recommend city-level for realistic results.
google_domain	string	No	—	Google domain to use (e.g., “google.com” (default), “google.co.uk”, “google.fr”)
gl	string	No	—	Country code (e.g., “us” for United States, “uk” for United Kingdom, “fr” for France)
hl	string	No	—	Language code (e.g., “en” for English, “es” for Spanish, “fr” for French)
min_price	number	No	—	Minimum price filter (e.g., 50 for $50 minimum)
max_price	number	No	—	Maximum price filter (e.g., 200 for $200 maximum)
sort_by	string	No	—	Sort order: “1” (Price: low to high), “2” (Price: high to low)
free_shipping	boolean	No	—	Set to true to show only products with free shipping
on_sale	boolean	No	—	Set to true to show only products that are on sale
small_business	boolean	No	—	Set to true to show only products from small businesses
start	number	No	0	Result offset for pagination (0 = first page, 10 = second page, 20 = third page, etc.)
device	string	No	—	Device type: “desktop” (default), “tablet” (iPad), or “mobile”
no_cache	boolean	No	false	Set to true to force fresh results and bypass cache. Default is false

Show inputSchema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Product search query (e.g., \"wireless headphones\", \"running shoes\", \"laptop\")"
    },
    "location": {
      "type": "string",
      "description": "Location to search from (e.g., \"New York, NY\", \"Los Angeles, California\"). Recommend city-level for realistic results."
    },
    "google_domain": {
      "type": "string",
      "description": "Google domain to use (e.g., \"google.com\" (default), \"google.co.uk\", \"google.fr\")"
    },
    "gl": {
      "type": "string",
      "description": "Country code (e.g., \"us\" for United States, \"uk\" for United Kingdom, \"fr\" for France)"
    },
    "hl": {
      "type": "string",
      "description": "Language code (e.g., \"en\" for English, \"es\" for Spanish, \"fr\" for French)"
    },
    "min_price": {
      "type": "number",
      "description": "Minimum price filter (e.g., 50 for $50 minimum)"
    },
    "max_price": {
      "type": "number",
      "description": "Maximum price filter (e.g., 200 for $200 maximum)"
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "1",
        "2"
      ],
      "description": "Sort order: \"1\" (Price: low to high), \"2\" (Price: high to low)"
    },
    "free_shipping": {
      "type": "boolean",
      "description": "Set to true to show only products with free shipping"
    },
    "on_sale": {
      "type": "boolean",
      "description": "Set to true to show only products that are on sale"
    },
    "small_business": {
      "type": "boolean",
      "description": "Set to true to show only products from small businesses"
    },
    "start": {
      "type": "number",
      "default": 0,
      "description": "Result offset for pagination (0 = first page, 10 = second page, 20 = third page, etc.)"
    },
    "device": {
      "type": "string",
      "description": "Device type: \"desktop\" (default), \"tablet\" (iPad), or \"mobile\""
    },
    "no_cache": {
      "type": "boolean",
      "default": false,
      "description": "Set to true to force fresh results and bypass cache. Default is false"
    }
  },
  "required": [
    "q"
  ]
}

---

search_competitive_prices

Search for competitive prices of products across multiple retailers and marketplaces to find the best deals and compare pricing strategies. Returns product listings with product IDs that can be used with search_product to get detailed information about specific products.

Parameters:

Parameter	Type	Required	Default	Description
q	string	Yes	—	Product search query for competitive price analysis (e.g., “iPhone 15 Pro”, “Nike Air Max”). Returns results with product IDs that can be used with search_product.

Show inputSchema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Product search query for competitive price analysis (e.g., \"iPhone 15 Pro\", \"Nike Air Max\"). Returns results with product IDs that can be used with search_product."
    }
  },
  "required": [
    "q"
  ]
}

---

search_flights

Search for flight options between airports with comprehensive filtering, pricing comparison, and booking capabilities including multi-city and recurring flight support

Parameters:

Parameter	Type	Required	Default	Description
departure_id	string	Yes	—	Departure airport code (e.g., LAX for Los Angeles, JFK for New York JFK). Use 3-letter IATA codes
arrival_id	string	Yes	—	Arrival airport code (e.g., CDG for Paris Charles de Gaulle, LHR for London Heathrow)
outbound_date	string	Yes	—	Departure date in YYYY-MM-DD format (e.g., 2025-05-30). Required for all flight types
type	string	No	1	Flight type: 1 = Round trip (default), 2 = One-way, 3 = Multi-city. Default is 1 (Round trip)
travel_class	string	No	1	Cabin class: 1 = Economy (default), 2 = Premium economy, 3 = Business, 4 = First class. Default is 1 (Economy)
adults	number	No	1	Number of adults (12 years and older). Default is 1
children	number	No	0	Number of children (2-11 years old). Default is 0
infants_in_seat	number	No	0	Number of infants in seat (under 2 years). Default is 0
infants_on_lap	number	No	0	Number of infants on lap (under 2 years). Default is 0
return_date	string	No	—	Return date for round trip flights in YYYY-MM-DD format (e.g., 2025-06-06). Required for round trip flights
legs	object[]	No	—	Array of flight legs for multi-city trips. Each leg must have departure_id, arrival_id, and outbound_date. Required when type=3
gl	string	No	—	Country code for Google Flights search (e.g., us for United States, uk for United Kingdom, fr for France)
hl	string	No	—	Language code for Google Flights search (e.g., en for English, es for Spanish, fr for French)
currency	string	No	—	Currency code for returned prices (e.g., USD, EUR, GBP). Default is USD
sort_by	string	No	—	Sort order for results: 1 = Top flights, 2 = Price (low to high), 3 = Departure time (earliest first), 4 = Arrival time (earliest first), 5 = Duration (shortest first), 6 = Emissions (lowest first). Default is 1
max_price	number	No	—	Maximum price filter in specified currency (e.g., 500 for $500)
stops	string	No	—	Number of stops filter: 0 = Any number of stops, 1 = Nonstop only, 2 = One stop or fewer, 3 = Two stops or fewer. Default is 0
airlines	string	No	—	Include only these airlines. Use 2-letter IATA codes separated by comma (e.g., “AA,UA” for American and United Airlines)
exclude_airlines	string	No	—	Exclude these airlines. Use 2-letter IATA codes separated by comma (e.g., “DL,BA” to exclude Delta and British Airways)
alliances	string	No	—	Include only these airline alliances separated by comma. Options: star_alliance, oneworld, skyteam (e.g., “star_alliance,oneworld”)
outbound_times	string	No	—	Outbound departure time ranges as comma-separated pairs (0-23). Format: “min1,max1,min2,max2” (e.g., “6,12,18,23” for 6-12am and 6-11pm)
return_times	string	No	—	Return departure time ranges using same format as outbound_times (e.g., “6,12” for 6am-12pm)
exclude_overnight	boolean	No	false	Set to true to exclude flights departing before 6am. Default is false
emissions	string	No	—	Emission level filter: 1 = Less emissions only
layover_duration	string	No	—	Layover duration in minutes as comma-separated min,max values (e.g., “90,330” for 1hr 30min - 5hr 30min)
exclude_conns	string	No	—	Connecting airport codes to exclude, separated by comma (e.g., CDG,AUS)
max_duration	number	No	—	Maximum flight duration in minutes (e.g., 1500 for 25 hours)
departure_token	string	No	—	Token to select flight and get returning flights (Round trip) or next leg flights (Multi-city). Cannot be used with booking_token
booking_token	string	No	—	Token to get booking options for selected flights. Cannot be used with departure_token
no_cache	boolean	No	false	Set to true to disable caching and force fresh results. Default is false. Cannot be used with async parameter

Show inputSchema

{
  "type": "object",
  "properties": {
    "departure_id": {
      "type": "string",
      "description": "Departure airport code (e.g., LAX for Los Angeles, JFK for New York JFK). Use 3-letter IATA codes"
    },
    "arrival_id": {
      "type": "string",
      "description": "Arrival airport code (e.g., CDG for Paris Charles de Gaulle, LHR for London Heathrow)"
    },
    "outbound_date": {
      "type": "string",
      "description": "Departure date in YYYY-MM-DD format (e.g., 2025-05-30). Required for all flight types"
    },
    "type": {
      "type": "string",
      "enum": [
        "ROUND_TRIP",
        "ONE_WAY",
        "MULTI_CITY",
        1,
        2,
        3
      ],
      "default": 1,
      "description": "Flight type: 1 = Round trip (default), 2 = One-way, 3 = Multi-city. Default is 1 (Round trip)"
    },
    "travel_class": {
      "type": "string",
      "enum": [
        "ECONOMY",
        "PREMIUM_ECONOMY",
        "BUSINESS",
        "FIRST",
        1,
        2,
        3,
        4
      ],
      "default": 1,
      "description": "Cabin class: 1 = Economy (default), 2 = Premium economy, 3 = Business, 4 = First class. Default is 1 (Economy)"
    },
    "adults": {
      "type": "number",
      "default": 1,
      "description": "Number of adults (12 years and older). Default is 1"
    },
    "children": {
      "type": "number",
      "default": 0,
      "description": "Number of children (2-11 years old). Default is 0"
    },
    "infants_in_seat": {
      "type": "number",
      "default": 0,
      "description": "Number of infants in seat (under 2 years). Default is 0"
    },
    "infants_on_lap": {
      "type": "number",
      "default": 0,
      "description": "Number of infants on lap (under 2 years). Default is 0"
    },
    "return_date": {
      "type": "string",
      "description": "Return date for round trip flights in YYYY-MM-DD format (e.g., 2025-06-06). Required for round trip flights"
    },
    "legs": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "departure_id": {
            "type": "string"
          },
          "arrival_id": {
            "type": "string"
          },
          "outbound_date": {
            "type": "string"
          }
        }
      },
      "description": "Array of flight legs for multi-city trips. Each leg must have departure_id, arrival_id, and outbound_date. Required when type=3"
    },
    "gl": {
      "type": "string",
      "description": "Country code for Google Flights search (e.g., us for United States, uk for United Kingdom, fr for France)"
    },
    "hl": {
      "type": "string",
      "description": "Language code for Google Flights search (e.g., en for English, es for Spanish, fr for French)"
    },
    "currency": {
      "type": "string",
      "description": "Currency code for returned prices (e.g., USD, EUR, GBP). Default is USD"
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "TOP_FLIGHTS",
        "PRICE",
        "DEPARTURE_TIME",
        "ARRIVAL_TIME",
        "DURATION",
        "EMISSIONS",
        1,
        2,
        3,
        4,
        5,
        6
      ],
      "description": "Sort order for results: 1 = Top flights, 2 = Price (low to high), 3 = Departure time (earliest first), 4 = Arrival time (earliest first), 5 = Duration (shortest first), 6 = Emissions (lowest first). Default is 1"
    },
    "max_price": {
      "type": "number",
      "description": "Maximum price filter in specified currency (e.g., 500 for $500)"
    },
    "stops": {
      "type": "string",
      "enum": [
        "ANY",
        "NONSTOP",
        "ONE_STOP_OR_FEWER",
        "TWO_STOPS_OR_FEWER",
        0,
        1,
        2,
        3
      ],
      "description": "Number of stops filter: 0 = Any number of stops, 1 = Nonstop only, 2 = One stop or fewer, 3 = Two stops or fewer. Default is 0"
    },
    "airlines": {
      "type": "string",
      "description": "Include only these airlines. Use 2-letter IATA codes separated by comma (e.g., \"AA,UA\" for American and United Airlines)"
    },
    "exclude_airlines": {
      "type": "string",
      "description": "Exclude these airlines. Use 2-letter IATA codes separated by comma (e.g., \"DL,BA\" to exclude Delta and British Airways)"
    },
    "alliances": {
      "type": "string",
      "description": "Include only these airline alliances separated by comma. Options: star_alliance, oneworld, skyteam (e.g., \"star_alliance,oneworld\")"
    },
    "outbound_times": {
      "type": "string",
      "description": "Outbound departure time ranges as comma-separated pairs (0-23). Format: \"min1,max1,min2,max2\" (e.g., \"6,12,18,23\" for 6-12am and 6-11pm)"
    },
    "return_times": {
      "type": "string",
      "description": "Return departure time ranges using same format as outbound_times (e.g., \"6,12\" for 6am-12pm)"
    },
    "exclude_overnight": {
      "type": "boolean",
      "default": false,
      "description": "Set to true to exclude flights departing before 6am. Default is false"
    },
    "emissions": {
      "type": "string",
      "enum": [
        "LESS_EMISSIONS",
        1
      ],
      "description": "Emission level filter: 1 = Less emissions only"
    },
    "layover_duration": {
      "type": "string",
      "description": "Layover duration in minutes as comma-separated min,max values (e.g., \"90,330\" for 1hr 30min - 5hr 30min)"
    },
    "exclude_conns": {
      "type": "string",
      "description": "Connecting airport codes to exclude, separated by comma (e.g., CDG,AUS)"
    },
    "max_duration": {
      "type": "number",
      "description": "Maximum flight duration in minutes (e.g., 1500 for 25 hours)"
    },
    "departure_token": {
      "type": "string",
      "description": "Token to select flight and get returning flights (Round trip) or next leg flights (Multi-city). Cannot be used with booking_token"
    },
    "booking_token": {
      "type": "string",
      "description": "Token to get booking options for selected flights. Cannot be used with departure_token"
    },
    "no_cache": {
      "type": "boolean",
      "default": false,
      "description": "Set to true to disable caching and force fresh results. Default is false. Cannot be used with async parameter"
    }
  },
  "required": [
    "departure_id",
    "arrival_id",
    "outbound_date"
  ]
}

---

search_hotels

Search for hotel accommodations and vacation rentals with comprehensive filtering options including price range, amenities, ratings, and location preferences

Parameters:

Parameter	Type	Required	Default	Description
q	string	Yes	—	Search query for hotels. You can use anything that you would use in a regular Google Hotels search
check_in_date	string	Yes	—	Check-in date in YYYY-MM-DD format (e.g., 2025-05-30)
check_out_date	string	Yes	—	Check-out date in YYYY-MM-DD format (e.g., 2025-05-31)
adults	number	No	2	Number of adults. Default is 2
gl	string	No	—	Country code for Google Hotels search (e.g., us for United States, uk for United Kingdom, fr for France)
hl	string	No	—	Language code for Google Hotels search (e.g., en for English, es for Spanish, fr for French)
currency	string	No	—	Currency code for returned prices (e.g., USD, EUR, GBP). Default is USD
children	number	No	0	Number of children. Default is 0
sort_by	string	No	—	Sort order: 3 = Lowest price, 8 = Highest rating, 13 = Most reviewed. Default is 3 (Lowest price)
min_price	number	No	—	Minimum price per night in specified currency (e.g., 50 for $50/night)
max_price	number	No	—	Maximum price per night in specified currency (e.g., 200 for $200/night)
rating	string	No	—	Minimum rating filter: 7 = 3.5+ stars, 8 = 4+ stars, 9 = 4.5+ stars
hotel_class	string	No	—	Hotel star class: 2 = 2-star, 3 = 3-star, 4 = 4-star, 5 = 5-star
free_cancellation	boolean	No	—	Set to true to show only hotels with free cancellation
vacation_rentals	boolean	No	—	Set to true to show vacation rentals like Airbnb, Vrbo, etc.
amenities	string	No	—	Required amenities separated by comma. Options include: free_breakfast, free_wifi, pool, spa, pet_friendly, air_conditioning, gym, restaurant, kitchen, accessible, parking, airport_shuttle, washer_dryer
hotel_ids	string	No	—	Specific hotel IDs to include, separated by comma (obtained from previous search results)
exclude_hotel_ids	string	No	—	Hotel IDs to exclude, separated by comma
property_types	string	No	—	Property types to include, separated by comma. Options: hotel, motel, home, apartment, hostel, resort, vacation_home, villa, ryokan, inn, aparthotel, cottage, guest_house, chalet, bed_breakfast, campground, boat, condominium, guest_suite, capsule_hotel, farm_stay
no_cache	boolean	No	false	Set to true to disable caching and force fresh results. Default is false. Cannot be used with async parameter

Show inputSchema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Search query for hotels. You can use anything that you would use in a regular Google Hotels search"
    },
    "check_in_date": {
      "type": "string",
      "description": "Check-in date in YYYY-MM-DD format (e.g., 2025-05-30)"
    },
    "check_out_date": {
      "type": "string",
      "description": "Check-out date in YYYY-MM-DD format (e.g., 2025-05-31)"
    },
    "adults": {
      "type": "number",
      "default": 2,
      "description": "Number of adults. Default is 2"
    },
    "gl": {
      "type": "string",
      "description": "Country code for Google Hotels search (e.g., us for United States, uk for United Kingdom, fr for France)"
    },
    "hl": {
      "type": "string",
      "description": "Language code for Google Hotels search (e.g., en for English, es for Spanish, fr for French)"
    },
    "currency": {
      "type": "string",
      "description": "Currency code for returned prices (e.g., USD, EUR, GBP). Default is USD"
    },
    "children": {
      "type": "number",
      "default": 0,
      "description": "Number of children. Default is 0"
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "LOWEST_PRICE",
        "HIGHEST_RATING",
        "MOST_REVIEWED",
        3,
        8,
        13
      ],
      "description": "Sort order: 3 = Lowest price, 8 = Highest rating, 13 = Most reviewed. Default is 3 (Lowest price)"
    },
    "min_price": {
      "type": "number",
      "description": "Minimum price per night in specified currency (e.g., 50 for $50/night)"
    },
    "max_price": {
      "type": "number",
      "description": "Maximum price per night in specified currency (e.g., 200 for $200/night)"
    },
    "rating": {
      "type": "string",
      "enum": [
        "THREE_FIVE_PLUS",
        "FOUR_PLUS",
        "FOUR_FIVE_PLUS",
        7,
        8,
        9
      ],
      "description": "Minimum rating filter: 7 = 3.5+ stars, 8 = 4+ stars, 9 = 4.5+ stars"
    },
    "hotel_class": {
      "type": "string",
      "enum": [
        "TWO_STAR",
        "THREE_STAR",
        "FOUR_STAR",
        "FIVE_STAR",
        2,
        3,
        4,
        5
      ],
      "description": "Hotel star class: 2 = 2-star, 3 = 3-star, 4 = 4-star, 5 = 5-star"
    },
    "free_cancellation": {
      "type": "boolean",
      "description": "Set to true to show only hotels with free cancellation"
    },
    "vacation_rentals": {
      "type": "boolean",
      "description": "Set to true to show vacation rentals like Airbnb, Vrbo, etc."
    },
    "amenities": {
      "type": "string",
      "description": "Required amenities separated by comma. Options include: free_breakfast, free_wifi, pool, spa, pet_friendly, air_conditioning, gym, restaurant, kitchen, accessible, parking, airport_shuttle, washer_dryer"
    },
    "hotel_ids": {
      "type": "string",
      "description": "Specific hotel IDs to include, separated by comma (obtained from previous search results)"
    },
    "exclude_hotel_ids": {
      "type": "string",
      "description": "Hotel IDs to exclude, separated by comma"
    },
    "property_types": {
      "type": "string",
      "description": "Property types to include, separated by comma. Options: hotel, motel, home, apartment, hostel, resort, vacation_home, villa, ryokan, inn, aparthotel, cottage, guest_house, chalet, bed_breakfast, campground, boat, condominium, guest_suite, capsule_hotel, farm_stay"
    },
    "no_cache": {
      "type": "boolean",
      "default": false,
      "description": "Set to true to disable caching and force fresh results. Default is false. Cannot be used with async parameter"
    }
  },
  "required": [
    "q",
    "check_in_date",
    "check_out_date"
  ]
}

---

search_news

Search for current news articles and stories from various sources with filtering by date range, category, and geographic location for comprehensive news research

Parameters:

Parameter	Type	Required	Default	Description
q	string	Yes	—	News search query (e.g., “artificial intelligence”, “climate change”, “tech industry”)
gl	string	No	—	Country code for news sources (e.g., us for United States, uk for United Kingdom, fr for France)
hl	string	No	—	Language code for news articles (e.g., en for English, es for Spanish, fr for French)
location	string	No	—	Geographic location for local news (e.g., “United States”, “New York, NY”, “London, England”)
topic	string	No	—	News topic for filtering. Options: WORLD, NATION, BUSINESS, TECHNOLOGY, ENTERTAINMENT, SPORTS, SCIENCE, HEALTH
time_period	string	No	—	Time period for news articles. Options: “h” (past hour), “d” (past day), “w” (past week), “m” (past month), “y” (past year)
sort_by	string	No	—	Sort order for news results. Options: “date” (most recent first, default), “relevance” (most relevant first)
num	number	No	10	Maximum number of results to return (e.g., 10 (default), 20, 50). May introduce latency and is not guaranteed to return exact number specified
no_cache	boolean	No	false	Set to true to disable caching and force fresh results. Default is false. Cannot be used with async parameter

Show inputSchema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "News search query (e.g., \"artificial intelligence\", \"climate change\", \"tech industry\")"
    },
    "gl": {
      "type": "string",
      "description": "Country code for news sources (e.g., us for United States, uk for United Kingdom, fr for France)"
    },
    "hl": {
      "type": "string",
      "description": "Language code for news articles (e.g., en for English, es for Spanish, fr for French)"
    },
    "location": {
      "type": "string",
      "description": "Geographic location for local news (e.g., \"United States\", \"New York, NY\", \"London, England\")"
    },
    "topic": {
      "type": "string",
      "description": "News topic for filtering. Options: WORLD, NATION, BUSINESS, TECHNOLOGY, ENTERTAINMENT, SPORTS, SCIENCE, HEALTH"
    },
    "time_period": {
      "type": "string",
      "description": "Time period for news articles. Options: \"h\" (past hour), \"d\" (past day), \"w\" (past week), \"m\" (past month), \"y\" (past year)"
    },
    "sort_by": {
      "type": "string",
      "description": "Sort order for news results. Options: \"date\" (most recent first, default), \"relevance\" (most relevant first)"
    },
    "num": {
      "type": "number",
      "default": 10,
      "description": "Maximum number of results to return (e.g., 10 (default), 20, 50). May introduce latency and is not guaranteed to return exact number specified"
    },
    "no_cache": {
      "type": "boolean",
      "default": false,
      "description": "Set to true to disable caching and force fresh results. Default is false. Cannot be used with async parameter"
    }
  },
  "required": [
    "q"
  ]
}

---

search_academic

Search academic and scholarly resources including research papers, journals, patents, and legal documents with advanced filtering by publication date, source type, and citation metrics

Parameters:

Parameter	Type	Required	Default	Description
q	string	Yes	—	Academic search query (e.g., “machine learning algorithms”, “quantum computing”, “CRISPR gene editing”)
as_ylo	string	No	—	Starting year for publication date range (e.g., “2020”)
as_yhi	string	No	—	Ending year for publication date range (e.g., “2024”)
scisbd	number	No	—	Sort by date: 0 = relevance (default), 1 = date (newest first)
cluster	string	No	—	Cluster ID to retrieve specific versions/citations of a paper (obtained from previous search results)
hl	string	No	—	Language code for results (e.g., en for English, es for Spanish, fr for French)
lr	string	No	—	Language restriction: “lang_en” for English, “lang_es” for Spanish, “lang_fr” for French, etc.
start	number	No	0	Pagination offset to retrieve more results (0 for first page, 10 for second page, etc.)
num	number	No	10	Number of results per page (default: 10, max: 20)
as_sdt	string	No	—	Include patents/citations: “0,5” includes patents, “0,5,33” includes citations
safe	string	No	—	SafeSearch setting: “off” (default), “active”, “images”
filter	string	No	—	Result filtering: “0” includes duplicate/omitted results, “1” (default) excludes them
as_vis	string	No	—	Include citations: “0” (default) excludes citations, “1” includes citations
no_cache	boolean	No	false	Set to true to disable caching and force fresh results. Default is false. Cannot be used with async parameter

Show inputSchema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Academic search query (e.g., \"machine learning algorithms\", \"quantum computing\", \"CRISPR gene editing\")"
    },
    "as_ylo": {
      "type": "string",
      "description": "Starting year for publication date range (e.g., \"2020\")"
    },
    "as_yhi": {
      "type": "string",
      "description": "Ending year for publication date range (e.g., \"2024\")"
    },
    "scisbd": {
      "type": "number",
      "description": "Sort by date: 0 = relevance (default), 1 = date (newest first)"
    },
    "cluster": {
      "type": "string",
      "description": "Cluster ID to retrieve specific versions/citations of a paper (obtained from previous search results)"
    },
    "hl": {
      "type": "string",
      "description": "Language code for results (e.g., en for English, es for Spanish, fr for French)"
    },
    "lr": {
      "type": "string",
      "description": "Language restriction: \"lang_en\" for English, \"lang_es\" for Spanish, \"lang_fr\" for French, etc."
    },
    "start": {
      "type": "number",
      "default": 0,
      "description": "Pagination offset to retrieve more results (0 for first page, 10 for second page, etc.)"
    },
    "num": {
      "type": "number",
      "default": 10,
      "description": "Number of results per page (default: 10, max: 20)"
    },
    "as_sdt": {
      "type": "string",
      "description": "Include patents/citations: \"0,5\" includes patents, \"0,5,33\" includes citations"
    },
    "safe": {
      "type": "string",
      "description": "SafeSearch setting: \"off\" (default), \"active\", \"images\""
    },
    "filter": {
      "type": "string",
      "description": "Result filtering: \"0\" includes duplicate/omitted results, \"1\" (default) excludes them"
    },
    "as_vis": {
      "type": "string",
      "description": "Include citations: \"0\" (default) excludes citations, \"1\" includes citations"
    },
    "no_cache": {
      "type": "boolean",
      "default": false,
      "description": "Set to true to disable caching and force fresh results. Default is false. Cannot be used with async parameter"
    }
  },
  "required": [
    "q"
  ]
}

---

search_restaurants

Search for restaurants and dining establishments with detailed information including ratings, cuisine types, pricing, hours, and reservation options for comprehensive dining research

Parameters:

Parameter	Type	Required	Default	Description
q	string	Yes	—	Restaurant search query (e.g., “Italian restaurants in San Francisco”, “best sushi downtown”)
ll	string	No	—	Geographic coordinates for location-based search as “@latitude,longitude” (e.g., “@37.7749,-122.4194” for San Francisco)
location	string	No	—	City or location for restaurant search (e.g., “New York, NY”, “Los Angeles, CA”)
hl	string	No	—	Language code for results (e.g., en for English, es for Spanish, fr for French)
gl	string	No	—	Country code for search (e.g., us for United States, uk for United Kingdom)
rating	number	No	—	Minimum rating filter (1-5 stars). For example, 4 returns restaurants rated 4.0 and above
price_level	string	No	—	Price level filter: “1” ($), “2” (), "3" ($$$), "4" ($$$$). Can combine multiple levels as comma-separated (e.g., "2,3" for and $$$)
open_now	boolean	No	—	Set to true to show only restaurants currently open
cuisine_type	string	No	—	Filter by cuisine type (e.g., “italian”, “japanese”, “mexican”, “chinese”, “american”)
no_cache	boolean	No	false	Set to true to disable caching and force fresh results. Default is false. Cannot be used with async parameter

Show inputSchema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Restaurant search query (e.g., \"Italian restaurants in San Francisco\", \"best sushi downtown\")"
    },
    "ll": {
      "type": "string",
      "description": "Geographic coordinates for location-based search as \"@latitude,longitude\" (e.g., \"@37.7749,-122.4194\" for San Francisco)"
    },
    "location": {
      "type": "string",
      "description": "City or location for restaurant search (e.g., \"New York, NY\", \"Los Angeles, CA\")"
    },
    "hl": {
      "type": "string",
      "description": "Language code for results (e.g., en for English, es for Spanish, fr for French)"
    },
    "gl": {
      "type": "string",
      "description": "Country code for search (e.g., us for United States, uk for United Kingdom)"
    },
    "rating": {
      "type": "number",
      "description": "Minimum rating filter (1-5 stars). For example, 4 returns restaurants rated 4.0 and above"
    },
    "price_level": {
      "type": "string",
      "description": "Price level filter: \"1\" ($), \"2\" ($$), \"3\" ($$$), \"4\" ($$$$). Can combine multiple levels as comma-separated (e.g., \"2,3\" for $$ and $$$)"
    },
    "open_now": {
      "type": "boolean",
      "description": "Set to true to show only restaurants currently open"
    },
    "cuisine_type": {
      "type": "string",
      "description": "Filter by cuisine type (e.g., \"italian\", \"japanese\", \"mexican\", \"chinese\", \"american\")"
    },
    "no_cache": {
      "type": "boolean",
      "default": false,
      "description": "Set to true to disable caching and force fresh results. Default is false. Cannot be used with async parameter"
    }
  },
  "required": [
    "q"
  ]
}

---

search_local_events

Discover local events, activities, and happenings in a specific area including concerts, exhibitions, festivals, workshops, and community gatherings with detailed event information

Parameters:

Parameter	Type	Required	Default	Description
q	string	Yes	—	Event search query (e.g., “concerts this weekend”, “art exhibitions”, “tech meetups”, “food festivals”)
location	string	Yes	—	City or location for event search (e.g., “San Francisco, CA”, “New York, NY”, “London, England”)
ll	string	No	—	Geographic coordinates for precise location as “@latitude,longitude” (e.g., “@37.7749,-122.4194”)
hl	string	No	—	Language code for results (e.g., en for English, es for Spanish, fr for French)
gl	string	No	—	Country code for search (e.g., us for United States, uk for United Kingdom)
start_date	string	No	—	Filter events starting from this date in YYYY-MM-DD format
end_date	string	No	—	Filter events ending by this date in YYYY-MM-DD format
category	string	No	—	Event category filter (e.g., “music”, “art”, “sports”, “food”, “technology”, “business”)
no_cache	boolean	No	false	Set to true to disable caching and force fresh results. Default is false. Cannot be used with async parameter

Show inputSchema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Event search query (e.g., \"concerts this weekend\", \"art exhibitions\", \"tech meetups\", \"food festivals\")"
    },
    "location": {
      "type": "string",
      "description": "City or location for event search (e.g., \"San Francisco, CA\", \"New York, NY\", \"London, England\")"
    },
    "ll": {
      "type": "string",
      "description": "Geographic coordinates for precise location as \"@latitude,longitude\" (e.g., \"@37.7749,-122.4194\")"
    },
    "hl": {
      "type": "string",
      "description": "Language code for results (e.g., en for English, es for Spanish, fr for French)"
    },
    "gl": {
      "type": "string",
      "description": "Country code for search (e.g., us for United States, uk for United Kingdom)"
    },
    "start_date": {
      "type": "string",
      "description": "Filter events starting from this date in YYYY-MM-DD format"
    },
    "end_date": {
      "type": "string",
      "description": "Filter events ending by this date in YYYY-MM-DD format"
    },
    "category": {
      "type": "string",
      "description": "Event category filter (e.g., \"music\", \"art\", \"sports\", \"food\", \"technology\", \"business\")"
    },
    "no_cache": {
      "type": "boolean",
      "default": false,
      "description": "Set to true to disable caching and force fresh results. Default is false. Cannot be used with async parameter"
    }
  },
  "required": [
    "q",
    "location"
  ]
}

---

search_googlesearch

Perform comprehensive Google web searches with advanced filtering options including safe search, language preferences, date ranges, and site-specific searches for thorough web research

Parameters:

Parameter	Type	Required	Default	Description
q	string	Yes	—	Google search query (e.g., “artificial intelligence trends 2024”, “best programming languages”)
gl	string	No	—	Country code for Google search (e.g., us for United States, uk for United Kingdom, fr for France)
hl	string	No	—	Language code for interface and results (e.g., en for English, es for Spanish, fr for French)
location	string	No	—	Geographic location for results (e.g., “United States”, “California”, “San Francisco, CA”)
tbs	string	No	—	Time-based search: “qdr:h” (past hour), “qdr:d” (past day), “qdr:w” (past week), “qdr:m” (past month), “qdr:y” (past year)
lr	string	No	—	Language restriction: “lang_en” for English, “lang_es” for Spanish, “lang_fr” for French, etc.
safe	string	No	—	SafeSearch setting: “off” (default), “active”
filter	string	No	—	Result filtering: “0” includes duplicate/omitted results, “1” (default) excludes them
site	string	No	—	Restrict results to a specific site or domain (e.g., “reddit.com”, “github.com”)
filetype	string	No	—	Search for specific file types (e.g., “pdf”, “doc”, “ppt”, “xls”)
linksto	string	No	—	Find pages that link to a specific URL (e.g., “example.com”)
related	string	No	—	Find sites related to a specific URL (e.g., “example.com”)
start	number	No	0	Pagination offset for retrieving more results (0 for first page, 10 for second page, etc.)
num	number	No	10	Maximum number of results to return (e.g., 10 (default), 40, 100). May introduce latency and is not guaranteed to return exact number specified
device	string	No	—	Device type for the search: “desktop” (default), “tablet” (iPad), or “mobile” (iPhone)
no_cache	boolean	No	false	Set to true to disable caching and force fresh results. Default is false. Cannot be used with async parameter

Show inputSchema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Google search query (e.g., \"artificial intelligence trends 2024\", \"best programming languages\")"
    },
    "gl": {
      "type": "string",
      "description": "Country code for Google search (e.g., us for United States, uk for United Kingdom, fr for France)"
    },
    "hl": {
      "type": "string",
      "description": "Language code for interface and results (e.g., en for English, es for Spanish, fr for French)"
    },
    "location": {
      "type": "string",
      "description": "Geographic location for results (e.g., \"United States\", \"California\", \"San Francisco, CA\")"
    },
    "tbs": {
      "type": "string",
      "description": "Time-based search: \"qdr:h\" (past hour), \"qdr:d\" (past day), \"qdr:w\" (past week), \"qdr:m\" (past month), \"qdr:y\" (past year)"
    },
    "lr": {
      "type": "string",
      "description": "Language restriction: \"lang_en\" for English, \"lang_es\" for Spanish, \"lang_fr\" for French, etc."
    },
    "safe": {
      "type": "string",
      "description": "SafeSearch setting: \"off\" (default), \"active\""
    },
    "filter": {
      "type": "string",
      "description": "Result filtering: \"0\" includes duplicate/omitted results, \"1\" (default) excludes them"
    },
    "site": {
      "type": "string",
      "description": "Restrict results to a specific site or domain (e.g., \"reddit.com\", \"github.com\")"
    },
    "filetype": {
      "type": "string",
      "description": "Search for specific file types (e.g., \"pdf\", \"doc\", \"ppt\", \"xls\")"
    },
    "linksto": {
      "type": "string",
      "description": "Find pages that link to a specific URL (e.g., \"example.com\")"
    },
    "related": {
      "type": "string",
      "description": "Find sites related to a specific URL (e.g., \"example.com\")"
    },
    "start": {
      "type": "number",
      "default": 0,
      "description": "Pagination offset for retrieving more results (0 for first page, 10 for second page, etc.)"
    },
    "num": {
      "type": "number",
      "default": 10,
      "description": "Maximum number of results to return (e.g., 10 (default), 40, 100). May introduce latency and is not guaranteed to return exact number specified"
    },
    "device": {
      "type": "string",
      "description": "Device type for the search: \"desktop\" (default), \"tablet\" (iPad), or \"mobile\" (iPhone)"
    },
    "no_cache": {
      "type": "boolean",
      "default": false,
      "description": "Set to true to disable caching and force fresh results. Default is false. Cannot be used with async parameter"
    }
  },
  "required": [
    "q"
  ]
}