hotels_search()

Create a Google Hotels tool with explicit stay dates.

Usage

Source

hotels_search(
    *,
    provider="auto",
    include_examples=True,
    api_key=None,
    client=None,
    default_params=None,
    timeout=None,
    mode=SearchResultMode.COMPACT,
    response_format=SearchResultFormat.MARKDOWN,
    result_limit=20,
    name="hotels_search"
)

The returned tool requires query, check_in_date, and check_out_date. It also exposes typed adult, child, and child-age fields.

Parameters

provider: ProviderName | str = "auto"

Agent SDK adapter name, "auto", or "function".

include_examples: bool = True

Add a short call example to the model-facing description.

api_key: str | None = None

Runtime authentication, custom client, application filters, timeout, and response mode and serialization selection.

client: str | None = None

Runtime authentication, custom client, application filters, timeout, and response mode and serialization selection.

default_params: str | None = None

Runtime authentication, custom client, application filters, timeout, and response mode and serialization selection.

timeout: str | None = None

Runtime authentication, custom client, application filters, timeout, and response mode and serialization selection.

mode: str | None = None

Runtime authentication, custom client, application filters, timeout, and response mode and serialization selection.

response_format: str | None = None

Runtime authentication, custom client, application filters, timeout, and response mode and serialization selection.

result_limit: int | None = 20

Maximum items kept in each result list in both response modes; use None to keep all returned results.

name: str = "hotels_search"

Tool name presented to the model.

Returns

Any

A provider-native Google Hotels tool with a closed input schema.