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(9mo ago)75.0k↓42.9%6[1 PRs](https://github.com/lasselehtinen/issuu/pulls)MITPHPPHP ^8.2|^8.3CI passing

Since Nov 19Pushed 9mo ago3 watchersCompare

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

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

50

—

FairBetter than 95% of packages

Maintenance58

Moderate activity, may be stable

Popularity29

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

277d 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

[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[convertkit/convertkitapi

Kit PHP SDK for the Kit API

2167.1k1](/packages/convertkit-convertkitapi)[mapado/rest-client-sdk

Rest Client SDK for hydra API

1125.9k2](/packages/mapado-rest-client-sdk)

PHPackages © 2026

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