PHPackages                             mvdnbrk/kiyoh-php-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. mvdnbrk/kiyoh-php-api

ActiveLibrary[API Development](/categories/api)

mvdnbrk/kiyoh-php-api
=====================

KiyOh API client for PHP

v2.7.1(4y ago)64.3k—0%4MITPHPPHP ^7.3 || ^8.0

Since Feb 8Pushed 4y ago1 watchersCompare

[ Source](https://github.com/mvdnbrk/kiyoh-php-api)[ Packagist](https://packagist.org/packages/mvdnbrk/kiyoh-php-api)[ Docs](https://github.com/mvdnbrk/kiyoh-php-api)[ GitHub Sponsors](https://github.com/mvdnbrk)[ RSS](/packages/mvdnbrk-kiyoh-php-api/feed)WikiDiscussions 2.0 Synced today

READMEChangelog (10)Dependencies (8)Versions (28)Used By (0)

kiyoh-php-api
=============

[](#kiyoh-php-api)

[![Latest Version on Packagist](https://camo.githubusercontent.com/5e27bd695f4568686597353524466e57c1bc773b00d4c4cf5def87ae873af596/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d76646e62726b2f6b69796f682d7068702d6170692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/mvdnbrk/kiyoh-php-api)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Tests](https://camo.githubusercontent.com/b20e79553e36d5697731d3e1decbf259d007b69c8a606675e239bea4e75f3185/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f6d76646e62726b2f6b69796f682d7068702d6170692f74657374732f322e303f6c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/mvdnbrk/kiyoh-php-api/actions?query=workflow%3Atests)[![StyleCI](https://camo.githubusercontent.com/6877b2e186ffda8be4e5be35bda00622eb26eb783344c8fadefa730f57cd8a9d/68747470733a2f2f7374796c6563692e696f2f7265706f732f3136383836363333372f736869656c643f6272616e63683d322e30)](https://styleci.io/repos/168866337)[![Total Downloads](https://camo.githubusercontent.com/4d214dbbe890978a2edf8fc48f3a6e872836af7dbc0e1ca78d7911f19827f5cb/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d76646e62726b2f6b69796f682d7068702d6170692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/mvdnbrk/kiyoh-php-api)

Simple PHP API to fetch your KiyOh reviews from the JSON feed.

**For the previous version of the KiyOh feed please use the [1.0 branch](https://github.com/mvdnbrk/kiyoh-php-api/tree/1.0).**

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require mvdnbrk/kiyoh-php-api
```

Getting started
---------------

[](#getting-started)

Initialize the KiyOh client and set your API key and company ID:

```
$client = new \Mvdnbrk\Kiyoh\Client();

$client->setApiKey('your-secret-hash');
```

### Retrieve the KiyOh feed

[](#retrieve-the-kiyoh-feed)

```
$feed = $client->feed->get();
```

By default this will retrieve the 10 most recent reviews. You may change the number of reviews to retrieve by using the `limit()` method:

```
$feed = $kiyoh->feed->limit(25)->get();
```

The migrated reviews from the previous KiyOh platform are not included by default. If you would like to retrieve the migrated reviews as well you may call the `withMigrated()` method:

```
$feed = $kiyoh->feed->withMigrated()->get();
```

### Reviews

[](#reviews)

```
$feed->reviews->each(function ($review) {
    $review->rating;
    $review->recommendation;
    $review->hasHeadline();
    $review->headline;
    $review->hasText();
    $review->text;
    $review->createdAt;
    $review->updatedAt;

    $review->author->hasName();
    $review->author->name;
    $review->author->hasLocality();
    $review->author->locality;
});
```

### Company properties and statistics

[](#company-properties-and-statistics)

```
$feed->company->id;
$feed->company->name;
$feed->company->reviewCount;
$feed->company->averageRating;
$feed->company->recommendationPercentage;
```

Usage with Laravel
------------------

[](#usage-with-laravel)

Update your `.env` file by adding your KiyOh sercret hash:

```
KIYOH_SECRET=YOUR-SECRET-HASH

```

To create a `kiyoh_reviews` table in your database run the `migrate` command:

```
php artisan migrate
```

To import your reviews in the database run the `kiyoh:import` command:

```
php artisan kiyoh:import
```

The table name can be changed in the `kiyoh.php` config file. To publish the config file run:

```
php artisan vendor:publish --tag=kiyoh-config
```

To publish the migration file run:

```
php artisan vendor:publish --tag=kiyoh-migrations
```

If you are not going to use the default migrations, you should call the `Kiyoh::ignoreMigrations()` method in the register method of your `AppServiceProvider`.

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Mark van den Broek](https://github.com/mvdnbrk)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity27

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity76

Established project with proven stability

 Bus Factor1

Top contributor holds 99.7% 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

Every ~31 days

Recently: every ~39 days

Total

28

Last Release

1808d ago

Major Versions

v1.2.3 → v2.0.02019-06-15

1.0.x-dev → v2.1.02019-06-15

PHP version history (4 changes)v1.0.0PHP ^7.1

v2.4.0PHP ^7.2

v2.5.0PHP ^7.2 || ^8.0

v2.7.0PHP ^7.3 || ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/0e8e321e8c6bc0e5ac8a1db41d1a983ac86888bd61de07afd02ba1cc5c3939c5?d=identicon)[mvdnbrk](/maintainers/mvdnbrk)

---

Top Contributors

[![mvdnbrk](https://avatars.githubusercontent.com/u/802681?v=4)](https://github.com/mvdnbrk "mvdnbrk (303 commits)")[![nikola-n](https://avatars.githubusercontent.com/u/58821667?v=4)](https://github.com/nikola-n "nikola-n (1 commits)")

---

Tags

apikiyohlaravelphpreviewsapilaravelreviewskiyoh

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/mvdnbrk-kiyoh-php-api/health.svg)

```
[![Health](https://phpackages.com/badges/mvdnbrk-kiyoh-php-api/health.svg)](https://phpackages.com/packages/mvdnbrk-kiyoh-php-api)
```

###  Alternatives

[openai-php/laravel

OpenAI PHP for Laravel is a supercharged PHP API client that allows you to interact with the Open AI API

3.7k7.6M74](/packages/openai-php-laravel)[nickurt/laravel-postcodeapi

Universal PostcodeApi for Laravel 11.x/12.x/13.x

97221.2k](/packages/nickurt-laravel-postcodeapi)[smodav/mpesa

M-Pesa API implementation

16363.7k1](/packages/smodav-mpesa)[mozex/anthropic-laravel

Anthropic PHP for Laravel is a supercharged PHP API client that allows you to interact with the Anthropic API

71226.4k1](/packages/mozex-anthropic-laravel)[scriptdevelop/whatsapp-manager

Paquete para manejo de WhatsApp Business API en Laravel

762.6k](/packages/scriptdevelop-whatsapp-manager)[ardakilic/mutlucell

Mutlucell SMS API wrapper for sending sms text messages for Laravel

457.3k](/packages/ardakilic-mutlucell)

PHPackages © 2026

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