Shopping
The Shopping API provides you with access to live rates and availability for over 700,000 properties globally
Shop
Returns rates and availability on all room types for specified properties (maximum of 250 properties per request). The response includes rate details such as promos, whether the rate is refundable, cancellation penalties, and a full price breakdown to meet the price display requirements for your market.
Multiple rooms of the same type may be requested by including multiple instances of the occupancy
parameter. If the same occupancy is requested multiple times in the same request, the response will only contain a single set of rates for that occupancy. No more than 8 rooms may be requested at a time. If you need to book more than 8 rooms at once, please consult with your account manager about our group booking partnership.
Important price savings/discount information: When displaying a discount saving amount based off a promotion or strike through provided in the Availability and Price Check APIs, certain points of sale require details to be provided about the Standard Rate Price (i.e. the price the discount is calculated from). Please refer to the statements below on what terminology to use.
EU: Provide clear details about the Standard Rate Price, e.g. “This price is the standard rate provided by the property based on your search."
Italy: Use the following wording: “Questo prezzo è basato sulla tariffa generalmente applicabile fornita dalla struttura per questa camera e per queste date”.
Important Note on Loyalty Points: Loyalty Points are available with Rapid v3, partners will be able to identify and showcase loyalty eligibility prior to the capture of the membership details using the value_adds_info
and value_adds
fields in the Shop response.
Example 1:
Hotel rate eligible for loyalty points will have the following node in the search response under the amenities
node:
{
"id": "2096",
"name": "Hotel Loyalty Points"
}
Example 2:
Hotel rate not eligible for loyalty points will have the following node in the search response under the amenities
node:
{
"id": "-2096",
"name": "No Hotel Loyalty Points"
}
Important Content Notice: Rapid allows properties to update their content at any time. We require your best effort to provide the most up-to-date information to customers. The Shop API provides the most current information for available rooms and rates. To obtain additional property-level, room-level, and rate-level information not returned in this response, use our Property Content API.
APIs provide prices based on one room only, multiple room bookings require an additional calculation by yourself. As a part of launch requirements, your integration should display the detailed price breakdown to end users at certain steps in the booking journey. The breakdown can be found behind this secured documentation link.
Price Check
Confirms the price returned by the Shop response. Use this API to verify a previously-selected rate is still valid before booking. If the price is matched, the response returns a link to request a booking. If the price has changed, the response returns new price details and a booking link for the new price. If the rate is no longer available, the response will return a new shop request link to search again for different rates.
Payment Options
Returns the accepted payment options. Use this API to power your checkout page and display valid forms of payment, ensuring a smooth booking. Rates offered as Property Collect will return card types accepted by the property. All other rate types will return Expedia's accepted payment options.
Important Notes
language
only uses hyphenated pairs of two-digit language and country codes. Review our supported languages before integrating any codes.- The two-digit
country
codes set the traveler's point of sale, they do not affect localized content. - No static data (names, star ratings, geography information, etc.) is returned. Only availability and rate-related data is provided.
- Tokenized request links will expire after a short period. If a token link returns an HTTP 503 error, the link has likely expired. Obtain a new price check or deposit link from a fresh Shop response and attempt again. Do not store link values for long term re-use.
To perform test requests against this service, see our Test Request documentation.
Download the OpenAPI Spec (formerly Swagger) full description containing all APIs
Download the Rapid 3 Postman Collection