HotelMonitor Destination API
The Destination API from HotelMonitor — 1 operation(s) for destination.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/hotelmonitor-co-uk:hotelmonitor-co-uk-destination-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: HotelMonitor agent Destination API
version: 1.2.0
description: 'Read-only answers about hotel prices, for AI assistants. Prices are tax-inclusive nightly figures from HotelMonitor''s own price scans (the Agoda share is an estimate of tax). They are past observations, not live quotes. Results include page_url, HotelMonitor''s price-history page, and where available book_url, a booking-site link with the dates filled in, so the person can confirm the current price. Booking links are affiliate links; HotelMonitor may earn a commission at no extra cost to the person. Rate limits per client (IP address, IPv6 by /64, plus user agent), shared with the MCP server: 60 requests a minute and 2,000 a day; over either you get 429 with Retry-After. X-RateLimit-* headers describe the per-minute window and RateLimit-Policy states both. The same tools are available over MCP at https://hotelmonitor.co.uk/mcp.'
contact:
name: HotelMonitor
url: https://hotelmonitor.co.uk/developers#mcp
servers:
- url: https://hotelmonitor.co.uk/api/agent/v1
tags:
- name: Destination
paths:
/destination/{slug}:
get:
operationId: getDestinationPrices
summary: Typical nightly price by month for a destination, and its cheapest months
description: Months with too few scans are left out. The figures are the same as the destination month pages. Includes page_url; each month has checkin, checkout and book_url (a booking-site search for the destination, two adults, 7 nights from the 15th, or from today once the 15th has passed; omitted when no date is left in the month), and the top-level book_url is the cheapest month's.
parameters:
- name: slug
in: path
required: true
schema:
type: string
- $ref: '#/components/parameters/via'
responses:
'200':
description: Months ahead with typical and lowest-seen nightly prices and dated book_url links.
content:
application/json:
schema:
type: object
properties:
destination:
type: string
slug:
type: string
months:
type: array
items:
type: object
properties:
month:
type: string
label:
type: string
typical_nightly_gbp:
type: number
lowest_seen_nightly_gbp:
type:
- number
- 'null'
scans:
type: integer
checkin:
type: string
format: date
checkout:
type: string
format: date
book_url:
type: string
required:
- month
- label
- typical_nightly_gbp
- lowest_seen_nightly_gbp
- scans
cheapest_months:
type: array
page_url:
type: string
book_url:
type: string
book_url_month:
type: string
watch_url:
type: string
notes:
type: array
items:
type: string
data_as_of:
type: string
required:
- destination
- slug
- months
- cheapest_months
- page_url
- watch_url
- notes
- data_as_of
'404':
description: Unknown destination.
content:
application/json:
schema:
$ref: '#/components/schemas/UnknownDestination'
'429':
description: Rate limited.
tags:
- Destination
components:
parameters:
via:
name: via
in: query
required: false
schema:
type: string
maxLength: 32
description: Optional short name of your app or assistant (lower-case letters, digits, - or _), used in booking links so we can see where visits come from. Anything else is ignored and agent_api is used.
schemas:
UnknownDestination:
type: object
properties:
error:
type: string
const: unknown_destination
requested:
type: string
suggestions:
type: array
items:
type: string
description: Up to 5 valid slugs close to the one asked for.
valid_destinations:
type: array
items:
type: string
hint:
type: string
required:
- error
- suggestions
- valid_destinations
- hint