PHPackages                             ors/holidaycheck-api - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. ors/holidaycheck-api

ActiveLibrary[API Development](/categories/api)

ors/holidaycheck-api
====================

PHP parser for HolidayCheck XML api

v1.0.0(9y ago)3281MITPHPPHP &gt;=5.4.0

Since Dec 19Pushed 9y agoCompare

[ Source](https://github.com/flajsg/holidaycheck-api)[ Packagist](https://packagist.org/packages/ors/holidaycheck-api)[ RSS](/packages/ors-holidaycheck-api/feed)WikiDiscussions master Synced 4w ago

READMEChangelog (1)Dependencies (1)Versions (2)Used By (1)

holidaycheck-api
================

[](#holidaycheck-api)

This is a simple PHP parser for HolidayCheck XML api, that already has a predefined model clases.

[www.HolidayCheck.com](http://www.HolidayCheck.com) is a free travel information website. Community members and other users write and share hotel reviews and upload travel pictures and videos. This information helps other people plan and organize their holidays.

In order to use this API, you will need Partner Token from HolidayCheck, which will be provided to you once you have signed a contract with HC.

Dependencies
------------

[](#dependencies)

This parser uses `curl` to send API requests and `openlss/lib-array2xml` for converting XML to array.

**Important:** Ratings are in range from 0.0 to 6.0.

Basic Usage
-----------

[](#basic-usage)

First create an instance:

```
$hc = new \HC\HolidayCheck($partner_token);

```

Get detailed information about a hotel (using holiday check unique hotel id):

```
	$hotel = $hc->hotel(49415);

	// output:
	Array
  	(
	    [id] => 49415
	    [uuid] => 4e19fc5c-2279-36f0-b4ff-69fd37b3e7df
	    [name] => Hotel Veniqui
	    [recommendation] => 100.0
	    [averageRating] => 4.5
	    [countReviews] => 11
	    [geoLocation] => Array
	      (
	        [latitude] => 41.77302721395887
	        [longitude] => 9.392623901367188
	      )

	    [hcRateUrl] => https://secure.holidaycheck.com/wcf/hotelreview/rate/4e19fc5c-2279-36f0-b4ff-69fd37b3e7df
	    [hcReviewsUrl] => http://www.holidaycheck.com/hr/4e19fc5c-2279-36f0-b4ff-69fd37b3e7df
    	[hcUrl] => http://www.holidaycheck.com/hi/4e19fc5c-2279-36f0-b4ff-69fd37b3e7df
	)
```

A list of hotels

```
$hotels = $hc->hotels(array(), '', 10);

```

A list of hotel ratings:

```
$ratings = $hc->hotelRatings(16);

Array
(
    [averageRating] => Array
        (
            [couple] => 4.95
            [family] => 5.0
            [friends] => 5.5
            [overall] => 4.7
            [single] => 2.0
        )

    [foodRating] => Array
        (
            [couple] => 5.0
            [family] => 5.5
            [friends] => 5.8
            [overall] => 5.3
            [single] => 0.0
        )

    [hotelRating] => Array
        (
            [couple] => 5.26667
            [family] => 5.15
            [friends] => 5.8
            [overall] => 4.84286
            [single] => 2.0
        )

    [locationRating] => Array
        (
            [couple] => 4.4
            [family] => 4.3
            [friends] => 4.8
            [overall] => 4.51429
            [single] => 5.0
        )

    [recommendation] => Array
        (
            [couple] => 100.0
            [family] => 100.0
            [friends] => 100.0
            [overall] => 88.888885
            [single] => 0.0
        )

    [roomRating] => Array
        (
            [couple] => 4.66667
            [family] => 4.75
            [friends] => 5.3
            [overall] => 4.68571
            [single] => 4.0
        )

    [serviceRating] => Array
        (
            [couple] => 5.5
            [family] => 5.55
            [friends] => 5.7
            [overall] => 5.32857
            [single] => 4.0
        )

    [sportRating] => Array
        (
            [couple] => 4.16667
            [family] => 4.75
            [friends] => 5.8
            [overall] => 4.63333
            [single] => 0.0
        )

)
```

A list of hotel reviews:

```
$ratings = $hc->hotelReviews(16, array(), false, 'entryDate', 10);

```

A single review (using holiday check unique hotel review id):

```
	$review = $hc->hotelReview(2159596);

  	// output
  	Array
	(
	    [age] => 31-35
	    [firstName] => Tobias
	    [hcSourceUrl] => https://www.holidaycheck.de/hrd/1aa4c4ad-f9ea-3367-a163-8a3a6884d450/57b4a3e9-0384-3150-b1ef-4ec5dba12312
	    [hcUrl] => http://www.holidaycheck.com/hr/1aa4c4ad-f9ea-3367-a163-8a3a6884d450/-/review/57b4a3e9-0384-3150-b1ef-4ec5dba12312
	    [hotelId] => 70434
	    [hotelName] => Dana Beach Resort
	    [id] => 2159596
	    [language] => en
	    [originalLanguage] => de
	    [ratingFood] => 5.3
	    [ratingHotel] => 5.7
	    [ratingLocation] => 5.3
	    [ratingRoom] => 4.5
	    [ratingService] => 5.3
	    [ratingSport] => 5.0
	    [text] => The six block can not recommend the first floor, since the sounds of the departing Fleugzeuge (3.15
	    [textHotel] =>
	    [title] => Not the quietest Hotel
	    [traveledWith] => single
	    [travelReason] => beach
	    [uuid] => 57b4a3e9-0384-3150-b1ef-4ec5dba12312
	)
```

###  Health Score

27

—

LowBetter than 47% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

3481d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/23451383?v=4)[Gregor Flajs](/maintainers/flajsg)[@flajsg](https://github.com/flajsg)

---

Top Contributors

[![gregorf-ors](https://avatars.githubusercontent.com/u/265362559?v=4)](https://github.com/gregorf-ors "gregorf-ors (4 commits)")

---

Tags

apiholidaycheck

### Embed Badge

![Health badge](/badges/ors-holidaycheck-api/health.svg)

```
[![Health](https://phpackages.com/badges/ors-holidaycheck-api/health.svg)](https://phpackages.com/packages/ors-holidaycheck-api)
```

###  Alternatives

[m165437/laravel-blueprint-docs

API Blueprint Renderer for Laravel

22779.5k](/packages/m165437-laravel-blueprint-docs)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
