Search API 2.0

Introduction

The Search API provides rates and availability for all room types at specified hotels based on your search criteria and any additional parameters you may need.

Search 2.0 is our next-generation, context-driven Search API designed to simplify integration while maximizing access to rates. With Search 2.0, you can retrieve rates across user segments, channels, and countries through a single Site ID integration.

Key benefits

With the previous version of Search API, accessing different channels required managing multiple Site IDs across integrations. Search 2.0 eliminates this by letting you fetch rates for any channel, user group, or country through a single API call, reducing configuration overhead and ongoing maintenance.
Context-aware targeting ensures users see the most relevant travel options, supporting higher conversion rates.
Because Search 2.0 is built to scale, adding new channels, user segments, or extended length-of-stay options requires no structural changes.

API details

Item	Description
Endpoint URL:	`https://{{baseURL}}/api/v5/properties/availability`
Authorization:	You need to use OAuth 2.0 with Search 2.0 requests.

Scenario-based usage of search (targeted vs. bulk)

This API supports capabilities to search rates for both targeted and bulk (cached) rate searches, enabling flexible implementation tailored to your business needs.
- Single-context usage: This is a customer-driven search where the user is browsing live for rates. Since you know the customer, you can explicitly specify the context for the rates you want to be returned in the search results for the current user. Refer to the Search rates for single-context usage section to learn more.
- Multi-context usage: This is a search to fetch all available rates. Refer to the Search rates for multi-context usage section to learn more.
Note that this behavior-driven search does not affect the rates that you shop. It will only filter your search results based on the usage context.