Skip to content

README.md

Latest commit

 

History

History
126 lines (78 loc) · 8.61 KB

README.md

File metadata and controls

126 lines (78 loc) · 8.61 KB
Raw

Booking.com API — search, availability & price data in one schema (2026)

Get a free API key → — free tier, no credit card.

Booking.com has no self-serve public API — Connectivity and Partner access is gated to approved partners. ScoutingAPI returns live Booking.com hotel search, availability, and pricing (this is hotel data, not appointment booking) in the same schema as Airbnb, Vrbo, and Google Hotels, with cross-OTA price-compare built in.

This repository is a resource hub for the modern Booking.com API: REST endpoints, working code samples in six languages, and recipes you can copy in under five minutes. It is not a maintained SDK (the official typed client is @scoutingapi/sdk) — it is a curated set of examples and references that match the machine contract at openapi.json. Every response is the same unified schema across Airbnb, Booking.com, Vrbo and Google Hotels, so one integration covers them all.

99.9% uptime SLA · Failed calls cost 0 credits · Native MCP for AI agents · One unified schema

Quick start

Search live Booking.com stays with one HTTPS call — a bearer token, no SDK, no partner approval.

curl -s "https://api.scoutingapi.com/v1/search" \
  -G --data-urlencode "location=Split, HR" \
  --data-urlencode "platforms=booking" \
  --data-urlencode "limit=5" \
  -H "Authorization: Bearer $SCOUTINGAPI_KEY" \
  | jq '.data[] | {platform, name, price}'

You get back the unified { "data": [...], "meta": {...} } envelope. Sign up for a free key, set SCOUTINGAPI_KEY, and the request runs as-is. Prefer to try before signing up? A scout_test_ sandbox key returns deterministic fixtures at zero cost.

What you can pull

The Booking.com data surface maps to these REST endpoints — each one HTTPS call, returning the unified schema, billed only on success:

  • Search — GET /v1/search — Cross-platform property discovery, merged into one schema.
  • Price — GET /v1/price — A real price quote for one listing, for your dates and occupancy.
  • Price compare — GET /v1/price-compare — Cross-OTA price comparison for one property — the flagship endpoint.
  • Availability — GET /v1/availability — Day-by-day availability for a known listing over a date window.
  • Listing — GET /v1/listing/{platform}/{id} — Full listing detail — amenities, photos, host, and optional live price.
  • Reviews — GET /v1/reviews — Normalized, paginated reviews for one listing.
  • Account — GET /v1/account — Check your plan, credit balance and rate limit — programmatically.

Full machine contract: openapi.json. Per-endpoint references: endpoints/.

Ready to try? Get a free ScoutingAPI key →.

What you can build

  • OTA & meta-search rate shopping — Pull Booking.com nightly rates for a property and date range and compare them against Airbnb, Vrbo, and Google in one schema — the rate-shopping view a single-platform API can’t give you.
  • Hotel competitive-rate monitoring — Track a hotel’s Booking.com price and guest rating against its competitive set for the same dates; surface where it’s under- or over-priced, day by day.
  • Market-rate intelligence — Aggregate live Booking.com search results across a destination to build ADR and availability signals for a real-time market view — hotels and short-term rentals together.
  • Availability monitoring & price-drop alerts — Poll /v1/availability for a Booking.com property and date range; fire a Slack, email, or Telegram alert on a change or a price drop — shippable from /workflows in minutes.
  • Travel-agent tooling & hotel-search agents — Give an AI agent a dependable hotel-search tool: “4-star apartment near Šibenik, July 13–20, 2 adults + 2 kids” → real, normalized Booking.com results via the native MCP server.
  • Cross-platform price comparison — One /v1/price-compare call returns every OTA’s price for a property — Booking.com, Airbnb, Vrbo, Google — with computed min / median, so your app shows the cheapest rate without four integrations.

Code examples by language

Six languages, each in its own folder under examples/. Every snippet is one screen, uses the language's standard library or a single zero-friction dependency, and resolves to the same unified envelope.

Recipes

Ready-made automations built on Booking.com data — importable n8n workflows and portable AI-agent skills. See recipes/ and the full travel-workflows repo, or browse them rendered at https://scoutingapi.com/workflows.

Pricing & credits

Every call bills against a credit balance. Failed, empty and blocked calls are never billed, and scout_test_ sandbox calls are always free. The exact, current per-endpoint costs live on the pricing page and in the machine-readable openapi.json — this repo stays number-free so it never drifts.

FAQ

Is this the Booking.com hotel API, or an appointment-booking API?

This is the Booking.com (the OTA) hotel-data API — live hotel and short-term-rental search, availability, and pricing from Booking.com. It is not a generic appointment- or reservation-"booking" API (like a calendar or scheduling tool). If you searched "booking api" looking for Booking.com data, you’re in the right place.

Does Booking.com have a public or free API?

Booking.com offers Connectivity and Partner APIs, but they are gated to approved partners (property owners, channel managers, affiliates) and not a self-serve developer API. ScoutingAPI is the self-serve alternative: 100 free credits, no credit card, and a key in your dashboard immediately — no partner application required.

How do I get Booking.com data without becoming a partner?

Sign up for ScoutingAPI, get a Bearer key, and call GET /v1/search with platforms=booking. You get normalized Booking.com hotel data — search, availability, price, ratings, amenities — without the Connectivity/Partner approval queue, and in the same schema as Airbnb, Vrbo, and Google.

Is the Booking.com data live?

Yes. Data is fetched live and cached briefly for speed (search ~30 min, availability ~6 h, price ~1 h). Each response tells you whether it was cached, and you pass real check-in/check-out dates to get live availability and price — not a static dump.

Related repositories

Part of the ScoutingAPI open resource set — one unified accommodation-data API across Airbnb, Booking.com, Vrbo and Google Hotels, with a REST API, a native MCP server, and importable workflows.

Get your free key — no card → https://scoutingapi.com/signup · Docs · Pricing · Status

Built with ScoutingAPI — trusted, ToS-clean, real-time accommodation data across Airbnb, Booking.com, Vrbo and Google Hotels, normalized to one schema. REST + a native MCP server.

ScoutingAPI is an independent service and is not affiliated with or endorsed by Booking.com. Platform names are trademarks of their respective owners.