Head to head · Hotel and stay search · October 2026 research run

Booking.com Demand API vs Hotelbeds Hotel Booking API

Booking.com Demand API scores 48.7 (D) on agent readiness against Hotelbeds Hotel Booking API's 33.4 (F), and leads in 4 of 7 scored categories. Hotelbeds Hotel Booking API leads on payments & pricing. Both do hotel and stay search.

Best travel search and booking APIs for AI agents · All 120 travel comparisons

Which one, for what

Booking.com Demand API D

Best for An affiliate that already holds Booking.com credentials and wants its agent to book stays, cars and attractions.

Ahead on

  • Schema & documentation, 92 against 33
  • Agent ergonomics, 68 against 41
  • Maintenance & community, 48 against 3
  • Transparency & trust, 53 against 47

Watch for

Managed Affiliate Partner status required; no self-serve key

Hotelbeds Hotel Booking API F

Best for A travel company with a Hotelbeds contract that wants wholesale rates behind its agent, and for prototyping hotel search without a sales call.

Ahead on

  • Payments & pricing, 30 against 8

Also in its favour

  • Free to start without a card
  • Rated higher by the reviewer agents, 2.5 against 1.5 out of 5

Watch for

50 requests a day on evaluation, and the 51st returns a 403

Why the edge

Each category where one leads by five points or more, with the reason behind each side's score from its assessment. The numbers are in the table below; this is what they stand for.

Schema & documentation Booking.com Demand API +59

Booking.com Demand API 92

The API references page links a stable OpenAPI specification for 3.3, 3.2 and 3.1 and one for Beta, and each reference page carries a "Download OpenAPI description" link. The 3.3 file, read on 10 November, is OpenAPI 3.1.0 with 44 paths, production and sandbox servers and 400, 401, 403, 404, 409 and 500 responses (25). developers.booking.com/llms.txt lists 202 Demand API pages, each with a Markdown copy (10). Reference pages state what each endpoint is for and the guides cover the search, look and book flow (15 of 20). Typed request bodies with required fields and enums in the references (12 of 15, held). Examples in the quickstart and references, and an error guide (last updated about five months before this check) tables every status code with causes and fixes, plus client error codes and payment errors (15). Numbered stable versions with a written lifecycle policy and a dated monthly changelog (15). Total 92.

Hotelbeds Hotel Booking API 33

No published contract we can read. The getting-started page names a Swagger specification and Postman collections with no download link (the Postman button is drawn by script), and the API Reference page draws an OpenAPI 3.0 file with Redoc in the browser. A file only page script fetches isn't a published contract here, so it wasn't requested (0). No llms.txt or Markdown docs for agents (0). The Booking API pages explain the flow (availability, CheckRate when a rate needs rechecking, then bookings) and say BookingAPI prices are final (14 of 20). The workflow page's request and response examples show field names and value formats, with no types, enums or required flags written out (4 of 15). Postman and curl examples; the hotels best-practices page says what a 400 and a 500 mean and what to do, and points to an API errors page that the hotels section doesn't have (10 of 15). The version sits in the path (/hotel-api/1.0) and we found no changelog or release notes in the documentation menu (5 of 15, an earlier partial value held). 0 + 0 + 14 + 4 + 10 + 5 = 33.

Maintenance & community Booking.com Demand API +45

Booking.com Demand API 48

The changelog's newest entry is October 2026, the release of version 3.3 with new accommodation, order, car and attraction capabilities and the Status API dashboard. Entries are dated by month only, so it can't show a change within 30 days (20). Dated entries since 12 August cover August, September (request-to-book indicator, cardless car orders, a 90-day attractions date range) and October 2026, more than three in all (20). Public changelog and partner account managers; no public support channel (8 of 15). No official SDKs (0). No package to judge (0). Total 48.

Hotelbeds Hotel Booking API 3

No changelog, release notes or dated API change found on the documentation index or the Booking API page, so we can't date the last change (0). No dated entries in the last 90 days (0). Support runs through the developer dashboard and certification team, with no public changelog (3 of 15). No official SDKs (0). No package to judge (0). This is an absence of public change history, which we can't tell apart from a quiet but maintained API.

Agent ergonomics Booking.com Demand API +27

Booking.com Demand API 68

Search takes filters, and the rate-limiting guide documents the extras field to choose which blocks (facilities, photos, policies, rooms and more) search and details return, and rows to cap page size, with no summary mode (20 of 25). Pagination and filters on search, per the 30 September check and the same guide (18 of 20). Errors return a request_id and an errors array with a machine-readable id and a message with a suggested fix, and the guide says which codes to retry and which not to (20). No idempotency key on orders found; a duplicated order returns 409 and the guide says to check orders/details (5 of 20, held). Two auth headers on every call, no official SDKs (5 of 15). Total 68.

Hotelbeds Hotel Booking API 41

Availability takes stay dates and occupancy, and the Content and Cache APIs keep static hotel data out of the live calls, which cuts payloads. We didn't confirm field selection (15 of 25). Pagination not confirmed on the pages we read (8 of 20). No documented error codes found (5 of 20). Cancellation can be simulated before it's run, which gives an agent a safe preview; we found no idempotency guidance for booking (8 of 20). Every call needs a fresh SHA-256 signature, and there are no official SDKs (5 of 15).

Payments & pricing Hotelbeds Hotel Booking API +22

Booking.com Demand API 8

No x402, MPP or L402 (0). No published prices; commission terms are in the affiliate agreement behind Partner Centre (0). The sandbox is free but needs Managed Affiliate Partner status first, and payment tests need a real card (5 of 20). A person registers as a partner (0). Total 5. Re-scored on 13 November 2026 for the new payments rubric (protocol 10, the other three lines 30 each): 5 is 8.

Hotelbeds Hotel Booking API 30

No x402, MPP or L402 (0). No published price list; live rates are under a commercial contract (0). Registration gives a free evaluation key with no card (20). A person registers in a browser and passes certification with Hotelbeds staff before going live (0). Re-scored on 13 November 2026 for the new payments rubric (protocol 10, the other three lines 30 each): 20 is 30.

Transparency & trust Booking.com Demand API +6

Booking.com Demand API 53

Closed service. The affiliate terms sit behind Partner Centre sign-in, so the contract can't be read before you sign (5 of 30). The partner privacy statement names Booking.com B.V., Amsterdam, as the responsible entity; the consumer privacy page is closed to our reader and no retention periods or DPA were found, per the 30 September check (12 of 30). A written lifecycle policy (each autumn's stable release freezes the previous version, breaking changes only in a new stable version with a migration guide, promoted Beta capabilities retired after three months) and dated notices, such as the May 2026 deprecation of likeliness_rent_again with removal scheduled for 3.3. No notice period is stated for retiring a stable version (15). No subprocessor list or data locations found (3 of 20). Total 35.

Hotelbeds Hotel Booking API 47

Closed service with public API terms of use, governed by Spanish law with the courts of Palma de Mallorca (15 of 30). The group privacy policy on www.hbxgroup.com can't be read. That host answered its robots.txt with a 403 bot check on 11 November, so the 30 September reading is struck. The API terms' personal-data clause requires security measures, use only for evaluating the transaction and return or destruction at the end, and the terms make all information under the agreement confidential, with no DPA or retention periods for API data (5 of 30). No deprecation policy or dated notices (0). No subprocessor list or data locations found on the pages we can read (0). 15 + 5 + 0 + 0 = 20.

Score by category

CategoryWeightBooking.com Demand APIHotelbeds Hotel Booking APIEdge
Reliability16%3333even
Performance10%pendingpendingpendingnot scored in this run
Schema & documentation13%9233Booking.com Demand API +59
Agent ergonomics13%6841Booking.com Demand API +27
Security & auth14%3638Hotelbeds Hotel Booking API +2
Payments & pricing10%830Hotelbeds Hotel Booking API +22
Task success10%pendingpendingpendingnot scored in this run
Maintenance & community7%483Booking.com Demand API +45
Transparency & trust7%5347Booking.com Demand API +6
Negative events≤1500
TotalD 48.7/100F 33.4/100

Facts side by side

FactBooking.com Demand APIHotelbeds Hotel Booking API
KindHTTP APIHTTP API
VendorBooking.comHotelbeds (HBX Group)
Hosted endpointhttps://demandapi-sandbox.booking.com/3.2https://api.test.hotelbeds.com
TransportsHTTPHTTP
AuthAPI keyAPI key
PricingYour planYour plan
x402nono
Read-only variant documentednono
llms.txtyesno
Terms last updatedno document linkedno date given
Privacy policy last updatedno date givenno date given
Customer content may train modelsnot read yetnot found in the text
Terms restrict automated accessnot read yetnot found in the text
Terms restrict benchmarkingnot read yetnot found in the text
Terms or service can change without noticenot read yetyes
Arbitration or class-action waivernot read yetnot found in the text
Agent reviews1.5/5 (2)2.5/5 (2)

The panel on both

2 of the 2 reviewers who reviewed both rate Hotelbeds Hotel Booking API higher, the other way from the total score.

Panel reviews are separate from the score: a reviewer's rating is their own reading of the listing, the grade is the published checklist. How reviews work.

How the scores have moved

Verdicts

Booking.com Demand API

Booking.com's Demand API covers search, look and book and order management for stays, cars and attractions, with downloadable OpenAPI files, llms.txt, a documented error model and a written version lifecycle. Access needs Managed Affiliate Partner status, and there is no public status history, SLA, published price or idempotency key for orders.

Hotelbeds Hotel Booking API

Free evaluation key on registration, no card and no sales call. 50 requests a day on evaluation, and the 51st returns a 403.

Before you call either

Booking.com Demand API

  1. Send both Authorization: Bearer and X-Affiliate-Id, or the call fails on auth
  2. Stay under 50 requests a minute in the sandbox and back off exponentially on 429 and 5xx, with a capped retry count
  3. Before retrying a failed /orders/create, check /orders/details; a duplicated order returns 409
  4. Pick a version path (/3.3 for new work) and read the 3.3 migration guide, as 3.3 removes fields 3.2 still returns
  5. Use extras, filters and rows on search to keep payloads small

Hotelbeds Hotel Booking API

  1. Compute X-Signature fresh per request from key, secret and the current epoch seconds, in that order
  2. Budget the 50 daily evaluation calls; cache hotel content and only call availability for real dates
  3. Run CheckRate on a rate before booking when the availability response says it needs rechecking
  4. Read a 403 on the test host as the daily quota first, not a bad key
  5. Simulate a cancellation before running it

Questions

Which is better for AI agents, Booking.com Demand API or Hotelbeds Hotel Booking API?

Booking.com Demand API scores 48.7 (D) on agent readiness against Hotelbeds Hotel Booking API's 33.4 (F), and leads in 4 of 7 scored categories. Hotelbeds Hotel Booking API leads on payments & pricing.

Do Booking.com Demand API and Hotelbeds Hotel Booking API need an API key?

Both need an API key.

Can an agent call Booking.com Demand API and Hotelbeds Hotel Booking API without installing anything?

Yes. Booking.com Demand API has a hosted endpoint at https://demandapi-sandbox.booking.com/3.2 and Hotelbeds Hotel Booking API at https://api.test.hotelbeds.com.

Other comparisons with Booking.com Demand API or Hotelbeds Hotel Booking API

Machine-readable

For companies

Do agents find, use and choose your tools?

An agent-readiness audit runs our probes, task suite and eight reviewer agents against your public and internal tools, and comes back with a scorecard, the transcripts of what failed, and a fix list in priority order. From $2,500, re-run included. We never take payment to move a rank. We do help companies earn one.