Sign in Get API key
HolidayCheck API

HolidayCheck API for Hotel Search, Ratings, Recommendation Rates, and Reviews

Scrappa's HolidayCheck API returns structured JSON from HolidayCheck, the German hotel review portal. Find destinations and hotels by name, list the hotels of a destination ranked by guest rating, open any hotel for its rating, recommendation rate and category ratings, and page through public guest reviews. Reviews expose only the first name and age group of the author. Scrappa is an independent service and is not affiliated with or endorsed by HolidayCheck.

500 free credits
No card needed
From $0.20 / 1k
Pay as you go
Structured JSON
Ready for apps
API key access
Test in minutes
Start for free View documentation
Browse endpoints Try first endpoint
4
Endpoints
1-6
Rating scale
$0.20
Per 1k requests

Try it now

Make one request. Inspect structured JSON.

Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.

Get free API key Try in Playground Open docs
Request preview
Request 
curl -X GET "https://scrappa.co/api/holidaycheck/hotel?hotel_id=90a9d6db-5941-446f-91ba-9a4a2893ab95" \
  -H "Accept: application/json" \
  -H "X-API-KEY: YOUR_API_KEY"
JSON response 
{
  "success": true,
  "data": {
    "hotel": {
      "id": "90a9d6db-5941-446f-91ba-9a4a2893ab95",
      "name": "Alua Calas de Mallorca Resort",
      "url": "https://www.holidaycheck.de/hi/x/90a9d6db-5941-446f-91ba-9a4a2893ab95",
      "stars": 4.0,
      "location": {
        "latitude": 39.46516,
        "longitude": 3.28165
      },
      "parents": ["Cales de Mallorca / Calas de Mallorca", "Mallorca", "Spanien", "Europa"],
      "rating": 4.65,
      "recommendation_rate": 0.765,
      "review_count": 110,
      "rating_per_category": {
        "HOTEL": {"rating": 4.65, "review_count": 110},
        "FOOD": {"rating": 4.86, "review_count": 83}
      }
    }
  },
  "meta": {
    "endpoint_family": "hotel",
    "billable": true
  }
}

What you can build

Structured data for real applications. Here are some ideas.

Hotel Reputation Monitoring

Track the overall rating, recommendation rate and review count of any hotel over time.

Destination Benchmarking

List the hotels of a region ranked by guest rating and compare stars, ratings and review volume.

Review Analysis

Collect guest reviews with category ratings, travel party, travel reason and hotel replies for sentiment research.

Travel Apps

Add hotel ratings and the recommendation rate to a trip planner with the destination autocomplete.

Hospitality Research

Compare food, room, service, location and sport ratings across hotels of one destination.

HolidayCheck scraper API

HolidayCheck API for hotel ratings, recommendation rates, and guest reviews

The HolidayCheck API is built for travel research and hotel benchmarking. Each hotel includes the name, stars, coordinates, rating on the 1 to 6 HolidayCheck scale, the recommendation rate as a share between 0 and 1 and the review count. Detail responses add the rating per category. Reviews include the ratings per category, travel dates in ISO 8601 and the hotel reply.

Find destination and hotel ids by name with the autocomplete endpoint.

List the hotels of a destination ranked by guest rating with limit and offset paging.

Read the recommendation rate and the ratings for hotel, room, food, service, location and sport.

Page through guest reviews with category texts, ratings and travel details.

Reviewer identity is limited to the first name and age group.

Choose the right HolidayCheck API endpoint

Use Autocomplete to find ids

Search a destination or hotel name to get the destination and hotel ids for the other endpoints.

Open HolidayCheck Autocomplete API docs

Use Hotels for destination rankings

List the best rated hotels of a destination with rating, recommendation rate and review count.

Open HolidayCheck Hotels API docs

Use Hotel Detail and Reviews for depth

Open a hotel for its category ratings, then page through its guest reviews.

Open HolidayCheck Reviews API docs

Available endpoints

Everything you need in one API.

Related resources

Booking.com API overview

Compare HolidayCheck ratings with Booking.com hotel data.

Tripadvisor API overview

Add Tripadvisor hotel reviews next to HolidayCheck guest reviews.

Google Hotels API overview

Combine HolidayCheck ratings with Google Hotels prices and availability.

Scrappa vs ScrapingBee / ScraperAPI

See how Scrappa compares to the official API.

HolidayCheck hotel data as JSON
Scrappa:
ScrapingBee / ScraperAPI: Build your own parser
Recommendation rate and category ratings
Scrappa:
ScrapingBee / ScraperAPI: Parse it yourself
Price per 1k requests
Scrappa: From $0.20
ScrapingBee / ScraperAPI: Varies by credits per request
Unified API key
Scrappa: Yes (80+ APIs)
ScrapingBee / ScraperAPI: Scraping only
Free tier
Scrappa: 500 credits/month
ScrapingBee / ScraperAPI: Trial credits

Key features

Destination and hotel search by name with HolidayCheck ids
Hotels of a destination ranked by guest rating with limit and offset paging
Rating on the 1 to 6 scale, recommendation rate and rating per category
Guest reviews with ratings, texts, travel details and hotel replies
Reviewer identity limited to first name and age group

Frequently asked questions

No. Scrappa is an independent service and is not affiliated with or endorsed by HolidayCheck. The HolidayCheck API returns structured JSON from public hotel pages.

Every Scrappa account includes 500 free credits each month. After that, each successful request costs one credit. Failed requests are never billed.

HolidayCheck rates from 1 to 6. The recommendation rate is a share between 0 and 1, so 0.765 means 76.5 percent of guests recommend the hotel.

No. An unknown hotel id answers a non-billable 404 with error code NOT_FOUND. An unknown destination id returns an empty hotel list.

Start using the HolidayCheck API

Sign up and get 500 free credits. No credit card required.

Create Free Account View Documentation