Bulk-load and incrementally sync static Hotelbeds hotel content (descriptions, images, facilities) via the Content API, kept separate from the Booking API's live pricing/availability.

domain: developer.hotelbeds.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Authenticate every request with an Api-key header plus an X-Signature header — a SHA256 hex digest of (Api-Key + Secret + current Unix timestamp in seconds) — against the test endpoint https://api.test.hotelbeds.com.
  2. Paginate through GET /hotel-content-api/1.0/hotels?fields=all&language=ENG&from=1&to=1000 in batches of up to 1000 hotels (from/to) to bootstrap your local content database.
  3. Also pull the companion master-data operations you need to resolve coded fields returned in the Hotels response: Countries, Destinations, Rooms, Boards, Accommodations, Categories, Chains, Facilities, Facility Groups, Issues, Languages, Promotions, Segments, Images.
  4. Repeat the whole load once per language you support, since descriptive text fields are language-dependent.
  5. For ongoing sync, call the Hotels endpoint again (recommended daily) adding &lastUpdateTime=<date> to fetch only hotels changed since that date instead of a full re-pull.
  6. Keep this static data in your own store and get dynamic data (prices, availability, cancellation policies, fees) only from the separate Booking API — never call the Content API in real time per booking request.

Known gotchas

Related routes

Retrieve Expedia Rapid hotel property content (descriptions, amenities, photos) separately from availability/pricing, and keep a local content cache in sync.
developers.expediagroup.com · 6 steps · unrated
Sync bookings, calendars, and guest messages for a vacation rental using the Lodgify API
docs.lodgify.com · 5 steps · unrated
Retrieve hotel property content via Booking.com Content API using OTA_HotelDescriptiveInfo
developers.booking.com/connectivity · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans