PHPackages                             sharestoryz/yourstoryz-php-sdk - 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. sharestoryz/yourstoryz-php-sdk

ActiveLibrary[API Development](/categories/api)

sharestoryz/yourstoryz-php-sdk
==============================

An SDK to easily work with the YourStoryz API

0.0.4(2mo ago)01.3k[1 PRs](https://github.com/sharestoryz/yourstoryz-php-sdk/pulls)1MITPHPPHP ^8.3CI passing

Since Apr 5Pushed 1w agoCompare

[ Source](https://github.com/sharestoryz/yourstoryz-php-sdk)[ Packagist](https://packagist.org/packages/sharestoryz/yourstoryz-php-sdk)[ Docs](https://github.com/sharestoryz/yourstoryz-php-sdk)[ GitHub Sponsors](https://github.com/sharestoryz)[ RSS](/packages/sharestoryz-yourstoryz-php-sdk/feed)WikiDiscussions 0.x Synced 2d ago

READMEChangelog (4)Dependencies (9)Versions (6)Used By (1)

YourStoryz PHP SDK
==================

[](#yourstoryz-php-sdk)

[![Latest Version on Packagist](https://camo.githubusercontent.com/307e746367f3f096985d76e2483eba577e1a61448cd32da70eda38bad2a7e461/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f736861726573746f72797a2f796f757273746f72797a2d7068702d73646b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/sharestoryz/yourstoryz-php-sdk)[![Tests](https://camo.githubusercontent.com/771a805d95c185128a0e3b778ed7fe1b041cdc0fddd5c9fda0e2fbbd0b3f83ae/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f736861726573746f72797a2f796f757273746f72797a2d7068702d73646b2f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/sharestoryz/yourstoryz-php-sdk/actions/workflows/run-tests.yml)[![Total Downloads](https://camo.githubusercontent.com/bb25e832faeee69581edf38c8572f00a3bada6e6c45b543ee32f0f4079caba13/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f736861726573746f72797a2f796f757273746f72797a2d7068702d73646b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/sharestoryz/yourstoryz-php-sdk)

A PHP SDK for the [YourStoryz API](https://dashboard.yourstoryz.com/docs), built on top of [Saloon](https://docs.saloon.dev). Provides a fluent interface to interact with companies, departments, stories, users, and published videos.

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

[](#installation)

You can install the package via composer:

```
composer require sharestoryz/yourstoryz-php-sdk
```

Usage
-----

[](#usage)

### Initialization

[](#initialization)

```
use YourStoryz\PhpSdk\YourStoryz;

$client = new YourStoryz('your-api-token');
```

### Companies

[](#companies)

```
// List all companies
$response = $client->companies()->all();

// Get a single company
$response = $client->companies()->get(id: 1);

// Get company settings
$response = $client->companies()->settings(companyId: 1);

// Get company departments
$response = $client->companies()->departments(companyId: 1);

// Get company stories
$response = $client->companies()->stories(companyId: 1);

// Get company published videos
$response = $client->companies()->publishedVideos(companyId: 1);
```

### Departments

[](#departments)

```
// List all departments
$response = $client->departments()->all();

// Get a single department
$response = $client->departments()->get(id: 1);

// Get department settings
$response = $client->departments()->settings(departmentId: 1);

// Get department stories
$response = $client->departments()->stories(departmentId: 1);

// Get department published videos
$response = $client->departments()->publishedVideos(departmentId: 1);
```

### Stories

[](#stories)

```
// List all stories
$response = $client->stories()->all();

// Get a single story
$response = $client->stories()->get(id: 1);

// Create a story
$response = $client->stories()->create();

// Update a story
$response = $client->stories()->update(id: 1);

// Delete a story
$response = $client->stories()->delete(id: 1);
```

### Users

[](#users)

```
// Get the authenticated user
$response = $client->users()->me();

// Get user stories
$response = $client->users()->stories(userId: 1);

// Get user published videos
$response = $client->users()->publishedVideos(userId: 1);
```

### Published Videos

[](#published-videos)

```
// Get a single published video
$response = $client->publishedVideos()->get(id: 1);
```

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

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

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

[](#contributing)

Please see [CONTRIBUTING](https://github.com/spatie/.github/blob/main/CONTRIBUTING.md) for details.

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

[](#security-vulnerabilities)

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

Credits
-------

[](#credits)

- [Jan Henk Hazelaar](https://github.com/jhhazelaar)
- [All Contributors](../../contributors)

License
-------

[](#license)

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

###  Health Score

43

—

FairBetter than 89% of packages

Maintenance91

Actively maintained with recent releases

Popularity19

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 87.5% 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 ~5 days

Total

5

Last Release

69d ago

PHP version history (2 changes)0.0.1PHP ^8.4

0.0.4PHP ^8.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/9c8436fa940b097bc16a3da74b6d85a4070816e19070a5bdc1a6f733a61f75fc?d=identicon)[concept7](/maintainers/concept7)

![](https://avatars.githubusercontent.com/u/215711?v=4)[Jan Henk Hazelaar](/maintainers/jhhazelaar)[@jhhazelaar](https://github.com/jhhazelaar)

---

Top Contributors

[![jhhazelaar](https://avatars.githubusercontent.com/u/215711?v=4)](https://github.com/jhhazelaar "jhhazelaar (28 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (3 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (1 commits)")

---

Tags

ShareStoryzyourstoryz-php-sdk

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/sharestoryz-yourstoryz-php-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/sharestoryz-yourstoryz-php-sdk/health.svg)](https://phpackages.com/packages/sharestoryz-yourstoryz-php-sdk)
```

###  Alternatives

[craftcms/cms

Craft CMS

3.6k3.6M3.1k](/packages/craftcms-cms)[saloonphp/laravel-plugin

The official Laravel plugin for Saloon

807.1M201](/packages/saloonphp-laravel-plugin)[whatsdiff/whatsdiff

See what's changed in your project's dependencies

771.2k](/packages/whatsdiff-whatsdiff)[myoutdeskllc/salesforce-php

salesforce library for php8+

1579.5k](/packages/myoutdeskllc-salesforce-php)[icawebdesign/hibp-php

PHP library for accessing the Have I Been Pwned API.

2549.8k2](/packages/icawebdesign-hibp-php)[codebar-ag/laravel-docuware

DocuWare integration with Laravel

1123.7k](/packages/codebar-ag-laravel-docuware)

PHPackages © 2026

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