![HolidayCheck logo](/assets/logos/holidaycheck_logo-593ff58aa5bbf2d3b0468e126b2c80603a851876045a825bcfd1805d137eb339.png) HolidayCheck API
# The HolidayCheck API for hotel research.

Find hotels by name, then read **property details, grouped amenities, guest reviews, and native ratings** as structured JSON. Use one hotel UUID across details and reviews.

REQUESTGET

USE CASEIllustrative response; live published values and available matches vary.

```
curl "https://api.stayapi.com/v1/holidaycheck/hotels/search" \
  -G \
  -H "x-api-key: $STAYAPI_KEY" \
  -d "query=Alexa Hotel" \
  -d "page=1"
```

USE CASEIllustrative response; live published values and available matches vary.

```
curl "https://api.stayapi.com/v1/holidaycheck/hotel/details" \
  -G \
  -H "x-api-key: $STAYAPI_KEY" \
  -d "hotel_id=c6b63919-17b1-317d-a9e7-e69dbe195f2e"
```

USE CASEIllustrative response for a HolidayCheck hotel; live review values vary.

```
curl "https://api.stayapi.com/v1/holidaycheck/hotel/reviews" \
  -G \
  -H "x-api-key: $STAYAPI_KEY" \
  -d "hotel_id=c6b63919-17b1-317d-a9e7-e69dbe195f2e" \
  -d "page=1" \
  -d "sort=recent_desc"
```

USE CASEIllustrative response for a HolidayCheck hotel; live review values vary.

```
curl "https://api.stayapi.com/v1/holidaycheck/hotel/url-to-id" \
  -G \
  -H "x-api-key: $STAYAPI_KEY" \
  -d "url=https://www.holidaycheck.de/hi/alexa-hotel/c6b63919-17b1-317d-a9e7-e69dbe195f2e"
```

RESPONSE200 OK
2.41s

```
{
  "query": "Alexa Hotel",
  "hotels": [
    {
      "hotel_id": "c6b63919-17b1-317d-a9e7-e69dbe195f2e",
      "hotel_name": "Alexa Hotel",
      "location": "Göhren auf Rügen",
      "destination_id": null,
      "destination_name": null,
      "url": "https://www.holidaycheck.de/hi/c6b63919-17b1-317d-a9e7-e69dbe195f2e"
    }
  ],
  "page": 1,
  "per_page": 10,
  "available_count": 1,
  "has_more": false,
  "retrieved_at": "2026-09-28T10:00:00Z"
}
```

```
{
  "hotel_id": "c6b63919-17b1-317d-a9e7-e69dbe195f2e",
  "hotel_name": "Alexa Hotel",
  "url": "https://www.holidaycheck.de/hi/alexa-hotel/c6b63919-17b1-317d-a9e7-e69dbe195f2e",
  "star_rating": 3.5,
  "star_rating_source": "HSU",
  "address": "Poststraße 10\r\n18586\r\nOstseebad Göhren\r\nDeutschland",
  "location": {
    "city": "Göhren auf Rügen",
    "region": "Mecklenburg-Vorpommern",
    "country": "Deutschland",
    "continent": "Europa",
    "latitude": 54.34173,
    "longitude": 13.73761
  },
  "contact": {
    "phone": "+49 3830 86663100",
    "email": "info@alexahotel.de"
  },
  "description_sections": [
    {
      "source": "OWNER",
      "key": "LOCATION",
      "text": "zentral, am Ortseingang, ca. 650 Meter vom Strand"
    }
  ],
  "amenity_groups": [
    {
      "category_key": "CATEGORY_FACILITIES",
      "category_name": "Ausstattung",
      "subcategory_name": "Wellness",
      "group_id": "c9271100-7ad1-39bd-a77f-ac0987d97812",
      "name": "Sauna",
      "items": [
        {
          "id": "4c56b06a-caec-35f8-bbf0-22d4fdb6c9f9",
          "name": null
        }
      ]
    }
  ],
  "check_in": "ab 15:00 Uhr",
  "check_out": "bis 11:00 Uhr",
  "summary": {
    "rating": 4.779031254194159,
    "rating_scale": 6,
    "recommendation_percent": 88.30421228502881,
    "total_reviews": 336
  },
  "retrieved_at": "2026-09-28T15:02:56.307137Z"
}
```

```
{
  "hotel_id": "c6b63919-17b1-317d-a9e7-e69dbe195f2e",
  "hotel_name": "Alexa Hotel",
  "url": "https://www.holidaycheck.de/hr/bewertungen-alexa-hotel/c6b63919-17b1-317d-a9e7-e69dbe195f2e",
  "summary": {
    "rating": 5.2,
    "rating_scale": 6,
    "recommendation_percent": 91,
    "total_reviews": 1
  },
  "reviews": [
    {
      "id": "example-review",
      "title": "Angenehmer Aufenthalt",
      "text": "Freundlicher Service.",
      "text_sections": [
        {
          "key": "SERVICE_OPINION",
          "label": "Service",
          "text": "Freundlicher Service."
        }
      ],
      "rating": 5,
      "rating_scale": 6,
      "review_date": "2026-08-20T10:00:00Z",
      "stay_date": "2026-08",
      "original_language": "de",
      "language": "de",
      "reviewer_name": "Gast",
      "traveler_type": null,
      "recommended": true,
      "verified_stay": null
    }
  ],
  "page": 1,
  "per_page": 10,
  "total_count": 1,
  "has_more": false,
  "retrieved_at": "2026-09-28T10:00:00Z"
}
```

```
{
  "hotel_id": "c6b63919-17b1-317d-a9e7-e69dbe195f2e",
  "url": "https://www.holidaycheck.de/hi/alexa-hotel/c6b63919-17b1-317d-a9e7-e69dbe195f2e"
}
```

[Start free with 50 requests](/users/sign_up)[Read the docs](/docs)

**99.9%** uptimeLive, not cached

Trusted by hospitality teams at

 ![EHL](/assets/logos/ehl-51e6ac832bd7a1b8c1f3c17ea48e7f7464f2aaead02a54b7cab2f2ee05b06c86.png) ![Skyscanner](/assets/logos/skyscanner-47f9fed400d4f828b0499892968e393aa1435240b8a573988d36fceb7f0433ae.png) ![Mews](/assets/logos/mews-e52288ca26c3e8d5e3878b522b92b521916a7df9c07556910102ad7bebbd216b.svg) ![CBRE](/assets/logos/cbre-f38211cf61a47f45d021ab25957f592fb2043bcff716539e3f2f54fd7fde91be.png) ![Ripe](/assets/logos/ripe-9fec989e25c3a18f2fec0357610bc743f12bf0e96cfa4824f457c4aa2c95db60.svg)

Overview
## What the HolidayCheck API gives you.

Search by hotel name to find matching properties and their UUIDs. Read descriptions, amenities, location, contact information, and published check-in/out wording with hotel details.

Read guest feedback while preserving the native six-point rating scale. Review responses include text sections, entry timestamps, stay months, and published reviewer metadata. A supported hotel URL can also supply the UUID through URL to Hotel ID.

01

#### Native ratings.

Keep six-point ratings separate from the recommendation percentage.

02

#### Direct UUID access.

Use the UUID from name search or a supported URL directly for details and reviews.

03

#### One API key.

Authenticate with X-API-Key. Each successful request costs one credit.

[View pricing](#pricing)[View the docs](/docs)

Endpoints
## Every HolidayCheck endpoint, one base URL.

Each returns normalized JSON in the same shape. Click any endpoint for parameters, an example response, and a live playground.

[GET Hotel Name Search /v1/holidaycheck/hotels/search Find hotel-name matches and use their UUIDs for details and reviews.](/docs/endpoints/holidaycheck/hotels-search)[GET Hotel Details /v1/holidaycheck/hotel/details Read hotel information, descriptions, grouped amenities, and rating summaries by UUID.](/docs/endpoints/holidaycheck/hotel-details)[GET URL to Hotel ID /v1/holidaycheck/hotel/url-to-id Extract a lowercase hotel UUID from a supported hotel or review-listing URL. Does not verify existence.](/docs/endpoints/holidaycheck/url-to-id)[GET Hotel reviews /v1/holidaycheck/hotel/reviews Read paginated guest reviews, structured text, native ratings, and recommendation percentages.](/docs/endpoints/holidaycheck/hotel-reviews)

[Browse the full HolidayCheck docs](/docs)

Use cases
## What teams build on the HolidayCheck API.

The same endpoints, pointed at different jobs. These are the ones we see most.

01

#### Hotel discovery.

Match a hotel name, then use its UUID to read descriptions, location, contact information, and amenities.

02

#### Review monitoring.

Request newest-first reviews and track published entry timestamps.

03

#### Topic analysis.

Analyze main text or individual labeled review sections.

04

#### Reputation reporting.

Compare hotel feedback across sources while retaining HolidayCheck’s native six-point scale.

05

#### Agent research.

Let an MCP client find a hotel by name, inspect property details, and read its guest feedback using your StayAPI key.

Also over MCP
## HolidayCheck data, inside your AI agent.

The same endpoints are exposed as MCP tools. Connect Claude, Cursor, or Claude Code, ask in plain English, and the agent calls the tool and answers from live HolidayCheck data.

[See the MCP setup](/mcp)[Read the MCP docs](/docs/mcp)

Pricing
## 50 free requests on signup. Pick a plan when you need more.

Flat monthly plans, every endpoint included on every plan. **1 request = 1 credit.** No per-endpoint multipliers, no surprise overages.

MonthlyQuarterly

01Free

$0to start

50 credits on signup

- **50** free requests
- Every endpoint included
- No credit card required
- Same schema as paid

[Start free](/users/sign_up)

02Basic

$49 per month 

1,500 requests / mo

- **1,500** requests / month
- Every endpoint included
- Per-endpoint usage dashboard
- Email support

[Start Basic](/users/sign_up)

Most popular
03Startup

$149 per month 

10,000 / mo25,000 / mo

- **10,000** requests / month
- Every endpoint included
- Per-endpoint usage dashboard
- Email support

[Start building](/users/sign_up)

50% off
04Scale

~~$900~~ $450 per month 

100,000 requests / mo

- **100,000** requests / month
- Every endpoint included
- Per-endpoint usage dashboard
- Priority email support

[Start scaling](/users/sign_up)

05Custom

Let's talk

100K+ requests / mo

- **100K+** requests / month
- Volume rate on the call
- Per-endpoint usage dashboard
- Priority email + Slack support

[Book a scoping call](/book-demo)

Every plan ships every endpoint. Same uptime, same schema, same response time.

Questions
## What people ask about the HolidayCheck API.

Don't see your question? Email us at [info@stayapi.com](mailto:info@stayapi.com).

#Can I search by hotel name?

Yes. Send `query` with 1–200 characters after trimming and optional `page`. Each page contains up to 10 matches. `available_count` and `has_more` describe only the available result set, not an exhaustive global total. Pass each returned `hotel_id` directly to details or reviews. There are no dates, prices, or destination-search controls.

#What hotel details are included?

Details include the canonical hotel URL, published address, location, contact information, description sections, grouped amenities, and check-in/out wording. Unavailable values are null or empty arrays. Star classification and its source are separate from the six-point guest rating. Prices and photo galleries are not included.

#How do I get HolidayCheck hotel reviews?

Call `/v1/holidaycheck/hotel/reviews` with a hotel UUID in `hotel_id`. Use `page` and `sort` to browse the results.

#Can I start with a HolidayCheck URL?

Yes. URL to Hotel ID accepts supported hotel and review-listing URLs on holidaycheck.de, .com, .at, and .ch, with optional www. It extracts the UUID without checking existence. Individual /hrd/ reviews and the short /hi/{uuid} links returned by name search are excluded; use the search result hotel\_id directly.

#What rating scale does HolidayCheck use here?

Ratings remain on the native six-point scale. `recommendation_percent` is a separate percentage.

#Can I change the review language or page size?

No. Pages contain up to 10 reviews and text is returned as supplied by HolidayCheck. Sort by `most_relevant` (default) or `recent_desc`.

#What does a HolidayCheck request cost?

Each successful call costs one credit under your StayAPI plan. Sign up for 50 free requests.

## Two ways to start.

Both end with live HolidayCheck data in your stack. The fast path is on the left.

01 · the fast path

### Try it free

50 free requests after sign up. Fastest way to see if the schema fits.

[Start free](/users/sign_up)
- Live API key in 30 seconds
- No credit card required
- Same schema as paid

02 · the scoped path

### Book a scoping call

15 minutes. Volume + endpoint mix. Walk out with a quote.

[Book a demo](/book-demo)
- Quote on the call, not after
- Engineering, not sales
- No deck, no slides