Booking.com

Booking.com Demand API

The Demand API is Booking.com's RESTful JSON API for affiliate partners: search and book accommodations, car rentals, attractions and transfers, preview and create orders, manage cancellations and modifications, and read reviews, locations, languages and payment constants. Version 3.2 is current; 3.1 remains published and a 3.2-Beta track carries attractions, transfers, smart search and the messaging endpoints.

Documentation GitHub OpenAPI

Operations 32

POST /accommodations/search Search #

POST /accommodations/availability Availability #

POST /accommodations/chains Chains #

POST /accommodations/constants Constants #

POST /accommodations/details Details #

POST /accommodations/details/changes Updates #

POST /accommodations/reviews Reviews #

POST /accommodations/reviews/scores Review and scores #

POST /accommodations/third-party-suppliers Third-party suppliers #

POST /cars/search Search car rentals #

POST /cars/constants Car constants #

POST /cars/depots Depots #

POST /cars/depots/reviews/scores Depot scores #

POST /cars/details Car details #

POST /cars/suppliers Suppliers #

POST /common/languages Retrieve language codes #

POST /common/locations/airports Airports #

POST /common/locations/cities Cities #

POST /common/locations/countries Countries #

POST /common/locations/districts Districts #

POST /common/locations/landmarks Landmarks #

POST /common/locations/regions Regions #

POST /common/payments/cards Retrieve payment cards #

POST /common/payments/currencies Retrieve currency codes #

POST /orders/preview Preview an order #

POST /orders/create Create an order #

POST /orders/details Orders details #

POST /orders/details/accommodations Orders with accommodation details #

POST /orders/details/cars Orders with car details #

POST /orders/details/flights Orders with flight details #

POST /orders/modify Modify an order #

POST /orders/cancel Cancel a travel service #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/booking-com-demand-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.1.0
info:
  title: Booking.com Demand API
  version: '3.2'
  summary: 'The Booking.com Demand API enables Affiliate Partners to access Booking.com''s travel inventory, including accommodations,
    car rentals, and flights. The version 3.2 introduces several improvements and breaking changes from version 3.1, including
    updates to **price structures**, inclusion of **Attractions and taxis in orders/details** for post-booking reporting,
    and other structural enhancements.


    - The API follows REST principles and returns data in **JSON** format.

    - You can access endpoints via **HTTPS POST** requests.


    Authentication: Use your Affiliate ID and token credentials to use these endpoints.


    [Check the Try out guide!](/demand/docs/getting-started/try-out-the-api)'
servers:
- url: https://demandapi.booking.com/3.2
  description: Production environment – use for live integrations.
- url: https://demandapi-sandbox.booking.com/3.2
  description: Sandbox environment – use for testing and validation.
security:
- BearerAuth: []
tags:
- name: Accommodations
  x-displayName: Accommodation
  description: This collection includes endpoints related to **stays** within the connected trip experience. <br/>Use these
    endpoints to:<br/>- Search for hotels, apartments, and other accommodation types.<br/>- Check real-time availability and
    pricing.<br/>- Retrieve property details and guest reviews.
- name: Cars
  x-displayName: Car rentals
  description: This collection includes endpoints related to **car rental** services within the connected trip experience.<br/>Use
    these endpoints to:<br/>- Search and retrieve car details.<br/>- Retrieve car specifications, depot locations, and supplier
    information.
- name: Common/locations
  x-displayName: Locations
  description: This collection provides standardised **location identifiers** for geographical entities such as airports,
    countries, cities, and regions. <br/>Use the returned identifiers when constructing requests across all travel services
    API collections, including both accommodation and car rental endpoints.
- name: Common/payments
  x-displayName: Payments
  description: Provides generic **payment-related identifiers**, including supported currency codes, payment cards, and relevant
    metadata for booking flows.<br/>- Use the returned identifiers when constructing requests across all travel services API
    collections, including both accommodation and car rental endpoints.
- name: Common/languages
  x-displayName: Languages
  description: Use this endpoint to retrieve a list of supported IETF language tag codes.<br/>- You can use these codes when
    constructing requests across all travel services API collections, including both accommodation and car rental endpoints.


# --- truncated at 32 KB (460 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/booking-com/refs/heads/main/openapi/booking-com-demand-api-3-2-openapi.yml