PHPackages                             lasselehtinen/issuu - 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. lasselehtinen/issuu

ActiveLibrary[API Development](/categories/api)

lasselehtinen/issuu
===================

Issuu API client for PHP

v4.0(11mo ago)75.4k↓56.2%6[1 PRs](https://github.com/lasselehtinen/issuu/pulls)MITPHPPHP ^8.2|^8.3CI failing

Since Nov 19Pushed 11mo ago3 watchersCompare

[ Source](https://github.com/lasselehtinen/issuu)[ Packagist](https://packagist.org/packages/lasselehtinen/issuu)[ RSS](/packages/lasselehtinen-issuu/feed)WikiDiscussions master Synced today

READMEChangelog (7)Dependencies (7)Versions (9)Used By (0)

[![Latest Version](https://camo.githubusercontent.com/b3cfb9ce37d2876f04becf120f2301d8913c30306128d66e7fddc3305493df57/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6c617373656c656874696e656e2f69737375752e737667)](https://github.com/lasselehtinen/issuu/releases)[![Latest build](https://github.com/lasselehtinen/issuu/actions/workflows/run-tests.yml/badge.svg)](https://github.com/lasselehtinen/issuu/actions/workflows/run-tests.yml/badge.svg)

Issuu - API client for PHP
==========================

[](#issuu---api-client-for-php)

Notes
-----

[](#notes)

The version 3.0 is for the Issuu API v2. Old API was deprecated on May 1st, 2024.

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

[](#installation)

You can install this package via composer using this command:

```
composer require lasselehtinen/issuu
```

Supported functionality
-----------------------

[](#supported-functionality)

Drafts
======

[](#drafts)

EndpointSupportedList draftsYesCreate a new DraftYesDelete a Draft by slugYesUpdate a Draft by slugYesUpload a document for a Draft by slugYesPublish a Draft by slugYesPublications
============

[](#publications)

EndpointSupportedList PublicationsYesGet Publication by slugYesDelete Publication by slugYesGet Publication assets by slugNoGet Publication Fullscreen share by slugNoGet Publication Reader Share URL by slugNoGet Publication QRCode share by slugNoGet Publication Embed code by slugNoStacks
======

[](#stacks)

EndpointSupportedList StacksYesCreate a new StackYesGet Stack data by IDYesDelete a Stack by IDYesUpdate Stack data by IDNoGet Stack Items slugYesAdd Stack Item by slug to stackYesDelete Stack Item by slug from stackNoStats
=====

[](#stats)

EndpointSupportedGet StatsNoUser
====

[](#user)

EndpointSupportedGet User ProfileNoGet User FeaturesNoUsage
-----

[](#usage)

### Creating a client

[](#creating-a-client)

First create a new instance with your API key and secret:

```
use lasselehtinen\Issuu\Issuu;

$issuu = new Issuu('apiKey');
$drafts = new Drafts($issuu);

$body = [
    'confirmCopyright' => true,
    'fileUrl' => 'https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf',
    'info' => [
        'file' => 0,
        'access' => 'PUBLIC',
        'title' => 'Example title',
        'description' => 'Description',
        'preview' => false,
        'type' => 'editorial',
        'showDetectedLinks' => false,
        'downloadable' => false,
        'originalPublishDate' => '1970-01-01T00:00:00.000Z',
    ],
];

$createDraft = $drafts->create($body);

// Try few times until the file is converted
for ($i=0; $i < 10; $i++) {
    $draft = $drafts->getDraftBySlug($createDraft->slug);

    if ($draft->fileInfo->conversionStatus === 'DONE') {
        break;
    }

    sleep(2);
}

$publishDraftBySlug = $drafts->publishDraftBySlug($createDraft->slug, ['desiredName' => 'foobar']);
```

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

[](#contributing)

Pull requests are welcome.

### Pull Requests

[](#pull-requests)

- Use **[PSR-2 Coding Standard.](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-2-coding-style-guide.md)**
- **Add tests!** Your patch won't be accepted if it doesn't have tests.
- **Document any change in behaviour.** Make sure the `README.md` and any other relevant documentation are kept up-to-date.
- **Send coherent history.** Make sure each individual commit in your pull request is meaningful. If you had to make multiple intermediate commits while developing, please [squash them](http://www.git-scm.com/book/en/v2/Git-Tools-Rewriting-History#Changing-Multiple-Commit-Messages) before submitting.

Running Tests
-------------

[](#running-tests)

```
$ phpunit
```

Issues
------

[](#issues)

If you have problems or suggestions, please [open a new issue in GitHub](https://github.com/lasselehtinen/issuu/issues).

License
-------

[](#license)

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

###  Health Score

49

—

FairBetter than 94% of packages

Maintenance52

Moderate activity, may be stable

Popularity30

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity83

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 72.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 ~402 days

Recently: every ~439 days

Total

8

Last Release

330d ago

Major Versions

v1.2 → v2.02021-08-17

v2.0 → v3.02024-05-07

v3.0.1 → v4.02025-08-07

PHP version history (4 changes)v1.0PHP ^7.0

v1.2PHP ^7.2

v2.0PHP ^7.2|^8.0

v3.0.1PHP ^8.2|^8.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/6697fc2a4266c4d9a5526043fa45b172881bd09b5d1743751e6ae70f9104ee73?d=identicon)[lasleh](/maintainers/lasleh)

---

Top Contributors

[![lasselehtinen](https://avatars.githubusercontent.com/u/1290186?v=4)](https://github.com/lasselehtinen "lasselehtinen (8 commits)")[![davidwebca](https://avatars.githubusercontent.com/u/412352?v=4)](https://github.com/davidwebca "davidwebca (2 commits)")[![alkaupp](https://avatars.githubusercontent.com/u/15434629?v=4)](https://github.com/alkaupp "alkaupp (1 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/lasselehtinen-issuu/health.svg)

```
[![Health](https://phpackages.com/badges/lasselehtinen-issuu/health.svg)](https://phpackages.com/packages/lasselehtinen-issuu)
```

###  Alternatives

[statamic/cms

The Statamic CMS Core Package

4.8k3.6M984](/packages/statamic-cms)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3741.3M47](/packages/tencentcloud-tencentcloud-sdk-php)[neuron-core/neuron-ai

The PHP Agentic Framework.

2.0k656.1k38](/packages/neuron-core-neuron-ai)[avalara/avataxclient

Client library for Avalara's AvaTax suite of business tax calculation and processing services. Uses the REST v2 API.

528.5M7](/packages/avalara-avataxclient)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

273.0k](/packages/eslazarev-wildberries-sdk)[files.com/files-php-sdk

Files.com PHP SDK

2481.1k](/packages/filescom-files-php-sdk)

PHPackages © 2026

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