/web-search | Type: Embedded | PCID required: No
Tools
| Tool | Description |
|---|---|
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_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_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_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_hotels | Search for hotel accommodations and vacation rentals with comprehensive filtering options including price range, amenities, ratings, and location preferences |
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_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_restaurants | Search for restaurants and dining establishments with detailed information including ratings, cuisine types, pricing, hours, and reservation options for comprehensive dining research |
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_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_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
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_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
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
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_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
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
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_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
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"
]
}
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
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_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
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_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
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_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
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_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
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_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
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"
]
}