Hotel
Learn the common fields for hotel and accommodation PDP endpoints and example domains.
Hotel PDP Cache agents extract structured data from hotel and accommodation detail pages, including property info, pricing, reviews, facilities, room types, and nearby points of interest.
Description
Hotel agents return normalized fields for hotels, apartments, and homestays: name, description, address, location, coordinates, star rating, check-in/out, contact, host info, pricing, review stats and highlights, individual reviews, popular facilities, facilities by category, policies, room types with prices, and nearby locations (airports, culinary, shopping, hospitals, landmarks, attractions, transport, etc.).
Common Fields
| Field | Type | Description |
|---|---|---|
name | string | Hotel or accommodation name |
about | string | Description and overview of the property |
address | string | Full street address |
location | string | City, area, or region name |
coordinates | object | latitude (number), longitude (number) |
stars | number | Star rating of the property (1–5) |
year_opened | number | Year the property was opened |
check_in | string | Check-in time instructions |
check_out | string | Check-out time instructions |
contact | object | email (string), phone (string) |
host | object | name, joined, response_time (for homestays/apartments) |
pricing | object | currency, original_price, starting_price, discounted_price |
review_stats | object | overall_score, total_reviews, score_breakdown, category_summaries |
highlights | array | Key selling points (strings) |
review_highlights | array | Snippets of positive feedback (strings) |
reviews | array | Objects: date, title, rating, content, country, reviewer, room_type, trip_type, stay_duration |
popular_facilities | array | Flat list of popular facilities (strings) |
facilities | object | dining, internet, services, recreation, room_amenities, transportation, access_and_security, cleanliness_and_safety (each array of strings) |
policies | object | pets, deposit, smoking, children, breakfast, cancellation, check_in_instructions |
room_types | array | Objects: name, size, prices (with adults, kids, price_total, breakfast_included, cancellation_policy, etc.), bed_type, features |
location_nearby | object | airports, culinary, shopping, hospitals, landmarks, attractions, cash_withdrawal, public_transport, convenience_stores (each array of { name, distance }) |
Example Domains / URLs
Hotel PDP agents are typically available for major booking and travel domains, for example:
- Booking.com — e.g.
https://www.booking.com/hotel/... - Expedia — e.g.
https://www.expedia.com/... - Agoda — e.g.
https://www.agoda.com/... - Trip.com — e.g.
https://www.trip.com/... - Hotels.com — e.g.
https://www.hotels.com/...
Check the Marketplace for the full list of supported hotel domains.